Installing WorldServer through the installer (on Windows)

Before you begin

  • You need to create and populate the WorldServer database before installing WorldServer. At the moment, the WorldServer installer cannot create new databases during the installation process.
  • If you are installing on an SQL Server database, you must have an SQL Server client installed on the WorldServer machine.
  • If you are installing on an Oracle database, you must set the NLS_LANG environment variable to American_America.UTF8 in the System Properties Environment tab.

Procedure

  1. If you have a previous instance of WorldServer on your machine, uninstall that instance (Control Panel > Add or Remove Programs > SDL WorldServer).
  2. If you are installing from a downloaded distribution kit, extract the kit in a temporary folder.
  3. Use Windows Explorer to navigate to the newly created WorldServer folder and double-click the setup_64.exe file.
  4. On the Welcome screen, click Next, and then click Yes to accept the License Agreement.
  5. On the Setup Configuration Folder Path screen, you can change the folder where you want to store the configuration files by clicking Change. If the folder already exits, the new files will be added within the folder and the installer will not overwrite any existing files. The WS_CONFIG system property is created or updated.
  6. Type your user name and company name, and then click Next.
  7. Choose a location to install the WorldServer program files, and then click Next.
  8. Choose an installation type, and then click Next.
  9. Choose an application server, and then click Next.
  10. Depending on your previous selection, do one of the following:
    • If you chose Tomcat to have Tomcat deployed automatically, specify the port that Tomcat should listen to, and then click Next. By default. the port is 8080. If you have multiple Tomcat installations on a single machine, the port number specified here is the one that Tomcat uses for WorldServer.
    • If you chose Other and you want to perform the Tomcat deployment manually, have WorldServer place the WAR files in the <WS_HOME> folder. The name of the WAR file becomes the name you will use to connect in the browser URL (for example, http://<server-IP>:8080/<war-name>).
  11. Choose a database platform (SQL Server or Oracle) and specify the following:
    For SQL Server:
    1. Provide the name of an existing SQL Server database server and an instance to connect to.
    2. The installation requires that you have already created the physical database and that you have created an SQL Server user with appropriate permissions.
    3. Specify the name of the database server and of the database that you want to use and clear the Create DB option.
    4. Specify the username and password that you want WorldServer to use when connecting to the database.
      • If you cleared the Create DB option in the previous step, you must specify a user that has the "db_owner" role for the specified database.
    5. Click Next.
    For Oracle:
    1. The installation requires that you have already created the physical database and that you have created an Oracle user with the appropriate permissions.
    2. To populate the schema, specify the TNSNAME of the database. The TNSNAME can be found in tnsnames.ora in <ORACLE_HOME>\network\admin.
    3. Specify the username and password that you want WorldServer to use when connecting to the database. This user must have runtime access to the database.
    4. Click Next.
  12. Select the program group where you would like the WorldServer shortcuts to be placed, and then click Next.
  13. Review your installation choices, and then click Next.
  14. After the files have been copied, click Finish.
  15. Deploy WorldServer on your environment.
    If you chose to have Tomcat deployed automatically in step 9, you have already finished the deployment process and you can move on to the next step.
  16. Restart your machine.
  17. Configure the WorldServer .properties files.
  18. Restart the Idiom Process Monitor service.

Results

You have now finished installing the components needed for WorldServer to function at a basic level.

What to do next

At this point, you can make various other configurations or you can proceed to installing the Report Center and the File Type Support (FTS) Server.