Installing FOCUS

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:

  1. Registering at the Information Builders FTP site.
  2. Downloading the installation software from the site.
  3. Unzipping the downloaded file.
  4. Running the isetup procedure to begin installing.
Top of page
x
Procedure: How to Download the Installation Software Using FTP

To download the installation software:

  1. Go to http://techsupport.informationbuilders.com.

    The Information Builders Technical Support home page opens.

  2. Click My Downloads in the My Account section on the right side of the page.

    The Downloads, Upgrades, Service Packs, and PTFs page opens.

  3. Click the link for your product (for example, FOCUS).

    The Downloads by Release page for your product opens.

  4. Click your release from the Current Production Releases list.

    The Software Downloads page for your release opens.

  5. Scroll down and find the platform on which you want to install the software, and then click Download to the right of the platform name.
  6. Fill in the registration form and then click Continue.

    The Software Download Agreement page opens.

  7. Select I agree to consent to the Download Agreement, and then click Continue.

    The Download Instructions page opens. Follow the relevant instructions.

    A copy of the instructions is also automatically emailed to you for later reference.

  8. Follow the instructions on the Download Page.
  9. Run the installation procedure as described in Installing FOCUS.

    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.

Example: Sample FTP Download Session

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
Top of page
x
Procedure: How to Install FOCUS

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:

  1. Log on using the iadmin user ID.

    Logging on with the iadmin ID is recommended (rather than with the su command).

  2. Set the default protection mask to, at a minimum, read/execute (if it is not already set to that).

    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
  3. Run the installation procedure, isetup, specifying its full path (including the disk location). You can run the installation procedure from any location. Do not switch the current directory to the location of isetup.

    For example:

    /u/iadmin/download/isetup
  4. Type 1 for the Install and Configure option.

    You are prompted for your license key (600-xxx-xxxx-xx).

  5. Type your license key.

    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.

  6. Type your license hostid key.

    You are then prompted for the location of the installation file iserver.tar.

  7. Type the full path name of iserver.tar, or press the Enter key to accept the default.

    You are now shown the default values of some basic properties, and given an opportunity to change them.

  8. If you want to accept the default values, type Y and skip to Step 9. Otherwise, change any properties that you wish.

    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.
Example: Example: FOCUS for Distributed Systems Installation Prompts and Responses

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