Skip to main content
English (United States) Nederlands

Step 2. Installing Enterprise Server 9

Updated

This is step 2 of performing a minor upgrade of Enterprise Server 9. (See a list of all steps)

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 download page.

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

Step 2. Unzip the file.

This will create a folder named Enterprise 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).

See location details of the Enterprise folder

The location is dependent on the system and HTTP Server used (Apache/IIS), but should normally be in the following location:

  • Mac OS: /Library/Web Server/Documents
  • Windows: c:\inetpub\wwwroot
  • Linux: /var/www/html

Step 4. (Optional, only when Content Station Web or the Multi-Channel Text Editor in Content Station is used ) Add the files for Content Station Web:

Step 4a. Download the Content Station Web file from the software download page.

Note: The name of the file is ContentStationWeb_9.x.x_Buildyy.zip, where "x" stands for the Content Station Web version number and "y" for the build number. For example: ContentStationWeb_9.0.2_Build100.

Step 4b. Unzip the file. The file is unzipped as a folder with the name contentstation.

Step 4c. Copy the contentstation folder to the root folder of Enterprise Server (see location in Step 3).

Step 5. Verify the following options in the configserver.php file:

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

DBTYPE

The type of database used:

  • “mysql” MySQL (default option)
  • “mssql” MSSQL Server
  • “oracle” Oracle

Note: Make sure that the values are in lower case.

DBSERVER

The location of your database server. By default this is the same machine as the application server.

Default value:

  • Mac OS: ‘127.0.0.1’
  • Windows/Linux: ‘localhost’

Notes:

MSQL

Type the machine name, not the IP address.

Oracle

Use the following:

  • (Oracle 12c only) The HOST/SERVICENAME (as defined in the tnsname.ora file)
  • The ORACLE-INSTANCE_NAME (as defined in the tnsname.ora file)
  • The name of a local Oracle instance

MySQL

  • If a port other than the default is used, add the host and port number.

Example: define( 'DBSERVER', '127.0.0.1:3307' );

  • If a socket is used, add the path to the socket (using this option requires Enterprise Server 9.2.1 or higher).

Example: define( 'DBSERVER', '/opt/local/tmp/mysql.sock ');

Step 6. Verify the following options in the config.php file:

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

Tip: A quick way of implementing the necessary changes is to compare the new file with the current file to detect any differences (for instance by using TextWrangler).

BASEDIR

The operating system file path of the Enterprise folder. Make sure that you edit the correct BASEDIR setting of your operating system.

Default value:

  • Mac OS: ‘/Library/Web Server/Documents/Enterprise’
  • Windows: ‘c:/inetpub/wwwroot/Enterprise’
INETROOT

The Web server path of the Enterprise folder.

Default value: ‘/Enterprise’

DBSELECT

The name of your Enterprise database.

Default value: ‘Enterprise’

DBUSER

The database user to be used by the application server. This is the single database user that is used by the application server to access the database. This database user account needs SELECT, INSERT, UPDATE, and DELETE privileges, plus ALTER TABLE privileges for the creation and deletion of custom properties.

The application server itself authorizes all requests for the user logged on via the Enterprise user tables which are completely separate from the database users. Default is ‘root’. For MSSQL Server you could use ‘sa’ as default.

DBPASS

The password for the database user. The default setting is an empty string.

ATTACHMENTDIRECTORY

The path to the FileStore folder (the root folder where Enterprise stores all its files). This can also be a mount point on a different machine.

Default value:

  • Mac OS: ‘/FileStore’
  • Windows: ‘c:\FileStore’

Important: This folder MUST be present in order for Enterprise to work. It is also important to make sure that the Web user has Read and Write access rights to this folder.

WOODWINGSYSTEMDIRECTORY

The folder in which Enterprise stores temporary, export, and production files.

Important: This directory MUST be a child directory of the ATTACHMENTDIRECTORY.

TEMPDIRECTORY

The folder in which Enterprise Server stores temporary system files.

EXPORTDIRECTORY

The folder into which all exported files are downloaded.

Step 7. In the Config_solr.php file, make sure that the ‘SOLR_SERVER_URL’ setting points to your Solr environment.

Next step

Step 3. Activating licenses

Reference Materials

Enterprise Server 9 minor upgrade

Related articles

Comments

0 comments