Installing and Configuring Redwood Platform Service on Windows

This section tells you how to install and configure the Redwood Platform service on Windows. You need direct access to the system where the Redwood Platform is installed to perform the installation and configuration procedures described below.

Redwood Platform is based on the Apache Tomcat application server and uses the built-in functionality to run as a service. Since Tomcat has been optimized for Redwood Server, Redwood strongly recommends to use the tools it provided to install the service. It is recommended to follow the uninstall procedure of existing Redwood Platform services to ensure you do not get issues.

note

The <install_dir> variable is the full path to installation directory of Redwood Platform; it contains a j2ee and a docs folder by default.

note

Although you can technically use the service.bat located in <install_dir>/j2ee/cluster/global/tomcat/bin to install the service, it is strongly recommended you use the tools provided in <install_dir>/j2ee/cluster/global/bin. The tools have been customized to add all required parameters.

Syntax

rw_service.bat [install|remove|edit] [<service_name>] [/user [<domain>\]<username>]

• install - installs the service with name <service_name> (defaults to Scheduler)
• remove - removes the service named <service_name> (defaults to Scheduler)
• edit - opens the service configuration screen
• <service_name> - a name for the service, name can contain US ASCII letters and numbers, no spaces allowed.
• /user [<domain>\]<username> - sets the user for the service to the specified user. Note that you will have to specify the password.

Configuration Options

You access the service configuration dialog by executing <install_dir>/j2ee/cluster/global/bin/edit_service.bat.

tip

Redwood recommends you contact its Customer Support Services prior to changing values in the service configuration dialog.

Logging

You can set the logging level on the Logging tab of the service properties window. The default logging level is info; this should only be changed if you are experiencing issues and need to troubleshoot. Note that setting this to debug will generate a lot of logging!

JVM Parameters and Memory Allocation

You can set the JVM parameters and memory allocation on the Java tab of the service properties window. Note that since the 32-bit version of Java is used by default, you should not allocate more than 1.5Gb of memory to the JVM.

64-bit Support

If you want to use 64-bit versions of Java and Tomcat, please set the following environment variables prior to running rw_service.bat install:

• JAVA_HOME - must point to the Java installation path. If you want 64-bit support, point this to the installation path of a 64-bit JDK.
• RW_NO_EMBEDDED_JAVA_HOME - set this to true if you want to use your %JAVA_HOME%

Procedure

Uninstalling Existing Redwood Platform Services

This is recommended if you only have one instance of Redwood Platform running on the server.

1. Open cmd.exe.
2. Execute cd /d "<install_dir>\j2ee\cluster\global\bin".
3. Execute rw_service.bat remove [<service_name>].

Installing the Redwood Platform Service

1. Open cmd.exe.
2. Execute cd /d "<install_dir>\j2ee\cluster\global\bin".
3. Execute rw_service.bat install [<service_name>] [/user [<domain>\]<username>].

Editing the Service

1. Open cmd.exe.
2. Execute cd /d "<install_dir>\j2ee\cluster\global\bin".
3. Execute rw_service.bat edit [<service_name>].

onsiteTopic