Skip to content
CA Service Operations Insight - 4.0 CU1, SP2
Documentation powered by DocOps

Install CABI (JasperReports Server)

Last update November 11, 2016

Contents

As an administrator, you install CA Business Intelligence (CABI) to provide reporting capabilities. Starting this version, CABI is packaged with TIBCO JasperReports Server. If you have not installed previous version of CABI reporting solution, install SOI Reports with CABI JasperReports Server to run and view reports. You need to perform extra configuration for reports to function correctly. The following diagram shows how to work in CABI JasperReports Server.

Working with CABI JasperReports Server

Understand the System Allocation

SOI Reports and CA Business Intelligence JaspertReports Server must reside on a standalone system. The system that hosts CABI JasperReports is to have a minimum of 10 GB hard disk space with a 8 GB memory.(Please refer this  link for more information about Minimum Hardware Requirements.) You can install SOI Reports with or without CABI JasperReports Server. If you plan to install only SOI Reports, install CA Business Intelligence JasperReports Server r6.1.0 on a dedicated system before you install SOI Reports. 

SOI-Jasper System Allocation

Installation Methods

There are two methods to install CABI JasperReports Server and SOI Reports:

  • Install along with SOI Reports using the SOI Reports installer.
  • Install CABI JasperReports Server r6.1.0 by following the procedure provided here. Then, install SOI Reports and configure to it.

SOI Reports installer supports only Microsoft SQL Server database. So, if you are using Microsoft SQL Server database and you want to install CABI JasperReports Server, use the SOI Reports installer. If you are using the MySQL or PostgreSQL database, follow the installation procedure provided in the CABI JasperReports Server document.

Install SOI Reports with or without CABI JasperReports Server

SOI Reports include scheduled and predefined reports. You can enable CA SOI reporting by importing the SOI Reports into CA Business Intelligence JasperReports Server. You can install SOI Reports and CABI JasperReports Server together or individually.

Note: If you plan to install CABI JasperReports Server separately, click  here to see the procedure. Remember, SOI Reports supports CA Business Intelligence JasperReports Server r6.1.0.

Check the default values in Installation Worksheet for CA Business Intelligence JasperReports Server.

Prerequisite:

  • If you are installing SOI Reports in a system with Windows server 2012, confirm that the Windows Application Compatibility mode is on.
  • Confirm you are installing CABI JasperReports Server and the CA SOI reports on a dedicated server with no other CA SOI components.

Follow these steps:

  1. Run soi-reports.exe from the Reports folder of the installation kit.
  2. Click Next in the Introduction page.
  3. Accept the license agreement and click Next.
    The Choose Install Folder screen opens.

    Note: If CA SOI components are already installed on the system, the Choose Install Folder page does not appear. Any new CA SOI components that you install are installed to the existing CA SOI folder, because all components must reside in the same folder.
  4. Accept, enter, or choose the installation folder.

    Note: The maximum installation path length is 30 characters. If the installation path length is more than 30 characters, you cannot proceed further.
  5. Select one of the following options to specify how would you like to install SOI Reports and click Next:

    • With CABI JasperReports Server: Indicates both SOI Reports and CABI JasperReports Server are installed. Select this option if you have not installed CABI JasperReports Server and you want to install both SOI Reports and CABI JasperReports Server now. On selecting this option, JDK 1.8 and Tomcat 7.0.68 will also be installed. If you select this option, proceed to Step 6.

    • Without CABI JasperReports Server: Indicates only SOI Reports is installed. Select this option only if you have already installed CABI JasperReports Server. If you have not installed CABI JasperReports Server and to install now, click here to see the CABI JasperReports Server installation, uninstallation, and post-installation verification steps. If you select this option, proceed to step 11.
  6. Type the following MSSQL database details and click Next:

    1. Database Host Name: Specifies the host name of the server where the Jaspersoft repository will be created.

    2. Database Port: Specifies the port number to connect to the database. Default: 1433

    3. Database Name: Specifies the Jaspersoft repository name.

    4. Database User name: Specifies the username of the database where the repository will be created.
    5. Database Password: Specifies the password of the database where the repository will be created.
  7. Type the following port details and click Next:
    1. HTTP Port: Specifies the HTTP port configured for the CABI JasperReports Server. Default: 8080
    2. HTTPS Port: Specifies the HTTPs port configured for the CABI JasperReports Server. Default: 8443
    3. Shutdown Port: Specifies the shutdown port configured to shutdown Tomcat. Default: 8005
  8. Type the WebApp Server name and click Next. Start the WebApp Server name with an alphabet. You can include numerals (0-9) and hyphen (-). Blank space is not permitted.
  9. (Optional) Select Enable Samples, if you need to install sample report content of Jaspersoft.
  10. Type the SugarCRM and Foodmart database names, if you selected Enable Samples check box.
  11. (Only if you install CABI JasperReports Server on your own) Choose the CABI JasperReports Server installation folder.
  12. Type the active SOI Manager database host name, valid CA SOI database credentials, and click Next.
  13. (Only if you install CABI JasperReports Server on your own) Provide the following information and click Next:
    1. Select the protocol.
    2. Specify the port number according to the selected protocol.
    3. JasperReports Server instance name: Type the WebApp Server name.
    4. User id/Password: Log in credentials of the user with administrator privileges who does not belong to an organization in JasperReports Server. Default: superuser/superuser 
      If the CABI JasperReports Server connection is successful, the Pre-Installation Summary page opens.
  14. Verify the pre-installation summary and click Install.

  15. Click Done when the installation finishes.
    The CABI JasperReports Server and CA SOI Reports are installed.
  16. (Only if you install CABI JasperReports Server on your own) Browse to <Jaspersoft install folder>/tomcat/bin and double-click startup.bat.
  17. (Optional) Review the installation log file (SOI - Reports_Install_timestamp.log) that is in the <SOI_HOME>\logs\installation folder to check for installation errors.
  18. Verify that the following files are in the correct locations:
    • CA SOI Reports Roles and Archives in the following location:
      <SOI Install Folder>/Reports
    • Custom jar files with prefix ca are created and available in the following location:
      <Jaspersoft Install Folder>/tomcat/webapps/jasperserver-pro/WEBINF/lib 

  19. Open a browser and access http://<Jaspersoft hostname>:<tomcat portnumber>/<webappname>. For example, http://localhost:8080/jasperserver-pro
    • Organization: Leave it blank until you configure reports in CA SOI. After configuration, value will be soi.
    • User ID/Password: Log in credentials of the user with administrator privileges who does not belong to an organization in JasperReports Server. Default: superuser/superuser 

      When you login CABI JasperReports Server as superuser, you have administrator rights. You may not able to run reports. To run and view reports, you need to login as a valid SOI Report user. To add users, see Adding Users.

Update SOI Reports

If you had installed SOI reports, you can update to the latest release.

Prerequisite:

  • If you are installing SOI Reports in a system with Windows server 2012, confirm that the Windows Application Compatibility mode is on.
  • Confirm you are updating CABI JasperReports Server and the CA SOI reports on a dedicated server with no other CA SOI components.

Follow these steps:

  1. Run soi-reports.exe from the Reports folder of the installation kit.
  2. Click Next in the Introduction page.
  3. Accept the license agreement and click Next.

  4. Verify the pre-installation summary and click Install.

  5. Click Done when the installation finishes.
    CA SOI Reports is updated.

Was this helpful?

Please log in to post comments.