Open topic with navigation

ibi™ Open Data Hub for Mainframe Connectors 1.0.8

# Running isetup to Install the ibi WebFOCUS Reporting Server Software

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).

## Run isetup Interactively Using the .tar File

For performance reasons, it is always preferable to install on a local disk, however, it is possible to use NFS if the EDAIPC environment variable is used during WebFOCUS Reporting Server run time to point at a local disk location for pipe and fifo creation. For more information on setting EDAIPC, see EDATEMP and NFS-Mounted Disks.

To install the software:

Procedure
1. Sign in using the iadmin user ID.
2. Set the default protection mask to, at a minimum, read/run (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, enter:

       touch xxxx

3. Run the installation procedure, isetup, specifying its full path. You can run the installation procedure from any location. Do not switch the current directory to the location of isetup.

   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.

       ------------------------------------------------------------------------

         ISETUP: Now Installing ibi™ WebFOCUS® 93 Server

       --------------------------------------------------------------------

       Select an option:

             1. Install and Configure

             2. Add Additional Configuration Instance

             3. Refresh Installation (Reinstall, Keep Configurations)

       Enter a selection (Default=1) :

4. Enter 1 for the Install and Configure option.

   You are prompted for the location of the installation file iserver.tar (it defaults to the same directory from which the isetup was run).

       Please enter the full path name of the media for the product

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

   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 WebFOCUS Reporting Server browser interface after installation. For more information, see the ibi™ WebFOCUS® Administration manual.

6. Enter the server administrator ID or accept the default.

   You are prompted for the server administrator password. There is no default.

       Enter the Administrator Password :

7. Type the password of the account that you are using to install the software.

   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 permitted to change them. For example:

       Please review the default settings.

       EDAHOME = /prog3/iadmin/ibi/srv93/home

       EDACONF = /prog3/iadmin/ibi/srv93/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

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

   For information about the EDAHOME, EDACONF, EDAPRFU, and APPROOT environment variables you can set, see Installation and Configuration Directories On UNIX/Linux.

   The other properties that 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 for a WebFOCUS Reporting Server is 8121, which reserves ports 8121-8123.
       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 for 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.

9. Enter the customer ID that you received with your WebFOCUS software and click Next.
10. 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 the server is being installed. You are then asked if you want to start the server.

11. If a server installation, type Y to start the server or N to exit.

    If you start the server, startup messages and the WebFOCUS Reporting Server browser interface URL are now displayed.

Result

Now verify your installation, as described in Verify Installation.

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

ibi™ Open Data Hub for Mainframe Connectors

Copyright © 2021-2025. Cloud Software Group, Inc. All Rights Reserved.