Install
CA Business Service Insights
on a Two-Tier Environment

This section describes how to install  in an environment with a singles server that handles the Application server and Web server role, and a dedicated database server.
bsi835
This section describes how to install
CA Business Service Insights
in an environment with a singles server that handles the Application server and Web server role, and a dedicated database server.
2
Contents
Verify the Prerequisites
Hardware Prerequisites
The following table shows the minimum and recommended hardware requirements for
CA Business Service Insights
servers and the required network connectivity:
Component
Minimum
Recommended
Processors
Two 2.4-GHz Intel cores or equivalent
Four 2.4-GHz Intel cores or equivalent
Memory
4 GB RAM
8 GB RAM
Network
100 Mbps Fast Ethernet connection
1 Gbps Fast Ethernet
The following table shows the minimum and recommended storage requirements for
CA Business Service Insights
servers.
Component
Minimum
Recommended
Database Server
40 GB
120 GB*
Application Server
18 GB
40 GB*
Web Server
18 GB
40 GB*
Notes:
  • We recommend a RAID 5 controller or a comparable high-availability/high-throughput disk configuration.
  • The database capacity varies based on several parameters such as:
    • Number of metrics
    • Volume of raw data
    • Period that you keep historical data
Server Software Prerequisites
The following sections list the software prerequisites for the database, application, and web servers. Specific Windows roles are required for the application servers and web server. Verify that all servers meet all prerequisites.
Database Server Prerequisites
Supported Operating systems
The database installation scripts were tested in the operating systems listed in the following table:
OS Version
Patch Level
Architecture
Windows Server 2008 Standard or Enterprise edition
SP2
32-bit and 64-bit
Windows Server 2008 R2 Enterprise edition
SP1
64-bit
Supported database server software
CA Business Service Insights
supports installation on Oracle database with version 11.2.0.4 for the Standard and Enterprise editions.
CA Business Service Insights
supports Oracle DB 11.2.0.3 only if the Oracle client is version 11.2.0.4.
Software prerequisites
Before installing
CA Business Service Insights
, verify that the Oracle server and the database connection configuration components are installed and configured correctly.
  • TNSnames.ora and Listener.ora must be present on the database server.
  • Listener needs to be configured to recognize the instances you are creating.
  • For Oracle version 11, verify that the _optimizer_group_by_placement parameter is FALSE.
CA Business Service Insights
does not support consolidated databases. Consolidated databases cause future upgrades and some functions to fail.
For more detailed information about how to set up the Oracle network, see Configure Oracle Network.
Installation on a RAC Database
CA Business Service Insights
is compatible with RAC, but the RAC is not created as part of the installation. To use RAC, select one of the following options:
  • Install the product using our InstallDB scripts. Reconfigure the instance to support RAC, and add another instance to create the RAC database.
    For more information about InstallDB scripts, see Manually Create the Database.
  • Create your own RAC, and run our scripts without creating an instance. Our scripts perform only
    CA Business Service Insights
    related actions.
