Step 4. Running the Installation Program

In this section:

Reference:

  1. Log on with the iadmin user ID.
  2. On the IBM i command line, call the installation procedure. For example
    CALL instLibName/ISETUP

    where:

    instLibName

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

  3. Select the initial code page, or press Enter to accept the default value. (Most installation procedure prompts will allow you to press Enter to accept the default.)

    For information about your code page choices, see Server Installation Parameters.

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

  4. Enter the installation option 1 (Install and Configure).

    You are prompted for your license key.

  5. Enter your license key. You can find it on your shipping manifest.

    You are prompted for the name of the installation media library.

  6. Enter the name of the installation library that you downloaded, or restored from DVD, in Step 3. Accessing the Installation Software. The default name is I77LIB.

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

  7. Enter the server administrator password.

    You are prompted for the server system (iserver) ID.

  8. Enter the server system ID.

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

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

    Installing the demo files. By default, the Century Corp demo files are not installed. If you wish to install them, do not enter Y; continue to Step 10, 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.

  10. 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 the server National Language Support (NLS) is set to OFF by default. You can configure it using the Web Console after installation.

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

  12. 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 Step 5. Verifying the Server Installation.


Top of page

x
Reference: Server Installation Parameters

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

Parameter

Description

Media for Product

Name of the installation library that you downloaded, or restored from DVD, in Step 3. Accessing the Installation Software. The default name is I771LIB.

Server Admin Password

Server administrator (iadmin) password. It is recommended that you supply a password. Otherwise, the server will start in safe mode.

Server System Support ID

The ID (ISERVER) used internally by the server for security authority. For more information about it, see User ID Requirements.

EDAHOME

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

EDAHOMELIB

QSYS library location for programs.

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 have a name, such as ffs, wfm, dm, or wfs (based on the key and on any change in the EDAHOME pattern).

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 server 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 server 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: Full-Function Server Installation

The following session is an example of a Full-Function Server installation in which the user has accepted the default values. The session begins with a CALL command issued from the command line of the IBM i menu.

CALL I77LIB/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 = 2)
 (Format 999-999-9999-99) :   xxx-xxx-xxxx-xx
 
    License Key has been checked
 
    Product: Full Function Server
    Maximum Number of Adapters: 4
    Maximum Number of Users: 8
    Maximum Number of CPUs: 2 found
 
 ISETUP: License xxx-xxx-xxxx-xx has been accepted
----------------------------------------------------------------------
 
 Please enter the media library name
 
 (Default=R729999BTP)
 
 Please supply media or <Enter> :
 
----------------------------------------------------------------------
 Enter the Server Administrator (IADMIN) Password:
 xxxxxx
 
 Enter the Server System Support ID
 
 (Default=QSECOFR) :
 xxxxxx
 
----------------------------------------------------------------------
 Please review the default settings.
 
 EDAHOME = /home/iadmin/ibi/srv77/home
 EDAHOMELIB = srv77
 EDACONF = /home/iadmin/ibi/srv77/ffs
 EDAPRFU = /home/iadmin/profiles
 APPROOT = /home/iadmin/ibi/apps
 HTTP_BASE_PORT = 8101
 TCP_BASE_PORT = 8100
 
 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
 
 The following selections have been made for ...
 
 Install Options ...
       INSTALLATION_DEVICE = /cdrom/iserver.tar
       PRODUCT = server
       EDAHOME = /home/iadmin/ibi/srv77/home
       EDAHOMELIB = srv77
 Configure Options ...
       EDACONF = /home/iadmin/ibi/srv77/ffs
       EDAHOME = /home/iadmin/ibi/srv77/home
       EDAHOMELIB = srv77
       LICENSE = 999-999-9999-99
       WORKSPACE_MANAGER_NAME = "iWay 77 Full Function Server"
       EDAPRFU = /home/iadmin/profiles
       APPROOT = /home/iadmin/ibi/apps
       SERVER_TYPE = ffs
       SERVER_ADMIN_ID = IADMIN
       SERVER_ADMIN_PASSWORD = C498X8e60C1ByAF7526E2
       SERVER_ADMIN_ID = IADMIN
       SERVER_ADMIN_PASSWORD = C498X8e60C1ByAF7526E2
       SERVER_SYSTEM_ID = QSECOFR
       HTTP_BASE_PORT = 8101
       TCP_BASE_PORT = 8100
 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 server ...
 
 ISETUP: Installation Step completed
 
 Please, wait while we are configuring the server ...
 
 ISETUP: Configuration Step completed
 
----------------------------------------------------------------------
 
 Would you like to start the Server Workspace (Y/N Default=Y)?    :  y
 
 09/09/2006 15:29:20  Starting Workspace Manager in
   /home/iadmin/ibi/srv77/ffs
 09/09/2006 15:29:20  Logging startup progress and errors in
   /home/iadmin/ibi/srv77/ffs/edaprint.log
 09/09/2006 15:29:20  Opening PTH context
 09/09/2006 15:29:21  Checking listeners and services
 09/09/2006 15:29:24  TCP started
 09/09/2006 15:29:24  HTTP started
 09/09/2006 15:29:24  JSCOM3 started
 09/09/2006 15:29:24  Workspace Manager started.
 ISETUP: The server has been started
 
----------------------------------------------------------------------
 To administer the server go to a web browser
 and open the URL http://myworld:10901

Top of page

x
Additional Configurations

If you have additional licenses and need to configure an additional server, log on with the iadmin ID, start QSH, and run EDAHOME /bin/isetup, 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 server software installation directory (EDAHOME) because it has become accidentally damaged, populated with unwanted files, or needs updating with a service pack. To do this:

  1. Log on with the iadmin user ID.
  2. On the IBM i command line, call the installation procedure where it resides.

    For example:

    CALL I771LIB/ISETUP
  3. Specify the initial code page to be used by the server, as described in Step 4. Running the Installation Program.
  4. At the main menu, select option 3, Refresh Installation (Reinstall, Keep Configuration), and follow the prompts.

This refreshes programming files under the server installation directory (EDAHOME) and does not affect any configuration directories. The complete directory tree (EDAHOME) and library (EDAHOMELIB) are removed and recreated. If any files need to be retained, they should be copied elsewhere beforehand.


Top of page

x
Installing and Configuring a Server Silently

This is also know as a silent install. The most common form is an initial install which also results in an initial configuration (and is what is documented here). 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.

We recommend that the first time you install a server, 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 Installation Program.

Run isetup -? to display information on the setup and specific use of a parameters file for silent installation and configuration.


iWay Software