Install CA Business Service Insight to Provide High Availability

As a system administrator, you are responsible for ensuring continuous availability of . The high availability solution is based on Windows Cluster Technology and Windows Network Load Balance (NLB) Technology.
bsi835
As a system administrator, you are responsible for ensuring continuous availability of
CA Business Service Insights
. The high availability solution is based on Windows Cluster Technology and Windows Network Load Balance (NLB) Technology.
CA Business Service Insights
uses the following options to provide high availability:
  • The database uses an Oracle RAC deployment.
  • Deploy the application server as Active/Passive.
  • Deploy the web server as Active/Active, and use load balancing with web session affinity.
High availability system overview
High availability system overview
Both the web servers and application servers require a High Availability shared file system to share files between the nodes. Use any storage operating environment that complies with High Availability requirements.
Application Server
The application server is deployed in an active/passive mode. The services run on only one of the application servers at a time. The High Availability infrastructure is configured to perform failover of the services from the active server to the passive server. The shared data on the application server consists of the Adapter configuration, state files, and the MSMQ data files.
The Application Tier
The Application Tier
Web Server
The web server is deployed as Active/Active. All web servers are active simultaneously and serve clients as needed. Because the web server stores data in the IIS session, the NW load balancing must use affinity when assigning a web server to the client. Most load balancers support this functionality.
The Web Tier
The Web Tier
Use this scenario to guide you through the process:
The steps to install
CA Business Service Insights
to provide high availability
The steps to install Clarity Business Service Insight to provide high availability
2
Verify the Prerequisites
To ensure a successful installation, verify the prerequisites. Use the
CA Business Service Insights
, Installation Prerequisites with the following exceptions:
  • Use a domain account with Administrator privileges for installation.
  • High availability requires a Windows 2008 operating environment.
  • Create an Oracle database with RAC. For more information, see Manually Create the Database.
    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.
  • Prepare four static IP addresses with assigned DNS names.
  • For complete information about the prerequisites, see Install
    CA Business Service Insights
    on a Single-Tier Environment
    .
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.
Installation and 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.
Install the Servers
To create your
CA Business Service Insights
system, install the server components. To provide high availability, install the servers in the following order:
  1. Application Servers
  2. Web Servers
  3. Adapter Servers
Use the following process to run the installation on each server node:
  1. Connect to the node.
  2. Install the server component.
  3. Restart the server node.
  4. Repeat for each node in the cluster.
Follow these steps:
  1. Copy the contents of the installation folder from the installation CD to the Installation folder.
    Default:
    C:\Program Files\CA \Cloud Insight\Setup or %ProgramFiles%\CA \Cloud Insight\Setup
    Do not include & or . in the installation directory name.
  2. Run Cloud_Insight_Server_8.2.5.exe from the server directory.
  3. Select the installation language, and click OK.
  4. To install the prerequisite component automatically, click Install.
    This dialog does not open if all the required components are already installed.
    The installation wizard opens.
  5. Follow the wizard through the installation.
    • If your organization name contains special characters (for instance, &), add the ^ character before each special character.
      For example: AB&C is referred to as AB^&C.
    • For the Setup Type, select Typical.
    • Select the server components require based on your topology.
  6. Complete the installation dialogs.
    Only the dialogs that are related to the features you select open. For more information, see Installation Dialogs.
    The Setup Status window opens and the installation begins.
    For Windows Server 2008 R2 installations, ignore the DocumentLoader error that may occur.
  7. When the installation wizard finishes, restart the computer.
    Windows Server 2008 R2 requires additional configuration before you restart the server. For more information, see Windows Server 2008 R2 Server Configuration.
    If necessary, install the other server components.