CA Business Service Insights
is not tested on RAC and ASM. An Oracle DBA can modify the install scripts or manually create the database to install the BSI database on RAC/ASM. However, if a problem occurs in this environment, CA Support reserves the right to request you to reproduce the problem in a non-RAC/ASM installation.
For more information about Oracle supported platforms, see the Oracle documentation.
Application and Web Server Prerequisites
Supported Operating systems
CA Business Service Insights
is supported in the following operating systems:
OS Version
Patch Level
Bitness
Web Server
Settings
Windows Server 2003 Standard and Enterprise edition
SP2
32-bit
IIS 6.0
IIS (web server)
Windows Server 2008 Standard and Enterprise edition
SP2
32-bit or 64-bit
IIS 7.0 or 7.5
IIS (web server); IIS 6 compatible mode
Windows Server 2008 Server R2 Enterprise edition
SP2
64-bit
IIS 7.0 or 7.5
IIS (web server): IIS 6 compatible mode
Windows Server 2012
64-bit
IIS 8.0
IIS (web server): IIS 6 compatible mode
Microsoft Windows Server 2016 Datacenter
64-bit
IIS 10.0
IIS (web server)
Software prerequisites
Before the installation, verify the following software prerequisites:
  • In Microsoft Windows 2008 Server R2, set the Active Server Pages extension to Allow on the web server.
  • ASP.NET must be installed.
    CA Business Service Insights
    does not support .Net Framework 4.5. For Windows 2012, .Net 4.5 is the default. Update the .Net Framework to 4.5.1 or 4.5.2.
  • Web services must be installed and started, which are:
    • The Distributed Transaction Coordinator service.
    • The World Wide Web Publishing service.
  • Install and configure Microsoft Message Queuing (MSMQ). MSMQ uses the following ports:
    • TCP: 1801
    • RPC: 135, 2101/2112, 2103/2114, 2105/2116
    • UDP: 3527, 1801
  • Oracle Client, Oracle OLEDB driver, and ODAC 11.2 Release 4 32 bit (ODAC112040Xcopy_32bit). For more information about how to set up the Oracle network, see Configure Oracle Network
    The application works on 32-bit mode. On 64-bit systems, install the Oracle client in 32-bit mode.
    Oracle Database Server and Client Details
    Server Details
    Oracle Server Software
    Oracle Client Software
    ODAC Software
    Application Server (Web Server)
    Not Applicable
    Oracle 11g R2 Client (32 bit )
    ODAC 11.2.0.4 32 bit
    Database Server
    Oracle 11g R2 (64 bit )
    Oracle 12c (64 bit )
    Not Applicable
    Not Applicable
  • (Optional) RawDataTools requires Microsoft Visual C + + 2010 Runtime Libraries (x86). Download this component from Microsoft.
Additional information
  • This product is IP Version 6.0 tolerant.
  • JDK 1.7.0.25 Environment (32-bit) is installed automatically.
    JBoss 7 is installed automatically and includes the following components:
    • JBoss Messaging 1.4.5
    • JBoss Remoting 2.2.3 SP1
    - Content Transfer uses the following ports on the JBoss application server: 1198, 1199, 1200, 1201, 1261,1262, 3628, 3973, 4544, 4545, 4548, 5546, 4557, 8180, 8183, 8193, 19101.
Required Windows Roles and Features
Windows Server 2008/Windows Server 2012 - Roles and Features
Windows Server 2008 and Windows Server 2012 platforms require the following configuration roles and features:
The following Windows roles are required on the web server:
  • Application Server
  • Web Server (IIS)
The following Windows features are required on the Application Server role for the web server:
  • Application Server Foundation
  • .NET Framework (apply patches to bring you to 4.5.1 or 4.5.2)
  • Web Server (IIS) Support (IIS 6 compatibility mode required)
  • COM+ Network Access
  • Windows Process Activation Service Support
    • Message Queuing Activation
    • HTTP Activation
  • Distributed Transactions
    • WS-Atomic Transactions
The following Windows features are required on the Web Server (IIS) role for the web server:
  • All services for "Common HTTP Features" group
  • All services for "Application Development" group
  • Health and Diagnostics
    • HTTP Logging
    • Logging Tools
    • Request Monitor
    • Tracing
  • Security
    • Digest Authentication
    • Client Certificate Mapping Authentication
    • IIS Client Certificate Mapping Authentication
    • URL Authorization
    • Request Filtering
    • IP and Domain Restrictions
  • All services in the Performance group
  • All services in the Management Tools group
Install
CA Business Service Insights
Regional Settings
To ensure a successful installation, change the regional settings of the server to English. Non-English settings may cause problems after installation.
Use the following process when you install the servers:
  1. Change the regional settings of your server to English (USA).
  2. Install and restart the server.
  3. Revert to your local regional settings.
  4. Restart the server.
Installation Process
To create your
CA Business Service Insights
system, install the server components in the following order:
  1. Create the database on the database server. Use the typical installation procedure unless one of the following cases applies:
    • Database server is a non-Windows server
    • Database is on a RAC-based environment
    • CA Support recommends manual database creation.
  2. Install the application and web server.
