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.
Both use a .tar-formatted archive file. The isetup program is also used to later do software refreshes and to add configurations (interactively or silently).
Additionally, some Linux platforms have .rpm-formatted archive files available for doing an RPM type of installation and configuration with default values (which can be used in conjunction with the isetup silent installation feature for specific option values, when the option parameters are saved in the file /tmp/ibi.opt.)
For performance reasons, the software should not be installed on, or accessed using NFS-mounted disks. A directly connected disk is always preferable.
To install the software:
umask 022
Ensure that you have write privileges to the directory from which you are running the isetup command. To test this, enter:
touch xxxx
For example, if you downloaded the installation software to a directory named download under the iadmin home directory:
/u/iadmin/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) :
You are prompted for the location of the installation file iserver.tar
Please enter the full path name of the media for the product
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
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. For more information, see Limiting CPU Use on Machines With Multiple CPUs.
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.
You are prompted for the server administrator password. There is no default.
Enter the Administrator Password :
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
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:
|
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.
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 How to Verify Server Installation.
WebFOCUS | |
Feedback |