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, see the Migration manual.
Before running the installation utility, do the following:
netstat -a | grep 8120
If you receive no response, then port 8120 is not in use by a running process. Check for all four ports. If you receive a response like the following, the port is in use by another process:
tcp 0 0 *:8120 *:* LISTEN
Note: When installing multiple instances of the server, be sure each instance has unique ports.
export JDK_HOME=/usr/j2sdk1.6_17
The server uses this variable to find certain native files in Java JRE directories. It needs these file 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 Java JDK 1.6 or higher is not installed on your system, installing one is recommended.
How to: |
The server can be installed in two ways:
tar xvf filename.tar
Warning: Do not install or untar in a directory that has spaces in its name.
ls -l
All files should be lowercase. The isetup and inu.out files should be executable. For example:
-r-xr-xr-x 1 wf77 wf77 1402297 Jan 22 10:47 inu.out -r-xr-xr-x 1 wf77 wf77 166574080 Jan 22 10:47 iserver.tar -r-xr-xr-x 1 wf77 wf77 505818 Jan 22 10:47 isetup -r-xr-xr-x 1 wf77 wf77 268 Jan 22 10:47 version.cfg
Note: If you are not installing from CD, you can make the files executable by entering:
chmod 755 isetup inu.out
whoami
or
who am i
Do not install the server as root.
umask 022
/cdrom/isetup
where:
Is the mount point of your CD.
The following prompt displays:
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
The License Key prompt displays:
Enter your License Key (Format 999-999-9999-99) :
The License is printed on the packing slip, which is included in your WebFOCUS shipment. Be sure to type it using the format:
nnn-nnn-nnnn-nn
or
nnn-nnn-nnnn
The license information is displayed, and you are prompted for the iserver.tar file.
Please enter the full path name of the media for the product.
/cdrom/iserver.tar
The Server Admin Password prompt displays:
Enter the Server Administrator (current_account) Password:
The default settings display:
Please review the default settings. EDAHOME = /install_directory/ibi/srv81/home EDACONF = /install_directory/ibi/srv81/wfs EDAPRFU = /install_directory/ibi/profiles APPROOT = /install_directory/ibi/apps HTTP_BASE_PORT = 8121 TCP_BASE_PORT = 8120 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) :
If the settings are correct and you reply Y, the installation begins. When prompted to start the server, select N and proceed to How to Enable Security.
If you type N, the EDAHOME prompt displays:
Supply the location on the disk in which to install the software.
This location is also known as EDAHOME.
(Default=/install_directory/ibi/srv81/home)
Please supply the location or <Enter>:
The EDACONF prompt displays:
Supply the location on the disk in which to configure the software.
This location is also known as EDACONF.
(Default=/install_directory/ibi/srv81/wfs)
Please supply the location or <Enter>:
The EDAPRFU prompt displays:
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=/install_directory/ibi/profiles)
Please supply location or <Enter>:
The APPROOT prompt displays:
Supply the location on the disk where the product will look for
applications. This location is also known as APPROOT.
(Default=/install_directory/ibi/apps)
Please supply the location or <Enter>:
The Demo Files prompt displays:
Would you like to install New Century Demo files (Y/N Default=Y)? :
The HTTP Listener Port prompt displays:
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) :
The TCP Listener Port prompt displays:
Enter TCP Listener Port (TCP_BASE_PORT). The TCP Listener Port number must be outside the selected HTTP range (8121 - 8123). (Default=8120) :
The SMTP Mail Server (Optional) prompt displays:
Enter SMTP Mail Server (Optional) :
Type the name of the SMTP Mail Server. This is optional.
A summary screen displays your installation settings and you are prompted to confirm them:
Please confirm these values with one of the following responses ... Y = Accept and Proceed N = Start Over Q = Quit
When the utility completes, the following displays:
ISETUP: Configuration Step completed ------------------------------------------------------------- Would you like to start the Server Workspace (Y/N Default=Y)?:
If you receive the following error, you can ignore it:
inu: There was an error in opening the file
/install_directory/ibi/srv81/home/etc/version.cfg
To enable the server to start with security OPSYS, you must perform the following procedure. When the server runs with security OPSYS, users are authenticated against the operating system. After performing this procedure, you can still run the server with security OFF or PTH, but security OPSYS is not available until you perform these steps.
For a description of security levels, see Security and User IDs for WebFOCUS and ReportCaster.
/install_directory/ibi/srv81/home/bin
chown root tscom300.out chmod 4555 tscom300.out
ls -l tscom300.out
The output should be similar to:
-r-sr-xr-x 1 root iadmin 750687 Jan 16 17:05 tscom300.out
Note the permissions and ownerships. The size may vary.
WebFOCUS |