Installation Dialogs
During the installation, relevant dialogs open in the wizard. The following table lists the dialogs that appear based on the server components that you select.
Servers Selected
Related Dialog Boxes
Database
Language, Requirements, Organization, Type, Destination, Features, Database Creation, Summary, Database Installation, Complete
Application
Language, Requirements, Organization, Type, Destination, Features, Logon, Database Connection, JBOSS, Summary, Complete
Web
Language, Requirements, Organization, Type, Destination, Features, Logon, Log Server conf, Database Connection, JBOSS, Summary, BSI settings, Complete
The following table lists the installation dialogs and 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 dialog with 8 languages to select
--
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
--
Destination
Destination Folder
--
The absolute path where the server is installed.
Features
Components to be installed
Database, Application, Website
Select the appropriate feature for the server role.
Database Creation
Oracle Version ‡
Default:
Server default
--
DB Folder Location ‡
--
--
DB service name ‡
--
--
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.
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.
Password ‡
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
--
Log Server Configuration
Log Server Network Address
Default:
localhost
Localhost is valid for any server that includes the web server.
If the log server is not on the localhost, change the address to the correct server.
Note:
The address must be the address of the log server installation.
Log server Network Port
Default:
4040
--
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 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. Refer to the Oracle literature for their specific requirements, such as ASCII, and limitations, such as special characters and double-byte characters.
Password ‡
User password
--
JBOSS
Location of the third-party CD
--
Specify the location of the third-party CD.
The files must be in a writeable drive or directory.
Summary
--
--
Verify the summary, and continue the installation.
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.
Windows Server 2008 R2 Server Configuration
To configure installations on Windows Server 2008 R2, perform the following tasks on all servers that include an Application server or Web server component.
Follow these steps:
  1. When the installation wizard prompts you to restart, open a command prompt:
    1. Click Start, Run.
    2. Enter the following command in the Run window:
      C:\Windows\SysWOW64\cmd.exe
      The command prompt opens.
  2. Execute one of the following commands:
    • The server contains a Web server component:
      cd %OG_HOME%\bin
      StringsLoader.exe -a <Path to language strings xml files>
      cd %OG_HOME%\Setup\Migration\
      DocumentLoader.exe
      Default path:
      C:\Inetpub\wwwroot\Oblicore\App_Data\Resources
    • The server contains only an Application server component:
      cd %OG_HOME%\bin
  3. Restart the server.
Configure the Servers
To provide high availability, configure the servers.
Important!
Log in to the
CA Business Service Insights
website as sadmin after you install
CA Business Service Insights
. The default password is sadmin.
For each server, verify the follow for the services:
  • All services are set to Startup Type: Manual.
  • All other services are set to Log On As: <domain user>
Configure the Application Servers
Follow these steps:
Create Service Groups
  1. Open the Failover Cluster Management program.
  2. Click Service and Applications in the console tree.
  3. Click More Actions, Create Empty Service or Application.
  4. Create the following Groups:
    • CA Business Service Insights
      , Services
    • CA Business Service Insights
      , Current Status
    • CA Business Service Insights
      , ACE1 Writer
    You can use a single group for all services.
Add Services to Service Groups
  1. Click the
    CA Business Service Insights
    Services Group.
  2. Go to Add a resource, Generic Service, and add the following resources from the drop-down list. Select the resource, click next, and click finish.
    • Oblicore - Tomcat 6
    • Oblicore - Adapter Listener
    • Oblicore - Alerts
    • Oblicore - Dashboard Engine
    • Oblicore - Log Server
    • Oblicore - PenaltyWriter
    • Oblicore - ScriptHost
    • Oblicore - Tasks Host
    • Oblicore - Reports Scheduler
  3. Click the
    CA Business Service Insights
    Services Group.
  4. Go to Add a resource, Client Access Point, Enter Network Name and IP address. This action may take a few minutes. Do not exit until the configuration is complete.
  5. Click Next, Next, Finish.
Set Resource Dependencies
Perform these steps for each resource in the following list:
  • Oblicore - Tomcat 6
  • Oblicore - Adapter Listener
  • Oblicore - Dashboard Engine
  • Double-click the resource.
  • Go to the Dependencies tab.
  • Select access point network name and Click OK.
