How to: |
Before you can install, you must access the installation software. You can access the installation software using FTP. You download the installation software from the Information Builders FTP site. Downloading the installation software involves:
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. 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.
You should have received a download email with the ftp userid and password, as well as an email with the licensing information.
Download directly to the target machine (or an intermediate machine then a second FTP).
Use binary FTP mode ALWAYS.
If you do not already have a license key, contact Customer Support Services (at (800) 736-6130 or (212) 736-6130) before attempting install in order to obtain a product key and a hostid key. The hostid of the machine on which the product will be installed will be needed to generate the hostid key. To obtain the hostid, enter the following UNIX command:
hostid
Download the Files
If you do not already have one, create a directory to hold the files that will be downloaded by the ftp process.
FTP the tar file.
ftp downloadftp.ibi.com
Supply the user ID and password information. Note that the user ID, password, paths, and file names are all case sensitive.
If you did not start the ftp session from the directory that you created to hold the downloaded files, issue the following commands.
lcd download cd "/FOCUS/77/Solaris_9_and_up_Sparc_32on64bit/7706M/871"
Note that the directory path is specified in the download email and may be different from the one used in this example. The tar file name also may be different, depending on the FOCUS version and gen.
binary get i7706M_871.tar quit
Untar the downloaded tar file.
tar -voxf i7706M_871.tar
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:
Logging on with the iadmin ID is recommended (rather than with the su command).
For example:
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:
/u/iadmin/download/isetup
You are prompted for your license key (600-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. The license key for FOCUS for Distributed Systems will begin with a 6.
You are then prompted for your license hostid key.
You are then prompted for the location of the installation file iserver.tar.
You are now shown the default values of some basic properties, and given an opportunity to change them.
Note: If you are installing FOCUS for Distributed Systems on a box that is also running WebFOCUS, you will need to enter a unique port number for the FOCUS SU instance to avoid conflict with WebFOCUS. To change the default port number, enter N.
The default environment variables that you can change are:
Parameter |
Description |
---|---|
EDAHOME |
Location of the FOCUS 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 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 product type directory in EDACONF. For example, if EDAHOME is /home/iadmin/ibi/srv77/home then EDACONF for a FOCUS defaults to: /home/iadmin/ibi/srv77/foc If you are configuring FOCUS for Distributed Systems on a machine that already has a Reporting Server installed, 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: /home/iadmin/ibi/srv77/wfs2 For more information about EDACONF, see Installation and Configuration Directories. |
EDAPRFU |
Location of user and group profiles. For more information about EDAPRFU, see Installation and Configuration Directories. |
APPROOT |
Location of FOCUS applications. For more information about APPROOT, see Installation and Configuration Directories. |
PORT_FOCUSSU |
Is the port number for the FOCUS SU instance. The default value is 8102. Note: If you are installing FOCUS for Distributed Systems on a machine that is also running WebFOCUS, you will need to enter a unique port number for the FOCUS SU instance to avoid conflict with WebFOCUS. To change the default port number, enter N. |
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 for each of the above variables, and given another chance to accept the default.
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 FOCUS is being installed.
You should now verify your installation, as described in Verifying Installation.
This is an example of a FOCUS for Distributed Systems installation that uses the default settings.
Run the isetup procedure:
$ /home/iadmin/download/isetup
The initial isetup screen opens. Enter 1 to install and configure:
--------------------------------------------------------------------- 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
Next enter your license key and hostid key:
--------------------------------------------------------------------- Enter your License Key (Current number of CPUs = 1) (Format 999-999-9999-99) : 600-xxx-xxxx-xx License Key has been checked Product: FOCUS Maximum Number of Adapters: 1 Maximum Number of Users: Unlimited Maximum Number of CPUs: 2 (1 found) Enter your License Hostid Key : xxxxxxxxxxxxxxxx ISETUP: License Hostid Key xxxxxxxxxxxxxxxx has been accepted
To accept the default location of the tar file, press the Enter key:
--------------------------------------------------------------------- Please enter the full path name of the media for the product (Default=/home/iadmin/download/iserver.tar) Please supply media or <Enter> :
Review the default settings and indicate whether you want to accept them (y), change them (n), or exit the procedure (q):
--------------------------------------------------------------------- Please review the default settings. EDAHOME = /home/iadmin/ibi/srv77/home EDACONF = /home/iadmin/ibi/srv77/foc EDAPRFU = /home/iadmin/ibi/profiles APPROOT = /home/iadmin/ibi/apps PORT_FOCUSSU = 8102 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 = /home/iadmin/download/iserver.tar PRODUCT = focus EDAHOME = /home/iadmin/ibi/srv77/home LICENSE = 600-xxx-xxxx-xx Configure Options ... EDACONF = /home/iadmin/ibi/srv77/foc EDAHOME = /home/iadmin/ibi/srv77/home LICENSE = 600-xxx-xxxx-xx PRODUCT = focus LICENSE_HOSTID = xxxxxxxxxxxxxxxx EDAPRFU = /home/iadmin/ibi/profiles HOMEAPPS = /home/iadmin/ibi/homeapps WORKSPACE_MANAGER_NAME = "iWay 77 FOCUS" APPROOT = /home/iadmin/ibi/apps PORT_FOCUSSU = 8102 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 ---------------------------------------------------------------------
|
Information Builders |