Windows Installation

This page includes the following:

Steps to Install the Reporting Server

  • Uncompress the Reporting Server software installation bundle for Windows (zip file).

  • For Windows, the Reporting Server Installation can only be completed using the command-line. You must also be an Administrator. Execute the command as an Administrator.

  • When creating the pathname to the Reporting Server installation, no spaces are allowed.

    • Accepted: C:\BI_Installer

    • Not Accepted: C:\BI Installer

Windows Command Line Options

Verify Java 1.8 is installed before running the terma-bi-installer.bat command below. To check, run the following command from the Command Prompt: C:\BiReporting\terma-bi-installer-1.0> java -version

  • Java version 1.8.0_121

  • Java SE Runtime Environment (build 1.8.0_121-b13)

  • Java HotSpot 64-Bit Server VM (build 25.121-b13, mixed mode)

To get a list of installation options for the Reporting Server, run the following command, specifying the/h option:

C:\BiReporting\terma-bi-installer-1.0> terma-bi-installer.bat /h

Usage

terma-bi-installer.bat [options]

Options

Option Description
/d, /directory

Directory for installation. Required

For instance /directory C:\apps\BiReporting or /d C:\apps\BiReporting.
/w, /db-password Terma BI embedded DB password. Required
/r, /db-port

Terma BI embedded DB port. Optional. Default is 5432
/t, /port Terma BI Report Server Tomcat port (default 8080). This needs to be changed if the Automic Automation Intelligence Server is already using port 8080 and both run on the same physical server.
/s, /shutdown-port Tomcat shutdown port. Optional. Default is 8005
/a, /ajp-port Tomcat AJP port. Optional. Default is 8009
/jaws-protocol Automic Automation Intelligence server protocol. Optional. Default is HTTP
/j, /jaws-host Automic Automation Intelligence server host. Required
/p, /jaws-port Automic Automation Intelligence port. Optional. Default is 8080
/o, /jaws-oracle Automic Automation Intelligence database type is set to Oracle when specified. Otherwise, it is set to MS SQL Server.
/mail-host Email server hostname for sending scheduled reports. Required
/mail-from Email address to send reports from. Required
/mail-port Email server port. Optional. Default is 25
/mail-protocol Email server protocol. Optional. Default is SMTP
/mail-auth Email server authentication required when specified. Optional.
/mail-username Email server user name. Required if /mail-auth is specified
/mail-password Email server password. Required if /mail-auth is specified
/f, /file Config file. This config file will be read instead of the above parameters

The config file should have an extension of .bat

A config file named termaBi-config.bat will be written at the end of any successful installation which will be in the correct format to use as this config file.
/y, /yes Accept all prompts. No user input is required.
/h, /help For this help

Windows Command Examples

Usage: terma-bi-installer.bat [d/ Directory for installation] [j/Automic Automation Intelligence server host] [/o Automic Automation Intelligence database type is set to Oracle] [/w Reporting Server embedded database password] [/t  Reporting Server Tomcat port] [/mail-host Email server host] [/mail-from Email address to send reports from]

The user is prompted with the following: Continue with these settings? [y/n]

Notes:

  • The installation includes a build of the software that can take up to 10 minutes. There might not be any output displayed on the screen during this time.

  • The Reporting Server components are started as Windows Services as part of the installation.

SQL Server Database Example

C:\BiReporting\terma-bi-installer-1.0> terma-bi-installer.bat /d C:\BI_Installer /j Prod01 /w postgres /t 8090 /mail-host TSL-U01 /mail-from john.doe@broadcom.com

  • Terma BI Reporting will be installed to C:\BI_Installer
  • JAWS host set to Prod01
  • Terma BI embedded DB password is set
  • Tomcat port will be 8090
  • Mail host will be TSL-U01
  • Mail from will be john.doe@broadcom.com

Oracle Database Example

C:\BiReporting\terma-bi-installer-1.0> terma-bi-installer.bat /d C:\BI_Installer /j Prod01 /o /w postgres /t 8090 /mail-host TSL-U01 /mail-from john.doe@broadcom.com

  • Terma BI Reporting will be installed to C:\BI_Installer
  • JAWS host set to Prod01
  • JAWS database type is set to Oracle. No input required.
  • Terma BI embedded DB password is set
  • Tomcat port will be 8090
  • Mail host will be TSL-U01
  • Mail from will be john.doe@broadcom.com

Mail Authentication Example

C:\BiReporting\terma-bi-installer-1.0> terma-bi-installer.bat /d C:\BI_Installer /j Prod01 /o /w postgres /t 8090 /mail-auth /mail-host TSL-U01 /mail-username jdoe /mail-password password /mail-from john.doe@broadcom.com

  • Terma BI Reporting will be installed to C:\BI_Installer
  • JAWS host set to Prod01
  • JAWS database type is set to Oracle. No input required.
  • Terma BI embedded DB password is set
  • Tomcat port will be 8090
  • Mail auth will be true
  • Mail host will be TSL-U01
  • Mail username will be jdoe
  • Mail password is set
  • Mail from will be john.doe@broadcom.com
  • Continue with these settings? [y/n] y