Oracle CorporateTime for the Web 3.1

Oracle Mobile Edition 3.1

Last updated: 5 August 2002

This file contains installation instructions only. For more information on running an HTTP server with mod_fastCGI, visit http://www.fastcgi.com/.

For system requirements, limitations and other information about this product, consult the Release Notes. For detailed information on configuring Oracle CorporateTime for the Web, consult the Administrator's Guide.

Note: In the following documentation, forward slashes are used in directory paths. Angle brackets (<>) enclose variables. For example: <fcgi-directory>/swc indicates the swc directory under the configured FCGI directory.

Contents of this README file:

How to report problems

Post any problems or questions you have to support@steltor.com, or call 1.514.733.8500 (8 a.m. - 7 p.m. EST) or 1.514.733.2917 (outside normal EST business hours).

Configuring your HTTP server

Make sure you are compliant with the software requirements documented in the Release Notes.

Oracle CorporateTime for the Web must be installed on a machine with an HTTP server. Although it can run on the same machine as Oracle CorporateTime Server, this is not the optimal configuration unless your user base is very small. Ideally, both Oracle CorporateTime Server and Oracle CorporateTime for the Web should be installed on dedicated hosts, tuned for the expected usage on your site.

Setting up a new FCGI directory

You must configure your httpd.conf to run Oracle CorporateTime for the Web with mod_fastcgi on an HTTP server (consult the Release Notes for detailed information). If you have a complex operating environment or you do not feel the guidelines provided are optimal for your setup, please refer to http://www.fastcgi.com/ for more detailed information.
Variables
Note: Except for #3, values inside angled brackets (<>) are variables.

To set up a new FCGI directory for Oracle CorporateTime for the Web, add the following directives to your httpd.conf:

  1. ScriptAlias: Add using the variables given below. Allows you to specify locations where the application can run FCGIs (executables).
    ScriptAlias /<FCGI_DIR>/ <SERVER_PREFIX>/<FCGI_DIR>/
    If your FCGI_DIR were fcgi-bin and your SERVER_PREFIX were /usr/local/Apache/, the ScriptAlias command would be:
    ScriptAlias /fcgi-bin/ /usr/local/Apache/fcgi-bin/
  2. AddHandler: Instructs the Apache Server to use the fastcgi-script to run anything with an FCGI suffix.
    AddHandler fastcgi-script .fcgi
  3. SetHandler: Add using the SERVER_PREFIX and FCGI_DIR values defined above. Instructs the Apache Server to use the fastcgi-script to handle anything in a directory you specify.
    <Directory /usr/local/Apache/fcgi-bin>
    SetHandler fastcgi-script
    </Directory>
  4. IPC_DIR: The directory where the socket file is created. Please make sure to configure permissions for IPC_DIR correctly.
    FastCgiIpcDir <IPC_DIR>
  5. FastCgiServer: Allows you to configure connections to the application, with the following options:
    • -listen-queue-depth: the default size of the listen queue for the application
    • -init-start-delay: the default delay a user experiences when launching the application
    • -processes: the number of FCGI apps running concurrently
    • -appConnTimeout: interval of seconds before the application time outs when the user attempts a reload
    • -socket: only needed if you are using quiet command-line utilities
      FastCgiServer <SERVER_PREFIX>/<FCGI_DIR>/swc/lexacal.fcgi
      -listen-queue-depth 32 -init-start-delay 4 -processes <NUM_PROCS>
      -appConnTimeout 30 -socket <SOCKET_FILE>
If you encounter any problems, contact our support staff at support@steltor.com.

Before installation

In your httpd.conf file:

Installing Oracle CorporateTime for the Web

  1. Sign in as root.
  2. In a temporary location, extract the CorporateTime for the Web tar file. For example:
     % gtar xvf ctw_0301000.1630_solaris_en_int.tar.gz
  3. Execute the setup script.
    % ./webcalsetup
  4. Oracle CorporateTime for the Web will prompt you for:
    • User name and group name: the values in your httpd.conf
    • Fast-CGI Directory: the full path to your FCGI directory (specified in the httpd.conf of your HTTP server)
    • Fast-CGI URL Prefix: the name of your FCGI directory (without a trailing slash)
    • Primary Document Directory: the DocumentRoot variable in your httpd.conf
    • Server name and node ID
    • Node alias
  5. Oracle CorporateTime for the Web will create swc directories under the FCGI directory and the Primary Document Directory, create the webcal.ini file, change file permissions and set file ownerships.
  6. For detailed information on customizing appearance and tuning parameters, consult the Administrator's Guide.
If you make any changes to webcal.ini, you must restart apache or lexacal.fcgi for the changes to take effect.

Verifying installation

To verify your installation, point your web browser to the URL as described below, using the following variables: http://<HTTP_URL><Port>/<fcgi_url_prefix>/swc/lexacal.fcgi

To make an Oracle CorporateTime Server master node available, add a line to the [servers] section of the webcal.ini file in the lexacal-private subdirectory of the FCGI directory you created (see the Oracle CorporateTime Server Administrator's Guide for more information on master node setup). For example, if there were a CorporateTime Server master node on the host galaxy at node-ID 10000, you would add this line to the [servers] section:

galaxy database = galaxy,10000

Uninstalling Oracle CorporateTime for the Web

  1. Sign in as root.
  2. Stop your HTTP server.
  3. Go to your FCGI directory.
    • Remove the swc subdirectory.
    • Remove the lexacal-private directory.
  4. In your HTTP server's Primary Document Directory, remove the swc subdirectory.
  5. Start your HTTP server.

Copyright © 1998, 2002, Oracle Corporation
All rights reserved.