Installing the WebFOCUS Reporting Server

In this section:

The WebFOCUS Reporting Server is installed through an installation utility that prompts you for parameters. The utility installs components that provide data access, translation, computation, formatting, and other back-end processes.

The WebFOCUS Reporting Server should be installed before WebFOCUS Client. If you are updating a previous release of WebFOCUS and wish to migrate your reports and settings, migration will be explained in Migrating Data and Settings.


Top of page

x
Preliminary Installation Instructions

Before running the installation utility, do the following:

  1. Review the installation requirements in WebFOCUS and ReportCaster Installation Requirements.
  2. If none exist, create a user ID and a group for the WebFOCUS Reporting Server. The name iadmin is used in server documentation to refer to this user and group. For user ID requirements, see WebFOCUS and ReportCaster Installation Requirements.
  3. Ensure that four consecutive TCP/IP ports are available for the server. The port numbers should be unique and greater than 1024. By default, WebFOCUS uses ports 8120 through 8123. Type the following command at the IBM i command line to display active TCP/IP port numbers:
    NETSTAT

    You can sort the list of port numbers that are returned by pressing F14.

  4. If a Java Runtime Environment (JRE) is installed on your system, set a $JAVA_HOME environment variable to its installation directory. You can set this in the .profile of the user ID that will start and run the WebFOCUS Reporting Server. For example:
    export JAVA_HOME=/QOpenSys/QIBM/ProdData/JavaVM/jdk60/32bit

    The server uses this variable to find certain native files in JRE directories. It needs these files to run its JSCOM3 listener. The server uses JSCOM3 when it creates graphics, accesses data sources through JDBC, or launches other Java processes. Not all WebFOCUS processing requires JSCOM3. However, it is a good idea to enable it. If JRE 1.6 or higher is not installed on your system, installing one is recommended.


Top of page

x
Server Installation Steps

The server can be installed in two ways:

For more information on running a text-based or silent version of the WebFOCUS Reporting Server installation, see the Server Installation for IBM i chapter in the WebFOCUS Reporting Server Installation manual.


Top of page

x
WebFOCUS Reporting Server Installation

How to:

Installation and initial configuration steps are provided in the Server Installation for IBM i chapter in the WebFOCUS Reporting Server Installation manual. The license key you enter during server installation determines whether a WebFOCUS Reporting Server or a Full-Function Server is installed. You should perform the same configuration steps described for a Full-Function Server on machines containing the source data needed for WebFOCUS reports.

See the Server Installation for IBM i chapter in the WebFOCUS Reporting Server Installation manual on how to access the installation software and for detailed information on any of the prompted parameters. To exit from the installation program at any time, type QUIT.



x
Procedure: How to Run the WebFOCUS Reporting Server Installation

