Step 4. Running the Setup Procedure

In this section:

Reference:

The installation procedure name is called ISETUP. For performance reasons, you should not install to an FSD or NFS-mounted disk.

To install:

  1. Log on with the iadmin user ID.
  2. Set the default protection mask to at least read/execute (if it has not already been set this way). For example:
    SET PROTECTION=(S:RWED,O:RWED,G:RE,W:RE)/DEFAULT
  3. Ensure that you are not in a directory containing the installation files:
    SET DEFAULT SYS$LOGIN
  4. Ensure that you have write privileges to the directory in which you execute the installation. You can test whether you have write permissions as follows:
    CREATE [.XXX] /DIRECTORY
  5. Execute the ISETUP procedure from either:

    You are prompted for the type of installation you are performing.

  6. Enter option 1, Install and Configure.

    You are prompted for your license key.

  7. Type your license key.

    Your license attributes are displayed, and the license key is confirmed.

    You are then prompted for the location of the installation file iserver.bck.

  8. Type the full path (including the CD or disk drive) of the installation file, or press Enter to accept the default.

    For example, from CD:

    CD:[IWAY]iserver.bck

    For example, from disk:

    [.download]iserver.bck

    You are prompted for the password of the server administrator (iadmin) ID.

  9. Type the server administrator password.

    The password does not display, and is stored in encrypted form.

    You are prompted to review the default values of the remaining installation parameters.

  10. To accept all the default values, enter Y and skip to Step 12. Otherwise, to change any values, continue with Step 11.

    Installing the demo files. By default, the Century Corp demo files are not installed. If you wish to install them, do not enter Y, but instead continue to Step 11, where you will have the option of installing them in one or more languages. (Note that all other demo files are installed automatically, in English, as part of the standard installation.)

  11. Enter N to be prompted individually for each installation parameter. For each one, you will be given the choice of accepting the default value or changing it.

    For information about these parameter values, see Server Installation Parameters. Note that the default root location is the iadmin ID home directory.

    If any of the prompted locations (such as EDAHOME) exist, they will be marked with "(*EXISTS*)" on the display line. This gives you the opportunity to change a location if you do not want to overwrite it by changing the default values.

    When specifying a location, note these requirements:

    Note that National Language Support (NLS) is set to OFF by default. You can configure it using the Web Console after installation.

  12. Review the configuration options displayed on the screen, and type Y if you accept them.

    Alternatively, to start over, enter N. To quit the installation procedure, enter Q.

    Several progress messages display while the server is being installed. You are then asked if you want to start the server.

  13. Type Y to start the server or N to exit.

    If you start the software, startup messages and the Web Console URL are now displayed.

You should now verify your installation, as described in Step 5. Verifying the Installation.


Top of page

x
Reference: Server Installation Parameters

The server installation procedure parameters are described in the following table.

Parameter

Description

EDAHOME

Directory location for files. Any changes in the EDAHOME location must follow the pattern *ibi.srv77*.home* in its declaration.

Note: Do not use dollar signs ($) in device or path names if Active Technologies has been licensed.

EDACONF

Location for the default configuration. The default value is based on the license key and any change in the EDAHOME directory pattern. The default will be a sibling directory to the EDAHOME directory in terms of its location, and will have a name, such as ffs, wfm, dm, or wfs (based on the key and on any change in the EDAHOME pattern).

When EDASTART is used to control the server, if the full path name of the EDACONF directory exceeds 31 characters, the directory is automatically aliased as EDASHARE=EDAn where n is the starting TCP port number of the server.

When aliasing occurs, a message similar to the following appears:

Warning: WSM id 'DISK$SOFTWARE:[IWAY.IBI.SRV77.FFS]
has been aliased to EDASHARE=EDA8100 due to length.
EDAPRFU

Location of user and group profiles and of admin.cfg, which specifies the server administrator.

APPROOT

Location for default applications and sample applications.

HTTP_BASE_PORT

First of three consecutive port numbers that the server uses for the HTTP Listener and other IP-based services.

If you are configuring multiple instances, be sure to specify a different range of ports for each server instance.

The default port automatically varies by product to support multiple servers on a particular computer:

  • For a Full-Function Server, 8101 is the default value, which reserves ports 8101-8103.
  • For a WebFOCUS Reporting Server, 8121 is the default value, which reserves ports 8121-8123.
  • For a DataMigrator Server, 8117 is the default value, which reserves ports 8117-8119.
  • For a Shared Application Server (for WebFOCUS Maintain), 8113 is the default, which reserves ports 8113-8115.
