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
- If you have a previous instance of WorldServer on your machine, uninstall that instance (Control Panel > Add or Remove Programs > SDL WorldServer).
Note: You can choose whether you also want to delete the WorldServer database and the RCS files. Deleting the database of a previous version will cause you to lose all the data for that version, including your users, workflows, translation memories, and translation databases. You should only delete the previous database if you are performing a new installation and want to delete all the old work.
- If you are installing from a downloaded distribution kit, extract the kit in a temporary folder.
- Use Windows Explorer to navigate to the newly created WorldServer folder and double-click the setup_64.exe file.
- On the Welcome screen, click Next, and then click Yes to accept the License Agreement.
- 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.
- Type your user name and company name, and then click Next.
- Choose a location to install the WorldServer program files, and then click Next.
- Choose an installation type, and then click Next.
Note: By using the custom option, you can choose a location for the WorldServer log files, the RCS root, and the WorldServer temp directory. For performance reasons, SDL recommends that you place the log files and temporary directory on a different physical disk drive than the application server or the database files. This will reduce I/O contention as WorldServer is running.
- Choose an application server, and then click Next.
Note: If you choose Tomcat, the installer installs Tomcat and sets up WorldServer to work with this deployment. The WorldServer installer deploys the WorldServer Web application to <WS_HOME>\tomcat\webapps\ws (where <WS_HOME> is the WorldServer home directory, by default C:\Program Files\Idiom\WorldServer). The installer also creates a service called Idiom Process Monitor, which you can use to start and stop Tomcat. All requests to start and stop Tomcat are handled by the Idiomrunw.exe program, located under <tomcat-home>/bin.
If you choose Other, you have to browse to the directory where you want to place the WorldServer WAR (Web archive) files, which you can then deploy under your application server. Choose Other only if you want to deploy Tomcat manually.
- 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>).
- Choose a database platform (SQL Server or Oracle) and specify the following:
For SQL Server:
- Provide the name of an existing SQL Server database server and an instance to connect to.
- The installation requires that you have already created the physical database and that you have created an SQL Server user with appropriate permissions.
- Specify the name of the database server and of the database that you want to use and clear the Create DB option.
Note: You also need to clear Create DB if you are upgrading from a previous version. Selecting Create DB with an existing database causes the installation to fail.
- Specify the username and password that you want WorldServer to use when connecting to the database.
Note: The WorldServer installer only handles letters, numbers, and underscores in the password string. Do not specify a password that contains other characters.
- 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.
- Click Next.
For Oracle:- The installation requires that you have already created the physical database and that you have created an Oracle user with the appropriate permissions.
- To populate the schema, specify the TNSNAME of the database. The TNSNAME can be found in tnsnames.ora in <ORACLE_HOME>\network\admin.
Note: For a WorldServer installation, do not use the Create DB option for either a new or an upgrade Oracle installation.
- 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.
Note: The WorldServer installer only handles letters, numbers, and underscores in the password string. Do not specify a password that contains other characters than these.
- Click Next.
Note: If at this point, you get a failure message that the system account does not have sufficient privileges to create the database, the problem is not about the system account's privileges—it is more likely to be that you did not create the Oracle database user. You should create the Oracle database user, and then start the WorldServer installation again.
- Select the program group where you would like the WorldServer shortcuts to be placed, and then click Next.
- Review your installation choices, and then click Next.
- After the files have been copied, click Finish.
- 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.
- Restart your machine.
- Configure the WorldServer .properties files.
Note: If you want to configure the WorldServer application server to use SSL, consult the SSL setup instructions for the application server that they are using.
- Restart the Idiom Process Monitor service.
Results
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.