Add Resources to the Cluster Group
  1. Add Oblicore - Current_Status_Engine resource to
    CA Business Service Insights
    - Current Status Group.
  2. Add an Oblicore - PSLWriter resource to
    CA Business Service Insights
    - ACE1 Writer Group.
  3. Create a resource for each additional PSLWriter service, and add the services to the
    CA Business Service Insights
    ACE1 Writer Group.
Add the Message Queuing Service
  1. Open the Failover Cluster Management program.
  2. Go to the console tree, and click Service and Applications.
  3. Click Configure a Service or Application.
  4. The High Availability Wizard opens.
  5. Select Message Queuing, and click Next.
  6. Follow the Wizard through configuration.
  7. Open the Server Manager. Go to Features, Messages, Private Queues. On each Application server node, delete all queues in the Private Queues storage folder.
  8. Open the Failover Cluster Management program. Right-click the Message Queuing service, Message Queuing, Private Queues. On each Application server node, delete all queues in the Private Queues storage folder.
  9. Right-click the Message Queuing service, and click Manage MSMQ, Message Queuing, Private Queues, and create the following queues:
    • OG Alerts
    • OG Adapter Listener
    • OG Dashboard
    • OG Current Status
Start Resources
  1. Bring all resources online.
Configure the Web Servers
Follow these steps:
  1. Set up Network Load Balancing.
    Follow the instructions in the Microsoft TechNet guide: http://technet.microsoft.com/en-us/library/cc754833(WS.10).aspx.
  2. Navigate to Program Files\Oblicore.
  3. Copy the Booklet Templates, Export Templates, and Packages folders to the Web shared folder.
Configure the Adapter Servers
Follow these steps:
  1. Connect to the first
    CA Business Service Insights
    Adapter cluster server node.
  2. Open the Failover Cluster Management program.
  3. In the console tree, click Service and Applications.
  4. Click More Actions, Create Empty Service or Application.
  5. Click Oblicore - Adapter Deployment.
  6. Click More Actions, Add a resource, Generic Service, and add Oblicore - AdapterDeployment resource.
  7. Go to \Program Files\Oblicore\Adapters, and copy the deployed adapter folders to the Adapters folder on the clustered shared folder (Disk S).
    Verify that the adapter paths point to the correct adapter folder paths on the cluster drive.
  8. One each Adapter cluster server node, open the Registry Editor, and go to HKEY_LOCAL_MACHINE, SOFTWARE, Oblicore, Adapters. Verify that the AdaptersDir string has the value S:\Adapters.
  9. Right-click the resource, and click Bring this resource online.
Complete the Installation
Follow these steps:
  1. Log in to the
    CA Business Service Insights
    website.
  2. Verify that the hours offset matches the time zone that you select.
  3. Verify that the dates for daylight savings match your location.
  4. Click Administration, Site Settings, Advances, and update the following parameters:
Configuration Folder
Parameter
Value
Adapter Wizard
Adapter Listener Address
The shared address of the application server.
Default:
bsiapp
Dashboard, Addresses
Dashboard Servive URL
The shared address of the application server.
Default:
bsiapp
Dashboard, Current Status related settings
URL of the remote current status listener
Dashboard Engine listener address
Note:
Update these parameters on Windows Server 2008 R2 only.
The shared address of the application server.
Default:
bsiapp
Queues
Current status MSMQ machine
Dashboard MSMQ machine
Default MSMQ machine
The shared address of the application server.
Default:
bsiapp
Reports
Booklet Path
Note:
By default, you cannot edit the Booklet Path in the GUI. Update the parameter in t_system_configurations or set Changeable_in_gui to Y.
Location of shared storage folder/Booklet Path
System
Web Server
The Web NLB address.
(Optional) Update the Proxy Prefix
To support requests that the reverse proxy forwards to the CA website, enter the prefix string as the Proxy Prefix key value. The Proxy Prefix key value can be changed in the web.config file in App Settings section. 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:
    - The Proxy Prefix key does not exist
    - Its value is an empty string
  2. Add a header to the proxy configuration. Use the following header key:
    "X-Forwarded-CA-Oblicore-Proxy"