To run the WebFOCUS Reporting Server installation:

  1. Log on with the iadmin user ID.

    Note: Do not install the server as security officer.

  2. On the IBM i command line, call the installation procedure. For example:
    CALL instLibName/ISETUP

    where:

    instLibName

    Is the name of the installation library that you downloaded. The default name is I77LIB.

  3. Select the initial code page, or press Enter to accept the default value.

    Note: Most installation procedure prompts will allow you to press Enter to accept the default.

  4. Enter the installation option 1 (Install and Configure).

    You are prompted for your license key.

  5. Enter your 10 or 12 digit license key. You can find it on your shipping manifest.

    You are prompted for the name of the installation media library.

  6. Enter the name of the installation library that you downloaded, or restored from DVD. The default name is I77LIB.

    You are prompted for the password of the server administrator ID (iadmin).

  7. Enter the server administrator password.

    You are prompted for the server system ID (iserver).

  8. Enter the server system ID.

    You are prompted to review the default values of the remaining installation parameters.

  9. To accept all the default values, type Y and skip to step 11. Otherwise, to change any values, continue to step 10.

    The default values are:

    • EDAHOME = /home/iadmin/ibi/srv77/home
    • EDAHOMELIB = srv77
    • EDACONF = /home/iadmin/ibi/srv77/wfs
    • EDAPRFU = /home/iadmin/ibi/profiles
    • APPROOT = /home/iadmin/ibi/apps
    • HTTP_BASE_PORT = 8121
    • TCP_BASE_PORT = 8120

    Note: By default, the Century Corp demo files are not installed. If you want to install the demo files, do not type Y. Instead, continue to step 10, where you will have the option of installing the demo files in one or more languages. Note that all other demo files are installed automatically, in English, as part of the standard installation.

  10. Type N to be prompted individually for each installation parameter. For each parameter, you will be given the choice of accepting the default value or changing the value.
  11. Enter an absolute path for EDAHOME:
    Supply the location on disk in which to install the software. This location is also known as EDAHOME.

    Note: The EDAHOME directory path name directory path name must conform to the pattern *ibi/srv77*/home* and must be an absolute path.

  12. Enter a value for EDAHOME LIBRARY:
    EDAHOME Library Name (max length 9)
    (Default=srv77)

    Note: This is the QSYS library location for programs.

  13. Enter an absolute path for EDACONF:
    Supply the location on disk in which to configure the software. This location is also known as EDACONF.
    (Default=/home/iadmin/ibi/srv77/wfs)

    Note: This is the location for the default configuration. EDACONF must be in the same srv77 path as EDAHOME. The lowest level EDAHOME directory (home) becomes the server type directory in EDACONF.

  14. Enter an absolute path for EDAPRFU:
    Supply the location on disk where the product will look for user profiles and the admin.cfg file. This location is also known as EDAPRFU.
    (Default=/home/iadmin/ibi/profiles)
  15. Enter an absolute path for APPROOT:
    Supply the location on disk where the product will look for applications. This location is also known as APPROOT.
    (Default=/home/iadmin/ibi/apps)
  16. Type Y or N for:
    Demo Files:
    Would you like to install New Century Demo files (Y/N Default=Y)?
  17. Enter a value for the HTTP Listener Port:
    Enter HTTP Listener Port (HTTP_BASE_PORT). This is the first of three consecutive port numbers that are open and dedicated to the HTTP Listener and other IP based services.
    (Default=8121)
  18. Enter a value for the TCP Listener Port:
    Enter TCP Listener Port (TCP_BASE_PORT). The TCP Listener Port number must be outside the selected HTTP range (8121 - 8123).
  19. Review the configuration options displayed on the screen, and type Y if you accept them. Alternatively, to start over, type N. To quit the installation procedure, type Q.

    Several progress messages display while the server is being installed.

  20. When the installation is complete, you are then asked if you want to start the server:
    Would you like to start the Server Workspace (Y/N Default=Y)?
  21. Type N.

Top of page

x
Enabling Security

How to:

To run a server in OPSYS security mode in IBM i, you must satisfy the requirements that are described in this section. This must be performed whenever the server is installed or reinstalled with fixes. Certain files must be owned and run under the QSECOFR profile or a QSECOFR-authorized ID (such as iserver) that allows impersonation for the OPSYS security mode. Running with OPSYS security mode requires you to send a password to connect with the server, or to use some other form of verification. Although general installation of the server software is handled by iadmin (an ordinary user ID), this step requires QSECOFR authority. To change ownerships, perform the following steps:



x
Procedure: How to Enable Security

To enable security:

  1. Log on as QSECOFR.
  2. Using the library specified during the installation, change the file ownership by entering the following commands:
    CHGOBJ OBJ(SRV77/TSCOM300) USRPRF(*OWNER)
    CHGOBJOWN OBJ(SRV77/TSCOM300) OBJTYPE(*PGM) NEWOWN(QSECOFR)
  3. Log off as QSECOFR.

    For more information, see the Server Installation for IBM i chapter in the WebFOCUS Reporting Server Installation manual.


WebFOCUS