For a two-tier installation, use the typical installation procedure. Open the installation folder, and run Cloud_Insight_Server_8.3.exe from the server directory.
During the installation, relevant dialogs open in the wizard. The following table lists the dialogs that appear during a typical installation:
Servers Selected
Related Dialog Boxes
Database
Language, Requirements, Organization, Type, Destination, Features, Database Creation, Summary, Database Installation, Complete
Application + Web
Language, Requirements, Organization, Type, Destination, Features, Logon, Database Connection, JBOSS, Summary, BSI Settings, Complete
The following table lists the installation dialogs and the related parameters and values:
Do not use double-byte characters for entries that are marked with a double dagger (‡).
Name
Parameters
Values
Notes
Language
Installation language
Dropdown list with 8 languages
Requirements Installation
Click Install to start the installation of prerequisite software. This installation may require a reboot.
Organization
Organization Name ‡
Specify the organization name for the end users.
If your organization name contains special characters (for instance, &), add the ^ character before each special character.
Example:
For AB&C, sue AB^&C.
Type
Installation type
Typical or Custom
Select Typical Installation.
Destination
Destination Folder
The absolute path where the server is installed.
Features
Components to be installed
Database, Application, Website
For the database server, select Database.
For the Application and Web server, select Application and Web.
Database Creation
Oracle Version ‡
10 or 11
Database Folder Location ‡
Database Service Name ‡
Database Character Set
UTF8 or MSWIN
You can select AL32UTF8 or WE8MSWIN1252 character sets. The AL32UTF8 character set enables you to store non-Western European characters but requires more space.
Type of Synonym
Public or Private
Schema user name
The database user that is used to create the
CA Business Service Insights
database schema.
Note:
Oracle does not support the use of certain characters in its naming conventions. For more information about the specific requirements, such as ASCII, and limitations, such as special characters and double-byte characters, see the Oracle documentation.
Schema password
Login Information
User Name ‡
Default:
The user account that you used for installation.
The user must be a member of the Administrator Local Group.
To create a new user, click New User.
To select a user from a list, click Select User.
Password ‡
User password
Database Connection
Oracle Version
10 or 11
Database Instance TNS Name ‡
The TNS name of the database instance.
Specify the TNS name of
CA Business Service Insights
in the TNSNAMES.ORA file.
Schema user name
The database user that will be used to create the
CA Business Service Insights
database schema.
Note:
Oracle does not support the use of certain characters in its naming conventions. Refer to the Oracle literature for their specific requirements, such as ASCII, and limitations, such as special characters and double-byte characters.
Database Installation
Y or N
Confirm that the listed parameters are correct, and continue.
BSI settings
Confirm that the listed
CA Business Service Insights
configuration parameters are correct.
Note:
For Windows Server 2008 R2 installations, ignore the DocumentLoader and   ConsoleApplication error that may occur.
Complete
Installation Wizard Complete
When the installation wizard finishes, restart the computer.
Manually Create the Database
Prepare the database for the
CA Business Service Insights
system. This procedure describes a standard Oracle server configuration and provides and example. For more information, see the Oracle documentation or contact Oracle for assistance.
If you are not planning on using the CA default configuration, print The CA Technologies Naming Conventions Policy for Database Objects. Complete the form and consult CA Support before the installation if your database naming convention differs from the default.
Follow these Steps:
  1. Locate the installation file on the installation CD in Server\program files\CA\Cloud Insight\Setup\InstallDB, and copy the directory contains to:
    • (Windows) %OBLICORE_ROOT%\Setup\InstallDB
    • (Unix) Linux File System:/Software
      Do not include & or . in the installation directory name.
  2. Edit start_parameter.ini file that is located in the InstallDB directory. Update the following parameters:
    • OBLICORE_ROOT
      Specifies a location for the database where the setup creates a folder with the database name.
      Create the root folder before you run the database creation script.
    • DB_NAME
      Specifies the name of the database instance.
      Limit:
      1-8 characters
    • ORACLE_HOME
      Specifies the location of Oracle Home.
      If the server has multiple homes, use the home that references an Oracle server installation and not a client installation.
    • SYS_PASS
      Specifies the SYS user password.
    • OBLICORE_USER
      Specifies the name of the schema user that holds the
      CA Business Service Insights
      database entities.
      If you change the user name, the BRV does not function.
    • OBLICORE_PASS
      Specifies the password of the schema user.
    • OBLIDBADMIN_PASS
      Specifies the password of the Oracle user oblidbadmin that is used during database installation and migrations.
    • DB_CHARSET
      Specifies the database character set, UTF-8 or MSWIN1252.
    • DB_SYNONYM
      Specifies public or private synonym.
    Example for Windows:
    [DataBaseDetailes]
    OBLICORE_ROOT=c:\oblicore
    DB_NAME=oblicore
    ORACLE_HOME=c:\oracle\product\11.1.0\db_1
    SYS_PASS=sys
    OBLICORE_USER=oblicore
    OBLICORE_PASS=oblicore
    OBLIDBADMIN_PASS=oblidbadmin
    DB_CHARSET=utf8
    DB_SYNONYM=public
    Example for Linux/Unix:
    [DataBaseDetailes]
    OBLICORE_ROOT=/oracle/Oblicore
    DB_NAME=OBLICORE
    ORACLE_HOME=/opt/oracle/product/11.2.0/dbhome_1
    SYS_PASS=sys
    OBLICORE_USER=oblicore
    OBLICORE_PASS=oblicore
    OBLIDBADMIN_PASS=oblidbadmin
    DB_CHARSET=utf8
    DB_SYNONYM=public
  3. In Unix/Linux server you may need to change the scripts format and add permissions, before running the script. For more information, see Prepare Unix/Linux Directory for the Installation.
  4. Run the script:
    1. (Windows) Main.bat
    2. (Unix) Main.sh
  5. Verify that the parameters are correct.
  6. Follow the on-screen instructions.
  7. Check the log file for errors.
    The database is set up and you can install the
    CA Business Service Insights
    servers.
