In this section: How to: |
Before you can install the server, you must access the server installation software. You can choose to access the installation software using either:
You can run the installation program directly from the CD, or copy the CD contents to disk and run the installation program from disk. The advantage of running the installation from disk is an increase in speed, as well as having a copy of the installation program available on disk for future use.
Even if there is no CD drive on the computer on which you will be installing the server, you can still install using the CD. Simply insert and mount the CD on a computer with a drive, and then copy the installation software from the CD to the computer on which you will be installing the server, as described in How to Insert and Mount the Installation CD.
For instructions, see How to Download the Installation Software Using FTP.
To insert and mount the installation CD:
For Operating System |
Type |
---|---|
HP-UX |
mount -F cdfs device_name /cdrom_directory |
AIX |
mount -r -v cdrfs device_name /cdrom_directory |
Linux (all versions) |
Linux will usually auto mount your CD as /cdrom or /mnt/cdrom. If it is not mounted, you can use: mount device_name /cdrom_directory |
Solaris (without volume management) |
mount -F hsfs -r device_name /cdrom_directory |
Solaris (with volume management) |
A CD is auto mounted as: /cdrom_directory/iWay iWay is the standard volume label for iWay CDs. |
where:
Is the system name for your CD device. Consult your UNIX System Administrator for the name of the device on your platform.
Is the directory to which you will be mounting the CD.
For Solaris Volume Management, this is a static directory.
The CD will be accessible to the ID performing the installation.
File |
Permissions |
---|---|
inu.out |
-rwxr-xr-x |
isetup |
-rwxr-xr-x |
all other files |
-rw-r--r-- |
To run the installation program:
mkdir download_directory
where:
Is the name of the directory to which you will copy the contents of the installation CD.
cp /cdrom/* download_directory
File |
Permissions |
---|---|
inu.out |
-rwxr-xr-x |
isetup |
-rwxr-xr-x |
all other files |
-rw-r--r-- |
cd $HOME
Caution: Do not run the installation procedure from the download directory in which isetup resides, as this will cause errors in the installation process.
After you complete the installation, you can delete the download directory if you wish.
To download the installation software:
The Information Builders Technical Support home page opens.
The Downloads, Upgrades, Service Packs, and PTFs page opens.
The Downloads by Release page for your product opens.
The Software Downloads page for your release opens.
The Software Download Agreement page opens.
The Download Instructions page opens. Select AUTOMATIC or MANUAL and follow the relevant instructions.
A copy of the instructions is also automatically emailed to you for later reference.
Caution: Do not run the installation procedure from the download directory in which isetup resides as this will cause errors in the installation process.
After you complete the installation, you can delete the download directory if you wish.
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 server:
Logging on with the iadmin ID is recommended (rather than with the su command).
umask 022
Ensure that you have write privileges to the directory from which you are running the isetup command. To test this, type:
touch xxxx
For example:
/cdrom/isetup
or
/u/iadmin/download/isetup
You are prompted for your license key.
Your server 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 server 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 then prompted for the location of the installation file iserver.tar.
You are prompted for the password of the server administration ID (iadmin).
The password, which does not display, is stored in encrypted form.
You are now shown the default values of some basic server properties, and given an opportunity to change them.
The properties are:
Parameter |
Description |
---|---|
EDAHOME |
Location of the server executable files. The default location is the iadmin ID home directory. The EDAHOME directory path name must conform to the pattern: */ibi/srv77*/home* For more information about EDAHOME, see Installation and Configuration Directories. |
EDACONF |
Location of the configuration files for this server instance. If you changed the EDAHOME value, the default EDACONF value changes to conform to EDAHOME. EDACONF must be in the same srv77 path as EDAHOME. The lowest-level EDAHOME directory (home) becomes the server type directory in EDACONF. For example, if EDAHOME is /home/iadmin/ibi/srv77/home then EDACONF for a WebFOCUS Reporting Server defaults to: /home/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 server instance must have its own configuration directory. You can append characters to the name of the server_type directory to avoid overwriting the existing directory. For example: /home/iadmin/ibi/srv77/wfs2 For more information about EDACONF, see Installation and Configuration Directories. |
EDAPRFU |
Location of user and group profiles and of admin.cfg, which specifies the server administrator. For more information about EDAPRFU, see Installation and Configuration Directories. |
APPROOT |
Location of the server applications. For more information about APPROOT, see Installation and Configuration Directories. |
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 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.) |
For more information about EDAHOME, EDACONF, EDAPRFU, and APPROOT, see Installation and Configuration Directories.
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.
If you entered N at the default settings prompt, you also have the option of installing the Century Corp demo files in one or more languages. (If you entered Y, they will not be installed.) All other demo files are always installed, automatically, in English.
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 Verifying Server Installation.
This is an example of a Full-Function Server installation that uses the default settings.
$ /cdrom/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 (2 found) ISETUP: License xxx-xxx-xxxx-xx has been accepted ----------------------------------------------------------------------
Please enter the full path name of the media for the product (Default=/cdrom/iserver.tar) Please supply media or <Enter> : ---------------------------------------------------------------------- Enter the Server Administrator (iadmin) Password: xxxxxx ----------------------------------------------------------------------
Please review the default settings. EDAHOME = /home/iadmin/ibi/srv77/home EDACONF = /home/iadmin/ibi/srv77/ffs EDAPRFU = /home/iadmin/profiles APPROOT = /home/iadmin/ibi/apps HTTP_BASE_PORT = 8101 TCP_BASE_PORT = 8100 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
Configure Options ... EDACONF = /home/iadmin/ibi/srv77/ffs EDAHOME = /home/iadmin/ibi/srv77/home 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 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 05/03/2006 15:29:20 Starting Workspace Manager in /home/iadmin/ibi/srv77/ffs 05/03/2006 15:29:20 Logging startup progress and errors in /home/iadmin/ibi/srv77/ffs/edaprint.log 07/03/2006 15:29:20 Opening PTH context 07/03/2006 15:29:21 Checking listeners and services 07/03/2006 15:29:24 TCP started 07/03/2006 15:29:24 HTTP started 07/03/2006 15:29:24 JSCOM3 started 07/03/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
If you have installed from a CD and you have finished accessing the installation CD, you may dismount, remove, and store the CD. All UNIX vendors use the following command to dismount:
umount /cdrom
where:
Is the mount point directory used in the original mount command.
Normally, you will not need the CD again unless you need to reinstall.
If you have additional licenses and need to configure additional server instances:
The prompts for adding a configuration are similar to those for an original installation.
Each server instance must have its own configuration directory. When prompted for the configuration directory, append characters to the default name of the server 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:
/home/iadmin/ibi/srv77/wfs2
If the EDACONF directory you specify already exists, the installation process copies selected files from the current configuration's files 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
/home/iadmin/ibi/srv77/wfs
then the selected configuration files are backed up to:
/home/iadmin/ibi/srv77/BACKUP
Refreshing the server reinstalls the server files in the server installation directory, without changing any configuration information in the configuration directory. However, this does remove any patches that have been applied to the server.
If it becomes necessary to refresh the server, or if you want to upgrade to a new release:
Logging on with the iadmin ID is recommended (rather than with the su command).
umask 022
Ensure that you have write privileges to the directory from which you are running the command. To test this, type:
touch xxxx
/cdrom/isetup
or
/u/iadmin/download/isetup
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, for example, you want to install many servers at once throughout an enterprise. To install a server silently, you first create a text file that specifies your server installation parameters and then call isetup with -opt 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 Installing a Server.
Run isetup -? to display information on the setup and specific use of a parameters file for silent installation and configuration.
iWay Software |