WoodWing Help Center

Enterprise Server 10 minor upgrade

Enterprise Server 10 minor upgrade

A minor upgrade is an upgrade of an existing Enterprise Server 10 installation to a new version of Enterprise Server 10, for instance upgrading Enterprise version 10.0.0 to version 10.0.1, to version 10.1.0, and so on.

This article describes the steps that need to be followed.

Note: Make sure to read the Release Notes that accompany the minor upgrade for any important installation or configuration details.

Step 1. Creating a backup

Create a backup of your system to make sure that no files are lost should anything go wrong.

Step 2. (Optional) Installing the ExifTool

Note: This step is only required when upgrading from Enterprise Server 10.0.x to 10.1 or higher; the ExifTool cannot be used in combination with Enterprise Server 10.0.x and is already installed for Enterprise Server 10.1 or higher.

Enterprise Server requires metadata information to perform specific tasks such as image cropping. This requires that the ExifTool is integrated.

Step 1. Download the ExifTool and install it in a preferred location.

Note: For Mac OS X and Linux, the default installation path is assumed to be: /usr/local/bin.

Step 2. (Optional. Only if you have installed ExifTool in an alternate location.) Note down the path to the installation, it is used for configuring Enterprise Server in a later step.

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.

Step 1. Download the Enterprise Server application from the software release page.

Note: The name of the file is EnterpriseServer_10.x.x_Buildyy.zip, where "x" stands for the Server version number and "y" for the build number. For example: EnterpriseServer_10.0.0_Build100.

Step 2. Unzip the file.

A folder named 'Enterprise' is created containing files such as index.php, index.html, index.htm.

Step 3. Copy the complete Enterprise folder to the server machine’s Web root folder (such as webroot).

Step 4. Configure Enterprise Server by doing one of the following:

  • (Optional, for Enterprise 10.1.x only) When upgrading from Enterprise 10.1 on which the overrule_config.php file is used, copy this file over to the new Server.
  • For all configuration files in the <Enterprise Server path>/config folder (such as config.php, configserver.php, config_solr.php), compare the settings in the files of the new installation with those of the old installation and update the new version where needed.

Caution: You must not just copy your old configuration files over the new ones, as important modifications may have been made which are necessary to run Enterprise 10.

Step 5. (Optional. This step is only required when configuring Enterprise Server 10.1; this option is not used in Enterprise Server 10.0.) Verify the following option of the ExifTool in the configserver.php file:

  • EXIFTOOL_APP_PATH

Step 3. (Optional) Installing Content Station 9 Web and / or Content Station 10

Do one of the following:

  • When Content Station 10 is used, install it in Enterprise Server. When Content Station 10 is already installed you can optionally also copy the following folders from your current Enterprise Server 10 installation:
  • <Enterprise Server folder>/contentstation
  • <Enterprise Server folder>/config/plugins/ContentStation

Note: Make sure that Content Station 10 is configured correctly so that it points to the correct URL of Enterprise Server.

Step 4. Activating licenses

In order to complete the setup process of Enterprise Server, licenses need to be activated first.

Step 5. Initializing Enterprise Server plug-ins

Initializing the Enterprise Server plug-ins is necessary because much of the functionality of Enterprise Server is based on the functionality of Server plug-ins. During the initialization process, the available Server plug-in folders are accessed and the plug-ins that are found are added to the database.

Step 1. (Optional) Copy any customized Server plug-ins from the current Server to the new upgraded Server. Location:

  • For custom plug-ins: <server path>/config/plugins

Step 2. In Enterprise Server, click Server Plug-ins in the Maintenance menu or on the Home page.

The Server Plug-ins page appears and any installed plug-ins will be automatically registered.

Note: Because the plug-ins are registered while the page is opened, the process of opening the page can take a few moments.

Step 3. Make sure that the required plug-ins are enabled. If needed, resolve any conflicts.

Note: Normally, no conflicts should arise and no further action will be required after accessing the page.

Step 6. Testing Enterprise Server

The setup is now ready to be tested.

Step 1. Open a Web browser and enter the URL for the installed Server.

Example: http://localhost/Enterprise/

The log in screen appears.

Step 2. Log in using your admin credentials.

The main screen appears.

Step 1. Access the Health Check page.

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. 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. When Content Station 10 is used, make sure that it is configured correctly so that it points to the correct URL of Enterprise 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).

Document history

  • 13 December 2016: Added step for updating overrule_config.php file.
  • 2 November 2016: Added references to installing and configuring the ExifTool.
Was this article helpful?
0 out of 0 found this helpful / Created: / Updated:
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.