Installing Reflection for the Web 2008 on UNIX or Linux
Technical Note 1699
Last Reviewed 02-Jun-2011
Applies To
Reflection for the Web 2008 (All Editions)
Summary

To install Reflection for the Web 2011 on a UNIX or Linux machine, follow the steps in the Installation Guide. Use this technical note to manually install Reflection for the Web 2008 to a machine running UNIX or Linux when an automated installer is not available for your platform.

If you are installing Reflection for the Web 2011, please follow the instructions in the Reflection for the Web 2011 Installation Guide located here: http://support.attachmate.com/manuals/rweb2011.html.

This technical note includes information about installing and configuring Java SDK, Tomcat, and Reflection for the Web 2008 on a UNIX or Linux machine. This information in this note is organized into the following sections:

Conventions Used in this Document

The instructions provided in this document apply to both UNIX and Linux systems; however, for ease of use, the term UNIX is used throughout this document.

This document assumes that you will install the Java SDK, Tomcat, and Reflection for the Web 2008 into the directories noted below. If any of these applications are installed in different locations, such as /opt, make the necessary path changes when following the steps provided in this document.

  • Java Software Developer's Kit (Java SDK) version 1.5 or higher for Reflection for the Web 2008* Tomcat: /usr/local
  • Reflection for the Web 2008: /usr/local/jakarta-tomcat/webapps/rweb

Before You Begin

Note the following before you install Reflection for the Web 2008:

  • For best results, proceed through each section in this technical note in the order presented.
  • The steps presented in this document require that you are logged on to your UNIX system as root.

Attachmate Technical Support recommends that you review the Reflection for the Web 2008 Installation Guide, which is available with the product and online: http://support.attachmate.com/manuals/rweb2008.html

Obtaining and Installing the Java SDK

If Java is already installed on your UNIX machine, skip to Installing and Configuring Tomcat. If Java is not yet installed, follow the steps below to obtain and install the correct version of Java.

Note the following:

  • For HP-UX, obtain the Java SDK from https://h20392.www2.hp.com/portal/swdepot/displayProductInfo.do?productNumber=HPUXJAVAHOME. The exact file needed depends upon your version of HP-UX. Follow the installation instructions obtained in the downloaded files, and then proceed to the next section.
  • For AIX, obtain the Java SDK from http://www.ibm.com/developerworks/java/jdk/aix/service.html. The exact file needed depends upon your version of AIX. Follow the installation instructions obtained in the downloaded files, and then proceed to the next section.
  • If you plan to install Reflection for the Web on a 64-bit UNIX or Linux system, you must use a 64-bit Java SDK.

To obtain and install Java for other UNIX systems, follow these steps:

  1. Navigate to the /usr directory. Create a sub-folder named /java:
/usr/java
  1. Go to http://www.oracle.com/technetwork/java/javase/downloads/index.html and download Java SDK version 1.5 or higher for your environment. Select the product for your UNIX operating system, and download the SDK.
  2. Follow the installation instructions or either 64-bit or 32-bit Linux from Oracle’s web site:
  1. Add Java's /bin directory to your $PATH.

For example, for Linux and most UNIX platforms using the bash shell, the $PATH is updated as follows:

export PATH=/usr/java/jdk1.6.0/bin:$PATH

For Sun Solaris, use the following commands:

PATH=/usr/java/jdk1.6.0/bin:$PATH
export PATH
  1. To verify that your environment has been successfully configured, type the following at the prompt:
java -version

Version information similar to the following should be displayed, confirming that you have installed the Java™ 2 Runtime Environment:

java version "1.6.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.6.0)
Java HotSpot(TM) Client VM (build 1.4.2, mixed mode)

Installing and Configuring Tomcat

Once Java is installed, follow the steps below to install and configure Tomcat, the servlet runner.

  1. Copy the zipped Tomcat file, \install\nonautomated\tomcat.zip, located with the downloaded product files (or on the Reflection for the Web CD) to /usr/local.
  2. Enter the following command to extract the Tomcat files to /usr/local:
jar -xf /usr/local/tomcat.zip
  1. In the /usr/local/jakarta-tomcat/bin directory, open the setenv.sh file in the editor of your choice.
  2. Set the JAVA_HOME and, if necessary, JSSE_HOME environment variable paths so that they correspond to your directory structure.

(Search for java.exe and enter the path to the directory above the /bin/ directory.) For example, the JAVA_HOME line in setenv.sh might read,

JAVA_HOME=/usr/java/j2sdk1.6.0

Note the following:

    • The JSSE is incorporated in JDK version 1.4 or higher, so the JSSE_HOME variable should be left blank, JSSE_HOME=.
    • JDK version 1.5 or higher is recommeneded for Reflection for the Web 2008.Java is no longer fully tested or supported.;
  1. Save and exit the file.
  2. Use the following chmod command to configure all the .sh files with full access permissions for owner, and read and execute permissions for group and other.
chmod 755 *.sh

Note: The .sh files are in /user/local/jakarta-tomcat/bin.

Modifying the HTTPS and HTTP Port Numbers

If no other web server is configured on the machine where Tomcat was installed, skip to Installing and Configuring Reflection for the Web 2008.

If another web server was present on the UNIX machine when Tomcat was installed, you may need to modify Tomcat's HTTPS and HTTP port numbers to avoid interference with the other web server.

When choosing a new port, select ports above 1024 (available to non-root users). Follow the steps below to change the Tomcat port numbers.

  1. Navigate to /usr/local/jakarta-tomcat/conf.
  2. Open the server.xml file in the editor of your choice.
  3. To modify the HTTPS port, locate the following entry:
<!-- Define a SSL Coyote HTTP/1.1 Connector on port 443 -->
<!-- https_connector_placeholder_begin -->
<Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port=
"443" minProcessors="5" maxProcessors="75" enableLookups=
"false" acceptCount="100" debug="0" scheme="https" secure=
"true" useURIValidationHack="false" disableUploadTimeout="true">

Change the default HTTPS port number from 443 to a port that is not already in use. For example, change the number from 443 to 8443, shown in red below. After editing, the entry should look like this:

<!-- Define a SSL Coyote HTTP/1.1 Connector on port 8443 -->
<!-- https_connector_placeholder_begin -->
<Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port=
"8443" minProcessors="5" maxProcessors="75" enableLookups=
"false" acceptCount="100" debug="0" scheme="https" secure=
"true" useURIValidationHack="false" disableUploadTimeout="true">
  1. To modify the HTTP port, locate the following entry:
<!-- Define a non-SSL Coyote HTTP/1.1 Connector on port 80 -->
<Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port=
"80" minProcessors="5" maxProcessors="75" enableLookups=
"false" redirectPort="443" acceptCount="100" debug=
"0" connectionTimeout="20000" useURIValidationHack=
"false" disableUploadTimeout="true" />
    1. Change the default HTTP port from 80 to a port that is not already in use. For example, change the number from 80 to 8880, shown in red below.
    2. Also change the redirectPort from 443 to the HTTPS port you have defined, for example, 8443. After editing the entries should look like this:
<!-- Define a non-SSL Coyote HTTP/1.1 Connector on port 8880 -->
<Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port=
"8880" minProcessors="5" maxProcessors="75" enableLookups=
"false" redirectPort="8443" acceptCount="100" debug=
"0" connectionTimeout="20000" useURIValidationHack=
"false" disableUploadTimeout="true" />
  1. Save the file.

Installing and Configuring Reflection for the Web 2008

Now that Java and Tomcat are installed, you are ready to install Reflection for the Web.

Follow these steps to install and configure Reflection for the Web 2008.

  1. Create an rweb directory under /u/ReflectionServer/jakarta-tomcat/webapps/.
  2. Copy the file \install\nonautomated\rweb.war from the Reflection for the Web product package to /usr/local/jakarta-tomcat/webapps/rweb.
  3. Navigate to /user/local/jakarta-tomcat/webapps and enter the following command to extract the Reflection for the Web files:
jar -xf /usr/local/jakarta-tomcat/webapps/rweb.war

