In this section: Reference: |
CALL instLibName/ISETUP
where:
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.
For information about your code page choices, see Server Installation Parameters.
You are prompted for the type of installation you are performing.
You are prompted for your license key.
You are prompted for the name of the installation media library.
You are prompted for the password of the server administrator (iadmin) ID.
You are prompted for the server system (iserver) ID.
You are prompted to review the default values of the remaining installation parameters.
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.
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:
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
For more information about EDAHOME and EDACONF, see Installation and Configuration Directories.
Note that the server National Language Support (NLS) is set to OFF by default. You can configure it using the Web Console after installation.
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.
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.
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 instance. The default port automatically varies by product to support multiple servers on a particular computer:
|
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 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.) |
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 = 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 media library name (Default=I77LIB) 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. Enter the Server System Support ID (Default=QSECOFR) : --------------------------------------------------------------------------
Supply the location on disk in which to install the software. This location is also known as EDAHOME. (Default=/home/iadmin/ibi/srv77/home) Please supply location or <Enter>: -------------------------------------------------------------------------- Enter EDAHOME Library Name (max length 9) (Default=SRV77) : --------------------------------------------------------------------------
Supply the location on disk in which to configure the software. This location is also known as EDACONF. (Default=/home/iadmin/ibi/srv77/wfs) Please supply location or <Enter>: --------------------------------------------------------------------------
Supply the location on disk where the product will look for user profiles and the admin.cfg file. This location is also known as EDAPRFU. (Default=/home/iadmin/ibi/profiles) Please supply location or <Enter>: --------------------------------------------------------------------------
Supply the location on disk where the product will look for applications. This location is also known as APPROOT. (Default=/home/iadmin/ibi/apps) Please supply location or <Enter>: --------------------------------------------------------------------------
Enter HTTP Listener Port (HTTP_BASE_PORT). This is the first of four consecutive port numbers that are open and dedicated to the HTTP Listener and other IP based services. (Default=8121) : Enter TCP Listener Port (TCP_BASE_PORT). The TCP Listener Port number must be outside the selected HTTP range (8121 - 8124). (Default=8120) : --------------------------------------------------------------------------
Enter SMTP Mail Server (Optional) : -------------------------------------------------------------------------- The following selections have been made for ... Install Options ... INSTALLATION_DEVICE = I77LIB PRODUCT = server EDAHOME = /home/iadmin/ibi/srv77/home EDAHOMELIB = SRV77 LICENSE = xxx-xxx-xxxx-xx
Configure Options ... EDACONF = /home/iadmin/ibi/srv77/wfs EDAHOME = /home/iadmin/ibi/srv77/home EDAHOMELIB = SRV77 LICENSE = xxx-xxx-xxxx-xx PRODUCT = server EDAPRFU = /home/iadmin/profiles WORKSPACE_MANAGER_NAME = "WebFOCUS 77 Server" APPROOT = /home/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
If you have additional licenses and need to configure an additional product, 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.
Sometimes it is desirable to refresh the software installation directory (EDAHOME) because it has become accidentally damaged, populated with unwanted files, or needs updating with a service pack. To do this:
For example:
CALL I771LIB/ISETUP
This refreshes programming files under the software 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.
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 Installation Program.
Run isetup -? to see full information on the setup and specific use of a parameters file for silent installation, configuration, or refresh.
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:
Is the 12-digit license. Include a hyphen (-) following the third, sixth, and tenth digits.
Is the drive and directory to which you want to install the software.
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. |
Is the base TCP port for the server.
Is the server host name.
Is the name you want to assign to the Windows program folder and service. For example:
-programfolder "WebFOCUS 77 Server"
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:
setup ?
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.
setup -opt /path/srvoptions.txt
where:
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
iWay Software |