Upgrading Enterprise Server 8 or 9 to Enterprise Server 10

This article describes the steps to upgrade an existing installation of Enterprise Server 8 or Enterprise Server 9 to Enterprise Server 10.x.

Before you start

Before starting the upgrade, make a plan of what is needed:

Which features of Enterprise Server and its clients do you want to make use of and which additional (third-party) software does this require?

Is a direct upgrade to the latest Enterprise Server possible?

Which features and changes have been implemented since the version that is upgraded from?

What type of access do you want to give each user?

Third-party software

As a starting point, use the Compatibility Matrix to verify if your currently installed operating systems, databases, and other third-party applications require upgrading and what implications this might bring.

Note: It is assumed here that any third-party software is upgraded to a compatible version where needed and is fully working.

Upgrade path

Verify the upgrade path to Enterprise Server 10; it may be required to upgrade Enterprise Server to one or more intermediate versions before being able to upgrade to Enterprise Server 10.

Release Notes

Read through the Release Notes to verify if your setup is affected by any new features or changes that have been introduced since the version that you are upgrading from.

Upgrading InDesign and InCopy

When you are upgrading to a new version of Adobe InDesign or InCopy, keep the following in mind:

All InDesign and InCopy users should use the same Adobe CC version. This is because documents created in a newer version cannot be opened in a previous version.

Convert any InDesign and InCopy templates to the new version of InDesign and InCopy. Do this by opening the file and re-saving it.

Step 1. Creating a backup of Enterprise Server

Create a backup of your system to ensure that no files are lost should anything go wrong during the upgrade process.

Note: The following steps are needed if you want to migrate your existing data storage to the new version. If you have planned to create a brand new data store, these steps can be skipped.

Step 2. Installing the new Enterprise Server

Note: In most production environments, the new Enterprise server is initially installed next to the existing server so that the new setup can be tested before it is made live. For this explanation therefore, the current Enterprise Server will initially be left intact and a new Enterprise Server will be installed separately.

Caution: You must not just copy your old config.php file and configserver.php over the new one, as important modifications have been made which are necessary to run Enterprise.

Tip: (Applies to Enterprise Server 10.1 only) To ease the process of upgrading Enterprise Server installations, manage and configure settings of all configuration files by adding them to a single configuration file.)

Step 2. Open the Solr configuration file on Enterprise Server and make sure that the ‘SOLR_SERVER_URL’ setting points to your Solr environment:

<Enterprise installation directory>/config/config_solr.PHP

Example: define ('SOLR_SERVER_URL', 'http://localhost:8080/solr');

Caution: You must not just copy your old config_solr.php file over the new one, as important modifications have been made which are necessary to run Enterprise.

Note: The remaining settings in this file are needed to fill the Solr environment with Enterprise data and to query these data. This should work out-of-the-box.

Step 3. In Enterprise Server, run the Database Connection test on the Health Check page.

If the database is not up-to-date, you are redirected to the Database - Installation / Upgrade page. Enterprise will automatically detect the current status of the installation and will list the necessary SQL scripts to run.

Step 4. (Optional, only when directed to the Database - Installation / Upgrade page). Review the settings on the page and click Start.

The SQL scripts are executed; Enterprise tables are altered and new tables are created. Because you are upgrading, data will be migrated as well. Each SQL command is echoed to your browser; in case any errors occur, these will be shown in red. After running the scripts, be sure to check for these red errors as they will almost always point out a significant problem, most likely to do with the configuration of either Enterprise or the database.

Step 5. Return to the Health Check page and run the remaining tests. Resolve any conflicts that may arise.

Step 3. Activating the Enterprise license

In order to complete the setup process of Enterprise Server, its license needs to be activated first.

The Search Server page appears. It provides an overview of the installed search servers, including the number of Enterprise objects that are indexed for searching. As you are upgrading, the number of indexed objects will be zero.

Step 3. Run an index on the Solr Search Server by clicking the Start button below the Indexing progress bar. The indexing process starts.

Note:
The indexing can take a while depending of the number of objects to be handled.

Step 4. Optimize the Solr index by clicking the Start button located below the Optimizing bar.

Step 6. Configuring the InDesign Server installations

The available InDesign Server instances need to be verified in Enterprise.

Step 1a. In Enterprise Server, click Advanced in the Maintenance menu or on the Home page. A page with all advanced Maintenance features appears.

Step 1b. Click Health Check. The Health Check page appears.

Step 2. (Optional) In case not all licenses are activated yet, clear the check box for Licenses.

Step 3. (Optional) For those systems or features which are not installed yet (such as LDAP, Drupal, and so on), clear their check boxes.

Step 4. Click Test.

The test(s) are executed and the results are displayed next to each test. They should all display “OK”.

Note: If a test fails, an error is displayed together with instructions for solving it. Follow the instructions and then run the test once more.

Step 8. Upgrading the InDesign and InCopy templates

Upgrade any layout templates or article templates to version CS6, CC 2014 or CC 2015.

Convert any InDesign and InCopy templates that you use to the new version of InDesign and InCopy by opening the file and re-saving it.

Note: Once layouts have been saved to the newer version of InDesign, they cannot be opened in a previous version without converting them to .IDML format. Doing so will remove all links to any placed database files.

Step 9. Taking the new server into production

When upgrading Enterprise Server you very likely installed the new Server next to the existing Server so that it could be tested before it is ready to take into production.

As soon as everything is found to be in order, the new Server will have to be made live at some stage. This can be done in one of the following ways:

Replace the full folder content of the old (current production) Enterprise Server with the full folder content of the new Enterprise Server.

Note: Make sure that the INETROOT option in config.php is updated correctly.

Remove the old (current production) Enterprise Server folder and rename the new Enterprise Server folder so that it matches the name of the old (current production) Enterprise Server folder.

Keep the newly created folder and provide all administrators with the new URL and update the WWSettings.xml files for the client application users with the new path to the Server. Once the new Server is taken into production, you might want to remove the old server installation.

Note: Switching from the “old” environment to the “new “environment should be done when no user is logged in. Furthermore it is preferable that the “old’ environment is cleaned (for example: see if there are any objects which can be removed, and subsequently empty the Trash Can. For more information about cleaning up the system, see Deleting an Issue and Permanently deleting files from Enterprise Server 10).