This extracts the Reflection for the Web files and creates the Reflection for the Web directory structure.

  1. Now, edit the web.xml file to specify the ReflectionData directory location and the SSL port value:
    1. Navigate to the /usr/local directory and create a new directory named ReflectionData (if one does not already exist).
    2. Navigate to /usr/local/jakarta-tomcat/webapps/rweb/WEB-INF.
    3. Open the file, web.xml, in the text editor of your choice.
    4. In the web.xml file, replace the value for rwebdata_location_placeholder with /usr/local/ReflectionData (or the location and name of the directory you created in step 3a) and the value for https_port_placeholder with the HTTPS port number (configured in the previous section Modifying the HTTPS and HTTP Port Numbers). This configures SSL to use the specified port. The resulting lines look like this:
           <web-app>
            <context-param>
                <param-name>ReflectionData</param-name>
                <param-value>/usr/local/ReflectionData</param-value>
            </context-param>
            <context-param>
                <param-name>sslport</param-name>
                <param-value>8443</param-value>
            </context-param>

Note: In Reflection for the Web 2008, the sslport parameter is located in the PropertyDS.xml file, which is located in the ReflectionData directory. To modify the port value, you must edit PropertyDS.xml.

    1. Save the file.

Configuring Reflection to Use HTTPS

If you do not plan to use HTTPS, skip to the next section, Starting Tomcat.

If you plan to use HTTPS to access the web server, you must use a server certificate.

You can configure Reflection to use either a self-signed certificate, or a Certificate Authority (CA) signed SSL server certificate. For information about Tomcat and CA-signed certificates, see Technical Note 1702.

Follow the steps below to start the Certificate Wizard, and then follow the Wizard instructions to create a self-signed certificate or to import a CA-signed certificate.

Note: This command must be run from the console that has a graphical UI or from a graphical user interface, such as Reflection X.

  1. Navigate to the directory where CertWizard.jar is located; look in /usr/local/jakarta-tomcat/WRQUtilities.
  2. At the prompt, enter the following command on a single line:
java -cp /usr/local/jakarta-tomcat/WRQUtilities/KeyTools
Pro_jce1-2-1_1of2_signed.jar:/usr/local/jakarta-tomcat/WRQUtilities/CertWizard.jar run

Note: On some systems, you may need to remove "run" from the command.

Starting Tomcat

To start Tomcat:

  1. Navigate to /usr/local/jakarta-tomcat/bin.
  2. At the prompt, enter the following command:
./startup.sh

Note: There is no visible indication in the shell when startup.sh has successfully started Tomcat, and it may take a while before Tomcat is fully started and responsive on its listening ports. Use the ps or top command to see if it is running.

Accessing Reflection for the Web 2008

To start Reflection for the Web Administrative WebStation, open your web browser and enter the appropriate URL for your configuration into the Address field, replacing the <server name> and <port #> sections with your site specific information:

For HTTPS

https://<server name>:<SSL port #>/rweb/AdminStart.html

For HTTP

http://<server name>:<http port #>/rweb/AdminStart.html

Note: By default, the administrative password is admin.

Stopping Tomcat

If you need to stop Tomcat, navigate to /usr/local/jakarta-tomcat/bin and enter:

./shutdown.sh

Optional: Security Proxy Server and Metering

For information about manually installing and configuring Reflection for the Web's security proxy server feature on UNIX systems that are not supported by the automated installation methods, see Technical Note 1812.

Note: Beginning in Reflection for the Web 2008, the security proxy server is not included in the Standard Edition.

To enable the optional metering feature in Reflection for the Web, see Technical Note 1824.

Troubleshooting

If you experience difficulties getting Tomcat to start, or getting Reflection for the Web 2008 to load, check the log files located at /jakarta-tomcat/logs.

Related Technical Notes
1702 Implementing a CA Signed Certificate for Tomcat
1788 Reflection Terminal Emulation Products and Linux/UNIX Workstations
1812 Setting Up the Reflection for the Web 2008 Security Proxy Server in UNIX, Linux, or Mac OS X
1824 Installing Reflection for the Web Metering Server in UNIX
9988 Reflection for the Web Technical Notes

Did this technical note answer your question?

           



Need further help? For technical support, please contact Support.