TCP_BASE_PORT

Port number on which the server TCP Listener listens. It must be outside the range of the three consecutive HTTP Listener ports. It defaults to the port immediately preceding the first HTTP Listener port.

For example, if you accept the default HTTP Listener Port value of 8101, the TCP Listener port defaults to 8100.

If you are configuring multiple server instances, be sure to specify a different port for each instance.

SMTP_HOST

SMTP Server node (host) name or TCP/IP number for outbound e-mail features. (Optional, only prompted for if changing directories and ports.)

SMTP_PORT

SMTP Server port number for SMTP Server. The default value is 25. (Optional, only prompted for if changing directories and ports, and the SMTP Server host is supplied.)

SENDER_EMAIL

Default from address for users reading an email from the server if none was specified in the originating application. (Optional, only prompted for if changing directories and ports, and the SMTP Server host is supplied.)

SERVER_ADMIN_EMAIL

Server administrator email address to send administrative warnings to, such as an agent crash. (Optional, only prompted for if changing directories and ports, and the SMTP Server host is supplied.)



Example: Installing and Starting a Full-Function Server

The following session is an example of a Full-Function Server installation from CD in which the user has accepted the default values. The session begins with a RUN command issued from the OpenVMS command prompt.

$ RUN CD:[IWAY]ISETUP
--------------------------------------------------------------------------
                 Welcome to the Product Set Up Facility
     Please respond to the prompts or enter Q to quit at any prompt.
--------------------------------------------------------------------------
 Select an option:
      1. Install and Configure
      2. Add Additional Configuration Instance
      3. Refresh Installation (Reinstall, Keep Configurations)
      4. Install Debuggables to the Installation Directory
 Enter a selection (Default=1) :   1
--------------------------------------------------------------------------
  Enter your License Key       (Current number of CPUs = 8)
 (Format 999-999-9999-99) :   xxx-xxx-xxxx-xx
    License Key has been checked
    Product: WebFOCUS Server
    Maximum Number of Adapters: Unlimited
    Maximum Number of Users:    8
    Maximum Number of CPUs:     Unlimited (8 found)
--------------------------------------------------------------------------
 Please enter the full path name of the media for the product
 (Default=CD:[IWAY]iserver.bck)
 Please supply media or <Enter> :
--------------------------------------------------------------------------
 Enter credentials for the server's internal security
 provider (PTH), the server's default start up mode.
 Enter the Server Administrator ID
 (Default=srvadmin) :
 Enter the Administrator Password :
 Use the WebConsole Access Control option to configure alternate
 or additional security providers, such as OPSYS, LDAP or others.
--------------------------------------------------------------------------
 Please review the default settings.
 EDAHOME = IWAY:[iadmin.ibi.srv77.home]
 EDACONF = IWAY:[iadmin.ibi.srv77.wfs]
 EDAPRFU = IWAY:[iadmin.ibi.profiles]
 APPROOT = IWAY:[iadmin.ibi.apps]
 HTTP_BASE_PORT = 8121
 TCP_BASE_PORT = 8120
 If you are satisfied with the default settings you may proceed to
 final confirmation else you will be prompted for individual values.
 Proceed with defaults? (Y/N Default=Y)  :  y
 The following selections have been made for ...
 Install Options ...
       INSTALLATION_DEVICE = CD:[IWAY]iserver.bck
       PRODUCT = server
       EDAHOME = IWAY:[iadmin.ibi.srv77.home]
       LICENSE = xxx-xxx-xxxx-xx
 Configure Options ...
       EDACONF = IWAY:[iadmin.ibi.srv77.wfs]
       EDAHOME = IWAY:[iadmin.ibi.srv77.home]
       LICENSE = xxx-xxx-xxxx-xx
       PRODUCT = server
       EDAPRFU = IWAY:[iadmin.ibi.profiles]
       WORKSPACE_MANAGER_NAME = "WebFOCUS 77 Server"
       APPROOT = IWAY:[iadmin.ibi.apps]
       SERVER_TYPE = ffs
       SERVER_ADMIN_ID = iadmin
       PTH_USER = srvadmin
       PTH_PASSWORD = 10838247AF51CF49
       HTTP_BASE_PORT = 8121
       TCP_BASE_PORT = 8120
 Please confirm these values with one of the following responses ...
    Y = Accept and Proceed
    N = Start Over
    Q = Quit
 Please supply confirmation: y
 Please wait while we are installing the product ...
 ISETUP: Installation Step completed
 Please wait while we are configuring the product ...
 ISETUP: Configuration Step completed
