Accessing BIRT Analytics
BIRT Analytics front end, administration, and data loader are available from web applications running on a Windows system.
To access BIRT Analytics front end, double-click the BIRT Analytics icon on a Windows desktop or open a browser manually and enter the following URL:
http://localhost:8114/bafrontend
On Windows, to provide access to BIRT Analytics from another system, use the Windows Firewall advanced settings to open the ports 8114 and 8700 to TCP inbound traffic.
To access BIRT Analytics from another system, open a browser manually and enter a URL similar to the following one, where servername is the name of the machine where you installed BIRT Analytics:
http://servername:8114/bafrontend
For more information about BIRT Analytics, see Using BIRT Analytics.
Managing BIRT Analytics
To access BIRT Analytics administration tools, double-click the BIRT Analytics Administration icon on a Windows desktop or open a browser manually and enter the following URL:
http://localhost:8114/baadmin
On Windows, to provide access to BIRT Analytics administration tools from another system, use the Windows Firewall advanced settings to open the ports 8114 and 8700 to TCP inbound traffic.
To access BIRT Analytics administration tools from another system, open a browser manually and enter a URL similar to the following one, where servername is the name of the machine where you installed BIRT Analytics:
http://servername:8114/baadmin
For more information about BIRT Analytics administration tools, see Administering BIRT Analytics.
Loading BIRT Analytics data
To access BIRT Analytics data loading tools, double-click the QLoader icon on a Windows desktop or open a browser manually and enter the following URL:
http://localhost:8110/qloader
On Windows, to provide access to BIRT Analytics data loading tools from another system, use the Windows Firewall advanced settings to open the port 8110 to TCP inbound traffic.
To access BIRT Analytics administration tools from another system, open a browser manually and enter a URL similar to the following one, where servername is the name of the machine where you installed BIRT Analytics:
http://servername:8110/qloader
For more information about BIRT Analytics administration tools, see Using BIRT Analytics Loader.
Updating the BIRT Analytics licenses
BIRT Analytics uses two licenses, one for the core services and one for the application.
To update the license for the core services, place the new license file in the dubnium folder in the module and restart the core service.
To update the BIRT Analytics application license, use the license updating tool, installed as described in
How to install the BIRT Analytics tools.
How to update the BIRT Analytics core license on Windows
1 In the Windows Start menu, type Services. Choose Services.
2 In Services, right-click Actuate iHub Analytics Core and choose Stop.
3 Using Windows Explorer, navigate to the following folder in the BIRT Analytics installation:
modules\BIRTAnalytics\BACore\dubnium
4 Replace the existing dubnium.lic license file with the that you received from Actuate.
5 In Services, right-click Actuate iHub Analytics Core and choose Start.
How to update the BIRT Analytics core license on Linux
1 Navigate to the following folder in the BIRT Analytics installation:
modules/BIRTAnalytics
2 To stop the core services, execute the following command:
sh ./stopBAcore.sh
The following message appears:
Stopping dubnium...
3 Navigate to the following folder in the BIRT Analytics installation:
modules/BIRTAnalytics/BACore/dubnium
4 Replace the existing dubnium.lic license file with the that you received from Actuate.
5 Navigate back to the following folder in the BIRT Analytics installation:
modules/BIRTAnalytics
6 To start the core services, execute the following command:
sh ./startBAcore.sh
The following message appears:
Starting dubnium...
How to update the BIRT Analytics application license
Use the BIRT Analytics App License Update tool to update the license for the BIRT Analytics application. This tool runs only on Windows.
1 Open the 10-Tools folder and navigate to the subfolder named Tool to change BA license.
2 Decompress the BIRTLicenseUpdate.rar file. The BAAppLicenseUpdate folder appears.
3 Navigate to the BAAppLicenseUpdate folder. Right-click the BAAppLicenseUpdate.exe file and choose Run as administrator. BIRT Analytics App License Update appears.
4 Select BA Application is installed in this server and verify that the correct virtual directory is selected. By default, this is qelectron.
5 In License, choose the ellipsis button to browse for the license file.
6 Select the BIRT Analytics license file and choose Open.
Figure 1‑47 shows the selected license file.
Figure 1‑47 Preparing to update a license key
7 Choose Apply to apply the new license file. Then, on the message indicating a successful license update, choose OK.
8 Close the BIRT Analytics App License Update tool.
Migrating BIRT Analytics data from release 4.2
Prior to BIRT iHub 3, BIRT Analytics stored data in a SQL Server Express database. From BIRT iHub 3, BIRT Analytics stores data in a PostgreSQL database.
Actuate provides a tool to migrate existing BIRT Analytics data from the release 4.2 database to the BIRT iHub 3 database. Do not load new data into BIRT Analytics before migrating existing data. The data migration tool replaces any existing data in the BIRT iHub 3 database.
To install the data migration tool, follow the instructions in
How to install the BIRT Analytics tools. This tool runs only on Windows.
How to migrate the BIRT Analytics data from release 4.2
Use the BA 4.2 to 4.3 Backend DB Migration Tool to migrate the BIRT Analytics release 4.2 data to release BIRT iHub 3.
1 Open the 10-Tools folder and navigate to the subfolder named Tool Migration backend db.
2 Right-click the ba-mssql2psql.exe file and choose Run as administrator. BA 4.2 to BA 4.3 Backend DB Migration Tool appears.
3 In MS SQL Connection Parameters, type the following information:
In Server\instance, type the server and database name of the BIRT Analytics 4.2 FastDB database.
In User ID, type the administrative user name.
In Password, type the administrative user password.
4 In PostgreSQL Connection Parameters, type the following information:
In Server, type the name of server where the BIRT Analytics iHub 3 database component is installed.
In Port, type or select the port used by the BIRT Analytics iHub 3 database. The default port is 5432.
In User ID, type the name of the Postgres database administrator user. The default user name is postgres.
In Password, type the password of the Postgres database administrator user. The default user name is postgres.
The data migration tool looks similar to the one in
Figure 1‑48.
Figure 1‑48 Preparing to migrate data from BIRT Analytics 4.2 to iHub 3
5 To test the connection values for each database, choose Test Connection. If a failure message appears, correct the information.
6 Choose Launch Migration. The progress of the migration appears.
7 Close the BA 4.2 to BA 4.3 Backend DB Migration Tool.
