Topics: |
Topics: |
This topic provides the step-by-step instructions that you need to install WebFOCUS Business User Edition (BUE).
You can begin using WebFOCUS BUE immediately after you install the product. No additional configuration steps are required.
Topics: |
To install WebFOCUS BUE, you must have administrator privileges. Additionally, your machine must meet the system requirements that are defined in the Hardware and Software Requirements topics.
Note: The Windows 10 Anniversary upgrade Version 1607 (OS Build 14398.82) is not supported. This version causes Hyperstage to become unstable and disconnect.
Note: Accessibility Compliance is not supported at this time.
How to: |
This section describes how to install WebFOCUS BUE.
Note: Java Version 8 Update 102 (8u102) and Tomcat 8.0.36 are included with the WebFOCUS BUE product installation.
The InstallAnywhere installation program opens, as shown in the following image.
The list of languages depends on the regional language settings of the Windows Operating System where WebFOCUS BUE is being installed.
Note: The language selected will be the language used during the installation program. This language is also used to set the code page of the Reporting Server, which is responsible for data access.
If your data sources are in a different language, you will have to change the code page of the Reporting Server.
The Welcome window opens.
The License Agreement window opens.
The License Code window opens, as shown in the following image.
The Setup Preferences window opens, as shown in the following image.
Note: Passwords must be between 4 and 20 characters and cannot include double quotation marks (") or a percent sign (%). Leading blanks and trailing blanks will be removed.
Note: Google may block sign-in attempts when delivering reports through WebFOCUS BUE. To allow WebFOCUS BUE to connect to the Google email account that was configured for email distribution, sign in to the Google account, navigate to My Account settings, select Sign-In & security, and turn the Allow less secure apps option On.
For more information, see:
If you do not select this option, you can manually start and stop the WebFOCUS BUE services from the shortcut options found in the WebFOCUS Business User Edition 82 group, or through the Windows services program.
The Pre-Installation summary window opens.
Note: If you selected the Advanced Configuration check box, the following window opens.
Server applications can be created in the default location or in a new location outside of the drive:\ibi\WebFOCUS_BUE82\ folder. Select the location of your applications and then click Next.
The Sign In page opens, as shown in the following image.
How to: |
You should refer to this topic if you did not select the Configure WebFOCUS BUE services to start automatically after a reboot check box during the installation program.
The installation program installs the following services:
Note: If you are updating an earlier release of WebFOCUS BUE, you must manually stop all WebFOCUS BUE services before beginning the installation program. For more information, see Running WebFOCUS Business User Edition Services Manually.
To view the status of these services, launch your Windows Services program from the Control Panel, and click the Standard tab. The following image highlights the WebFOCUS BUE services as they appear in the Windows Services program.
Display name |
Service Name |
---|---|
WebFOCUS BUE 82 Application Server |
WfBUE82AppSrv |
WebFOCUS BUE 82 Distribution Server |
WfBUE82DistSrv |
WebFOCUS BUE 82 Reporting Server |
WebFOCUS BUE 82 Reporting Server |
WebFOCUS BUE 82 Repository Server |
WfBUE82DbSrv |
From the Start menu, navigate to the WebFOCUS Business User Edition shortcut, under the Information Builders program group.
How to: |
If you want to remove an existing WebFOCUS BUE installation and want to perform a full installation of a newer release, you can run the uninstall program.
Note: Before you uninstall WebFOCUS BUE, it is recommended that you save the cleanup utility to a different location on your machine in case the uninstall fails and you need to manually uninstall any components. For more information, see Troubleshooting WebFOCUS Business User Edition.
The following steps can be performed if you want to preserve your data and perform a new installation, if you need to move your data to another location, or if an upgrade installation fails and you need to perform a new full installation.
By default, these are located in the following folders:
The InstallAnywhere installation program opens.
Note: If the uninstall program is not visible from the Windows Start menu, uninstall the software using the Programs and Features option on the Control Panel. Alternatively, create a shortcut to C:\ProgramData\Microsoft\Windows\Start Menu\Programs. This will open Windows Explorer with a classic view of all installed programs. You can use this to navigate to WebFOCUS Business User Edition 82 in the Information Builders folder, and then run the uninstall program.
The installation program begins and uninstalls the WebFOCUS BUE components.
Topics: |
If you are unable to launch WebFOCUS BUE, ensure that all services are running. If they are not, do the following:
If this does not work, stop the services again. Before you restart the services, ensure that the Hyperstage processes, ibengine.exe and postgres.exe, are also stopped. Restart your machine if you are still unable to restart the services.
By default, ports in the range of 26000 to 26040 are checked for availability. If the installation program detects that no ports in that range are available, it then increases the range by 10 and checks again for availability. For example, if ports 26000 to 26040 are unavailable, ports 26010 to 26050 are then checked.
Default Port Assignment.
WebFOCUS BUE creates a log file in the following location for Windows 7:
drive:\Users\user_id\WebFOCUS_BUE82_Install_date_time.log
where:
Is your Windows user ID.
Is the date and time the log file was created. This log file provides information about the WebFOCUS BUE installation. If you contact Customer Support Services with an installation problem, have this file available.
How to: |
If you choose to uninstall WebFOCUS BUE, and the uninstall process fails, you can follow one of the procedures in this section to clean up your machine before reinstalling the product.
Before performing one of the following procedures, ensure that you have uninstalled WebFOCUS BUE, as described in Uninstalling WebFOCUS Business User Edition.
If the WebFOCUS BUE uninstall process fails, you can run the wf_cleanup.bat file to clean a damaged installation on your machine.
drive:\ibi\WebFOCUS_BUE82\WebFOCUS\utilities\install\
Note: By default, the utility will back up the Reporting Server apps, data, and the Derby database.
If the WebFOCUS BUE uninstall process fails, you can do the following to manually cleanup the remaining WebFOCUS BUE components on your machine.
sc delete "service name"
where:
Is the name of the service you are manually deleting. For example:
C:\sc delete "WfBUE82AppSrv"
Note: The service name must be enclosed in double quotation marks (").
Repeat this for the remaining services.
For example, if WebFOCUS BUE is installed on the C:\ drive, remove all folders under C:\ibi\WebFOCUS_BUE82\, except for the following folders:
The following topic describes how to install WebFOCUS Business User Edition (BUE) on a Linux environment. WebFOCUS Business User Edition (BUE) is supported on:
Note: Java Version 8 Update 102 (8u102) and Tomcat 8.0.36 are included with the WebFOCUS BUE product installation.
Note: Java Version 8 Update 102 (8u102) and Tomcat 8.0.36 are included with the WebFOCUS BUE product installation.
Note: Java Version 8 Update 101 (8u101) and Tomcat 8.0.36 are included with the WebFOCUS BUE product installation.
Topics: |
The following section describes the system requirements for installing WebFOCUS BUE on a Linux environment.
Note: Only one installation per platform is supported.
The following are installation prerequisites for installing WebFOCUS BUE on Linux:
The installation cannot proceed under the root user account and will terminate. Restart the installation as a non-root user.
Invalid unzip command found.
This is generated by the installation program and does not prevent the installation from proceeding and completing successfully.
If the temp directory on the host does not meet the minimum size requirements, the InstallAnywhere environment variable IATEMPDIR can be set to use an alternate directory.
You may specify an alternate /tmp location by setting the following environment variable:
IATEMPDIR=/large_tmp export IATEMPDIR
The operating system provides ways of limiting the amount of resources that can be used. These limits can affect the installation process.
Use the ulimit command to set process memory-related resource limits for your session.
The WebFOCUS BUE installation program requires ulimit to be set to 8192.
Limits can be hard or soft. Hard limits are set by the root user. Only the root user can increase hard limits, although other users can decrease them. Soft limits can be set and changed by other users, but they cannot exceed the hard limits. To view the current limits, enter the following command:
ulimit -a
Use the /etc/security/limits.conf file to store ulimit settings. Changes to this file should be made by a system administrator.
How to: |
The following section describes how to install WebFOCUS BUE using Console Mode.
chmod u+x installWebFOCUSBUE8201.bin
./installWebFOCUSBUE8201.bin -i console
The Welcome to WebFOCUS Business User Edition 82 prompt displays.
The License Agreement prompt displays.
The Choose Install Type prompt displays.
The License Code prompt displays.
This code was sent to you as part of the email message that contained the download link for the software.
You are prompted to enter the site code.
This code was sent to you as part of the email message that contained the download link for the software.
The Setup Preferences prompt displays.
Note: Spaces are not allowed in the destination path.
You are prompted to enter the WebFOCUS BUE Administration credentials.
The Advanced Configuration prompt displays. Type Y and press Enter if you want to change the default directory location of the WebFOCUS BUE Reporting Server application. Type N and press Enter if you want to use the default directory location of the WebFOCUS BUE Reporting Server.
If you chose to use the default WebFOCUS BUE Reporting Server directory, the Pre-Installation Summary prompt displays.
The installation begins.
During installation, the activity window indicates which installation program tasks are being performed.
When installation is complete, a summary is provided displaying the servers that were installed and the ports that have been assigned.
For UNIX installations, the default Tomcat Java memory configuration is set to use an initial Java heap size of 256MB and a maximum Java heap size of 512MB.
These settings are in located in the /ibi/WebFOCUS_BUE82/tomcat/bin/catalina.sh file. For example:
JAVA_OPTS="-XX:MaxPermSize=256m -Xms256m -Xmx512m -Djava.awt.headless=true"
For better product performance, it is recommended to increase these values. The initial Java heap size should be at least 1024MB (1GB). The size is normally set in Megabytes. For example:
-Xms1024m -Xmx2048m
These values need to be set based on the physical memory of the machine.
It is recommended to set the minimum/initial memory value to one eighth (1/8) of the physical memory. The maximum value needs to be one quarter (1/4) of the physical memory.
To launch WebFOCUS BUE, type the following:
http://host:port/ibi_apps/
Note: Enter the application server port number when using this command to start WebFOCUS BUE. The application server port number is the lowest port number displayed in the summary at the end of the WebFOCUS BUE installation.
The default port for the WebFOCUS BUE application server is 26000. It is listed during the end of the installation and also available in the installation log file.
Installation log files are under the user home directory. An example of an installation log file is shown in the example below:
/$HOME/WebFOCUS_BUE82_Install_date_time.log
where:
Is the date and time the log file was created. This log file provides information about the WebFOCUS BUE installation. If you contact Customer Support Services with an installation problem, have this file available.
The following commands are used to manually start and stop the required WebFOCUS BUE servers.
Note: The double periods (..) before each of the entries below indicates that the full path of the items below should be entered.
Repository Server
To start the WebFOCUS BUE Repository Server, run:
nohup ../ibi/WebFOCUS_BUE82/derby/bin/start.sh &
To stop the WebFOCUS BUE Repository Server, run:
../ibi/WebFOCUS_BUE82/derby/bin/stop.sh
Reporting Server
To start the WebFOCUS BUE Reporting Server, run:
../ibi/WebFOCUS_BUE82/srv/wfs/bin/edastart -start
To stop the WebFOCUS BUE Reporting Server, run:
../ibi/WebFOCUS_BUE82/srv/wfs/bin/edastart -stop
Application Server
To start the WebFOCUS BUE Application Server, run:
../ibi/WebFOCUS_BUE82/tomcat/bin/startup.sh
To stop the WebFOCUS BUE Application Server, run:
../ibi/WebFOCUS_BUE82/tomcat/bin/shutdown.sh
Distribution Server
To start the WebFOCUS BUE Distribution Server, navigate to the ../ibi/WebFOCUS_BUE82/WebFOCUS/ReportCaster/bin directory and run:
nohup ./schbkr &
To stop the WebFOCUS BUE Distribution Server, navigate to the ../ibi/WebFOCUS_BUE82/WebFOCUS/ReportCaster/bin directory and run:
./stopit
How to: |
You can update an earlier release of WebFOCUS BUE using the following steps.
Note: If the ports are busy, run a command, such as lsof, to identify what processes are still running, and stop those processes. Before you proceed, you must rerun the netstat command.
chmod u+x installWebFOCUSBUE8201.bin
The License Agreement prompt displays.
./installWebFOCUSBUE8201.bin -i console
The Welcome to WebFOCUS Business User Edition prompt displays.
The Choose Install Type prompt displays.
The installation begins.
During installation, the activity window indicates which installation program tasks are being performed.
chmod -R 0700 ../ibi/WebFOCUS_BUE82/srv/wfs/hs/pg_data
To uninstall WebFOCUS BUE, run the uninstall program using the following command:
../ibi/WebFOCUS_BUE82/Uninstall/Uninstall
How to: |
An email server is required for email distribution and notifications. The following procedures provide the steps for configuring the supported mail servers.
or
From the BUE Portal Menu bar, click Tools, then click ReportCaster Status.
In addition, if your mail server uses a secure connection or requires authentication, select the appropriate options and type the required credentials. You need to save your configuration changes and restart ReportCaster to make the changes effective.
If you use Google as your email server, see How to Configure Google as Your Email Server.
If you use Yahoo as your email server, see How to Configure Yahoo as Your Email Server.
WebFOCUS | |
Feedback |