Prepare Unix/Linux Directory for the Installation
To prepare the directory for installation, perform the following tasks.
Follow these steps:
  1. Copy the directory SetupDB from \Server\program files\CA\Cloud insight\ on the installation CD to the Linux File System:/Software.
  2. Execute the following commands:
    • Create the directory for the logs:
      Mkdir - p /Software/SetupDB/InstallDB/Log
    • Grant the Oracle user permissions to access the installation script files:
      Chown - R oracle:oinstall /Software/SetupDB
  3. Convert the file from dOS format to UNIX:
    1. Create BSI-conv.sh in /InstallDB.
    2. Copy the following code
      #!/bin/bash
      dos2unix_recursive()
      {
      for file in "$1"/*; do
      if [ ! -d "$file" ] ; then
      if [ ! -L "$file" ] ; then
      echo Convert $file to Unix format...
      dos2unix $file $file
      fi
      else
      if [ ! -L "$file" ] ; then
      dos2unix_recursive $file
      fi
      fi
      done
      }
      dos2unix_recursive "$PWD"
      chmod -R +rx *.sh
    3. Run the bat file.
  4. Verify that the directory /oracle/oblicore exists. If it does not exist, create it.
Complete the Installation
To complete the installation, perform the following tasks.
Log in as
sadmin
after installation. The default password is
sadmin
.
Follow these steps:
  1. Verify that the services you selected were installed correctly:
    1. Click
      Start
      ,
      Run
      .
    2. Type services.msc, and click
      OK
      .
    3. Verify that the services corresponding to the components you selected during the installation were installed properly.
    By default, ACE is the default calculation engine.
    For a complete list of services, see
    CA Business Service Insights
    Services
    .
  2. Log in to the
    CA Business Service Insights
    website.
  3. Verify that the hours offset matches the time zone that you select.
  4. Verify that the dates for daylight savings match your location.
  5. (Optional) Enter the prefix string as the
    ProxyPrefix
    key value in the web.config file in AppSettings section. This action allows you to support requests that the reverse proxy forwards to the CA website. The prefix string is configured to route the request to the CA website in the proxy configuration.
    1. Verify that the website is routed correctly to the reverse proxy. Verify that the proxy value is spelled correctly and is entered between the two slashes ("/prefix/").
      For example, if the prefix mapped to the CA website is “ca” update web.config as follows:
      <appSettings>
      <add key="ProxyPrefix" value="/ca/" />
      </appSettings>
      The website functions in normal mode if:
      1. The ProxyPrefix key does not exist.
      2. The value is an empty string.
    2. Add a header to the proxy configuration. Use the following header key:
      "X-Forwarded-CA-Oblicore-Proxy"
  6. Update the settings on the
    CA Business Service Insights
    website.
    1. Click Administration, Site Settings, Advances.
    2. Click Queues.
    3. Update the application server IP or address for the:
      1. Current Status MSMQ Machine
      2. Default MSMQ Machine
      3. Dashboard MSMQ Machine
    CA Business Service Insights
    is ready for use.