--------------------------------------------------------------------------
 Would you like to start the Server Workspace (Y/N Default=Y)?  :  n

Top of page

x
Configuring an Additional Server

If you have additional licenses and need to configure an additional instance, log on with the iadmin ID and run EDAHOME [.BIN]ISETUP.EXE, where EDAHOME is the directory on which the software was installed ([.IBI.SRV77.HOME] by default). At the main menu, select option 2, Add Additional Configuration Instance.

The prompts for adding a configuration are similar to those for an installation, but EDAHOME is the directory where the software was originally installed. Typically, you would not want to accept the defaults, as doing so will cause your current configuration to be overwritten. If the supplied EDACONF already exists, the installation will copy it to a directory called BACKUP.


Top of page

x
Refreshing an Installation

Sometimes it is desirable to refresh the software installation directory (EDAHOME) because it has become accidentally damaged or needs updating with a service pack. To do this, run the ISETUP program on the CD from which the software was originally installed, as described in Step 4. Running the Setup Procedure, or from a service pack CD. At the main menu, select option 3, Refresh Installation (Reinstall, Keep Configuration). This refreshes programming files under the software installation directory (EDAHOME) and does not affect any configuration directories. The complete directory tree (EDAHOME) is removed and re-created. If any files need to be retained, they should be copied elsewhere beforehand.


Top of page

x
Dismounting the Software CD

When you have finished accessing the CD, dismount it with the following command

DISMOUNT device_name:

where:

device_name:

Is the device name used in the original mount command.

Normally the CD will not be needed again unless a support situation requires debuggable versions of the software to be installed. A set of debuggables matching the original software is on the CD for this purpose. You will also need the CD if you refresh the installation.


Top of page

x
Installing and Configuring Silently

How to:

This is also known as a silent install. The most common form is an initial install, which also results in an initial configuration. An initial installation and configuration should only be done once per EDAHOME and an add product configuration used thereafter.

Installing silently can be helpful if you want to install multiple servers at once throughout an enterprise. To install a server silently, you must first create a text file that specifies your server installation parameters and then call isetup with the option and the file name. The silent method may also be used to do a software refresh

We recommend that the first time you install, you use the default interactive mode, not the silent mode, so that you become familiar with the procedure. Installing a server interactively is described in Step 4. Running the Setup Procedure.

Run isetup -? to see full information on the setup and specific use of a parameters file for silent installation, configuration, or refresh.



x
Procedure: How to Create the Installation Parameters File

Use a text editor to create a file with the following syntax to specify your product installation parameters:

-inst
-license nnn-nnn-nnnn-nn 
-edahome /ibi/srv77/home
-edaconf /ibi/srv77/product_type 
-port portnum 
-host hostname 
-approot drive:\ibi\apps
-programfolder "folder-title"
-pass password 
-nostart

where:

nnn-nnn-nnnn-nn

Is the 12-digit license. Include a hyphen (-) following the third, sixth, and tenth digits.

/ibi/

Is the drive and directory to which you want to install the software.

product_type

Designates the type of product. The default values are:

FFS

for a Full-Function Server

DM

for a DataMigrator Server

WFS

for a WebFOCUS Reporting Server

WFM

for a Shared Application Server for WebFOCUS Maintain

portnum

Is the base TCP port for the server.

hostname

Is the server host name.

folder-title

Is the name you want to assign to the Windows program folder and service. For example:

-programfolder "WebFOCUS 77 Server"
password

Is the password of the user ID with which you are installing the server.

To see a list of additional installation, configuration, and refresh options:

  1. Open a command prompt window and navigate to the directory containing the installation setup.exe file for the software.
  2. Enter the following:
    setup ?
  3. Accept a display language and click Next.

    A Help screen with further parameter file options will display.

The user may continue with the install (interactive) or quit at this point to attempt a silent install/configure.



x
Procedure: How to Launch a Silent Installation
  1. Open a command prompt and navigate to the directory containing the software and the setup.exe file for the install.
  2. Type the following:
    setup  -opt /path/srvoptions.txt

    where:

    /path/srvoptions.txt

    Is the full path and file name of the file specifying your installation options.

    For example, to specify English and an options file named serveroptsFFS1.txt, type:

    setup -opt /temp/serveroptionsFFS1.txt
  3. After the installation has completed you should verify that it was successful, as described in Step 5. Verifying the Installation.

iWay Software