CorporateTime for the Web 3.0

CorporateTime for the Web 3.0 Mobile Edition

Last updated: 22 February 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 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 (514) 733-8500.

Configuring your HTTP server

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

CorporateTime for the Web must be installed on a machine with an HTTP server. Although it can run on the same machine as CorporateTime Server, this is not the optimal configuration unless your user base is very small. Ideally, both CorporateTime Server and 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 CorporateTime for the Web with mod_fastCGI on an HTTP server (please 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 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 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 corptime-webclient.sparc-sun-solaris2.6.tar
  3. Execute the setup script.
    % ./webcalsetup
  4. 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. 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 perform an apachectl stop and apachectl start 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 a CorporateTime Server master node available, add a line to the [servers] section of the webcal.inil file in the lexacal-private subdirectory of the FCGI directory you created (see the 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,10000 = galaxy database

Uninstalling 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.

Legal information

This document and the software to which it refers are Copyright © 1998-2002 Steltor Inc. All rights reserved.

CorporateTime for the Web and CorporateTime Server are trademarks of Steltor Inc. All other product names are trademarks or registered trademarks of their respective owners.

Steltor Inc. makes no expressed or implied warranty with regard to the programs and materials offered or their salability or their fitness for any particular purpose. The program, materials, and documentation are made available solely on an AS IS basis, and the entire risk as to their quality, reliability, and performance is with the user. Should the program material or documentation prove defective, the user (not Steltor Inc. or any other party) shall bear the entire cost of all necessary correction and all incidental or consequential damages. Steltor Inc. shall not be liable for any incidental or consequential damages in connection with or arising out of the furnishing, use, or performance of the supplied material.

Unauthorized use of CorporateTime for the Web Mobile Edition is forbidden under the terms of your licensing agreement. Contact info@steltor.com to obtain a licensing agreement for this product.

Copyright © 1998-2002 Steltor Inc.
All rights reserved.
Web: www.steltor.com
Voice: (514) 733-8500
Fax: (514) 733-8878
sales@steltor.com