Running ISETUP to Install the Server Software

How to:

You can install the server software by running isetup interactively and responding to prompts or by creating a file containing the answers to the prompts and running isetup against that file. The method using a file is called a silent install.

Procedure: How to Run ISETUP Interactively

  1. Sign in using the iadmin user ID.
  2. On the IBM i command line, call the installation procedure. For example, for downloaded software, do the following.
    CALL instLibName/ISETUP

    where:

    instLibName

    Is the name of the installation library that you downloaded, or restored from DVD, in Downloading the Server Installation Software. The default name is I77LIB.

    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) :
  3. Enter 1 for the Install and Configure option.

    You are prompted for the location of the installation file.

  4. Enter the name of the installation library that you downloaded, or restored from DVD, or press Enter to accept the default. The default name is I77LIB.

    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
  5. Enter your license key.

    Your license attributes are displayed, and the license key is confirmed. Certain license keys will issue a warning that the actual CPU quantity is over the licensed amount. In that case, the software needs to be run using OS commands that limit CPU use.

    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.

  6. 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 :
  7. 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 = /prog3/iadmin/ibi/srv77/home
    EDACONF = /prog3/iadmin/ibi/srv77/wfs  (*EXISTS, owner iadmin *)
    EDAPRFU = /prog3/iadmin/profiles
    APPROOT = /prog3/iadmin/ibi/apps
    HOMEAPPS = /prog3/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

    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:

    • The EDAHOME directory path name directory path name must conform to the pattern *ibi/srv77*/home* and must be an absolute path.
    • If you changed the EDAHOME value, the default EDACONF and EDAHOMELIB values change to conform to EDAHOME.

      EDACONF must be in the same srv77 path as EDAHOME. The lowest-level EDAHOME directory (home) becomes the product type directory in EDACONF.

      For example, if EDAHOME is

      iadmin/ibi/srv77/home

      then EDACONF for a WebFOCUS Reporting Server defaults to:

      iadmin/ibi/srv77/wfs

      If you are configuring an additional server instance, be sure to specify a new configuration directory here; do not use an existing directory. Each instance must have its own configuration directory. You can append characters to the name of the product_type directory to avoid overwriting the existing directory. For example:

      iadmin/ibi/srv77/wfs2
  8. If you want to accept the default values, type Y and skip to Step 10. 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.

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

  10. 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 Server Installation.

WebFOCUS

Feedback