DataMigrator/Reporting Server > Installation for OpenVMS > Running the ISETUP Procedure to Install the Server

Running the ISETUP Procedure to Install the Server

Topics:

How to:

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

Procedure: How to Run the ISETUP Procedure

  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:
    RUN [.download]ISETUP

    The following isetup screen displays. 

    --------------------------------------------------------------------
              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
      5. View Installation Notes
Enter a selection (Default=1) :
  6. Enter 1 for the Install and Configure option.

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

    Please enter the full path name of the media for the product
  7. Type the full path (including the CD or disk drive) of the installation file, or press Enter to accept the default.

    For example:

    [.download]iserver.bck

    You are prompted for your license key. 

    Enter your License Key       (Current number of CPUs = n)(Format 999-999-9999-99) :   xxx-xxx-xxxx-xx
  8. Enter your license key.

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

    You are prompted for the ID of the server administrator for the internal server security provider. 

    Enter credentials for the server's internal security
provider (PTH), the server's default start up mode.
Enter the Server Administrator ID
(Default=srvadmin) :

    The server automatically starts with this security provider. You can add other security providers using the server Web Console after installation. For information, see the Server Administration manual.

  9. Enter the server administrator ID or accept the default.

    You are prompted for the server administrator password. There is no default. 

    Enter the Administrator Password :
  10. Type the password of the account you are using to install the software.

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

    You are now shown the default values of the server environment variables and port number, and given an opportunity to change them. For example: 

    Please review the default settings.
EDAHOME = dka0:[iadmin.ibi.srv77.home]
EDACONF = dka0:[iadmin.ibi.srv77.wfs]  (*EXISTS, owner iadmin *)
EDAPRFU = iadmin.profiles
APPROOT = iadmin.ibi.apps
HOMEAPPS = iadmin.ibi.homeapps
HTTP_BASE_PORT = 8121
WARNING: Directories marked as existing will be deleted and recreated!
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
  11. If you want to accept the default values, type Y and skip to Step 12. Otherwise, change any properties that you wish.

    For information about the EDAHOME, EDACONF, EDAPRFU, and APPROOT environment variables you can set, see Installation and Configuration Directories.

    The other properties you can set are described in the following table.

    Parameter

    Description

    		 
    HTTP_BASE_PORT

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

    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.
    • A WebFOCUS Reporting Server, 8121 is the default value, which reserves ports 8121-8123.
    • A DataMigrator Server, 8117 is the default value, which reserves ports 8117-8119.
    • 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. 

    SMTP_HOST

    SMTP Server node (host) name or TCP/IP number for outbound email 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.)

    If you decide to change a default, you are prompted for a replacement value each of the above variables, and given another chance to accept the default. If the SMTP Server node is not supplied, the remaining SMTP and EMAIL prompts do not occur.

  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. If a server installation, type Y to start the server or N to exit.

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

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

Configuring an Additional Instance of the Server

How to:

The prompts for adding a configuration are similar to those for an original installation.

Procedure: How to Configure an Additional Server Instance

If you have additional licenses and need to configure additional instances:

  1. Sign in using the iadmin ID.
  2. Run EDAHOME.bin]isetup, where EDAHOME is the directory in which the software was installed.
  3. At the main menu, select option 2, Add Additional Configuration Instance.

    Each instance must have its own configuration directory. When prompted for the configuration directory, append characters to the default name of the product type directory. Otherwise, the installation will overwrite the existing configuration directory. In the following example, the number 2 has been added to the default name of the WebFOCUS Reporting Server configuration directory: 

    iadmin.ibi.srv77.wfs2

    If the EDACONF directory you specify already exists, the installation process copies selected files from files in the current configuration to a directory named BACKUP that is a sibling directory to EDACONF, and then deletes the contents of the original directory. For example, if EDACONF is 

    dka0:[iadmin.ibi.srv77.wfs]

    then the selected configuration files are backed up to: 

    dka0:[iadmin.ibi.srv77.BACKUP]

Refreshing or Upgrading an Installation

How to:

Refreshing reinstalls the files in the installation directory, without changing any configuration information in the configuration directory.

Procedure: How to Refresh or Upgrade an Installation

If it becomes necessary to refresh, or if you want to upgrade to a new release:

  1. Sign in using the iadmin user ID.

    Logging on with the iadmin ID is recommended (rather than with the su command).

  2. Set the default protection mask to, at a minimum, read/execute (if it is not already set to that). For example:
    SET PROTECTION=(S:RWED,O:RWED,G:RE,W:RE)/DEFAULT

    Ensure that you have write privileges to the directory from which you are running the command. To test this, type: 

    SET DEFAULT SYS$LOGIN
  3. Run the installation procedure, isetup, specifying its full path. You can run the installation procedure from any location. Do not switch the current directory to the location of isetup. For example:
    iadmin.download.isetup
  4. At the main menu, type option 3, Refresh Installation (Reinstall, Keep Configuration), and respond to the prompts.

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 Running the ISETUP Procedure to Install the Server.

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

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 dka0:[iadmin.ibi.srv77.home]
-edaconf dka0:[iadmin.ibi.srv77.product_type]
-port portnum-host hostname-approot dka0:[iadmin.ibi.srv77.apps] 
-pass password-nostart

where:

nnn-nnn-nnnn-nn

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

dka0:[iadmin.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. Full-Function Server.
  • DM. DataMigrator Server.
  • WFS. WebFOCUS Reporting Server.
  • WFM. Shared Application Server for WebFOCUS Maintain.
portnum

Is the base TCP port for the server.

hostname

Is the server host name.

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:
    MCR [.download]setup.exe ?
  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.

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 installation.
  2. Type the following:
    dka0:[iadmin.path]srvoptions.txt

    where:

    dka0:[iadmin.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 serveroptions.txt, type: 

    MCR [.download]setup -opt dka0:[iadmin.path]srvoptions.txt
  3. After the installation has completed you should verify that it was successful, as described in Verifying the Installation.

 WebFOCUS

Feedback