BSARA INSTALL ON SQL SERVER 2005

Pre-Requisites 1. 2 Servers are recommended: One for OM+Reports and one for the Database 2. 4GB of RAM each for the OM+Reports Server and Database Server Installation 1. Using SQL Server Management Studio, create 4 databases: bsara_dw, bsara_etlmaster, bsara_etlwork, bsara_content; you can create individual users for each database or a single user for all databases. 2. Install database schema on bsara_dw: create_dw_master_script_sqlserver.sql sqlcmd -d bsara_dw -U sa -P n3wy34r <ENTER> :r create_dw_master_script_sqlserver.sql This can take 20-30min to complete; Check the number of rows in D_TIME (bsara_dw) table, the number of rows should be 86400. 3. Edit the create_linked_db.sql script and change the following parameters: a. <Database Name for OM> b. <Name of sqlserver instance for OM database> c. <Database name for OM> d. <Name of sqlserver instance for OM> e. <login for OM database> f. <Password for login for OM database> g. Run the create_linked_db.sql script. h. Verify in SQL Server Management Studio -> Server Objects -> Linked Servers -> db_site1_link (this must exist). i. Right Click on db_site1_link, Properties, Security and change the security context to sa/n3wy34r j. Run select * from db_site1_link.bladelogic.dbo.agent_state to check the link

4. Run the INSTALLER BMC Service Automation Reporting & Analytics JDK 1.5.0_10 These components will be installed to: C:\Program Files\BMC\Reports If the SQL Server database uses a named instance (server\instance), use the server name in the installer instead of servers\instance. Reports Warehouse Database Parameters Server: bldemo Port: 1433 SID: bsara_dw User: sa

BSARA Install Cheat Sheet

Page 1

Portal Database Parameters Server: bldemo Port: 1433 SID: bsara_content User: sa ODI Database Parameters Master Repository URL: jdbc:sqlserver://bldemo:1433;DatabaseName=bsara_etlmaster;SelectMethod=cursor User: sa Work Repository URL: jdbc:sqlserver://bldemo:1433;DatabaseName=bsara_etlwork;SelectMethod=cursor User: sa OM Primary Site Database Parameters (THIS IS CRITICAL TO GET RIGHT) Server: bldemo Port: 1433 SID: bladelogic User: sa modify local.properties if you made a mistake and then run "antrun install" 5. IF YOU ARE USING OM v7.4.x, Run create_om_smart_group_members_table_in_OM_database.sql against the bladelogic database Running ETL 1. From a Windows CMD Prompt, run nsh Run C:\PF\BMC\Reports\ETL\BIN\run_etl.nsh -s 1 -v 743 -d 3. Use 743 even if you install OM 743, OM 744, OM 745 or OM 746 2. Go to http://bldemo:9300/oracledimn, login as BL_READER/n3wy34r to check progress 3. http://bldemo:port/BMCSAReports, BLAdmin/n3wy34r

BSARA Install Cheat Sheet

Page 2

BSARA INSTALL ON ORACLE

Pre-Requisites 1. 2 Servers are recommended: One for OM+Reports and one for the Database 2. 4GB of RAM each for the OM+Reports Server and Database Server 3. You need 3 instances of Oracle: A. The first is the OM Core database; this is a non-unicode database instance B. The second instance must be a UNICODE instance and will be used by Cognos. C. The third instance is a non-unicode instance and will be used by BSARA Warehouse

Example Setup

BL Database Server BL Server OM, BSARA and Oracle Client (Hostname: appserver)

1 unicode DB Instance (blcog) 1 non-unicode DB instance (blware) 1 non-unicode DB Instance (blapp)

(Hostname: dbserver)

BSARA Install Cheat Sheet

Page 3

Oracle Client Setup on the BL Server

1. Make sure you select Administrator Install 2. Configure the TNSNAME to talk to the database server where the OM database lives. Make sure tnsnames.ora has the TNSNAME defined. If its not, copy this entry from the Database Server and put it in here. The tnsnames.ora on the appserver should be able to talk to all the 3 database instances; you can verify this with a tnsping <instance-name>

BSARA Install Cheat Sheet

Page 4

Database Server Setup for BSARA

Assumption: the OM Core Database (blapp) has already been setup

1. Database Creation for COGNOS (UNICODE/UTF-8)

Run dbca on the database server (dbserver)

BSARA Install Cheat Sheet

Page 5

BSARA Install Cheat Sheet

Page 6

BSARA Install Cheat Sheet

Page 7

2. BSARA Warehouse Database Creation (non-unicode)

Run dbca on the database server (dbserver)

BSARA Install Cheat Sheet

Page 8

3. Cognos Database Setup

A. From EXTERNAL_FILES.ZIP, extract create_portal_content_oracle_tablespaces_and_users.sql B. Edit the create_portal_content_oracle_tablespaces_and_users.sql script C. Change the directory location for BSARA_PORTAL01.dbf. D. Change the tablespace size from 1000M to 100M a. CREATE TABLESPACE BSARA_PORTAL i. DATAFILE '/space/oracle/db/oradata/bsara/BSARA_PORTAL01.dbf' b. SIZE 1000M c. AUTOEXTEND ON NEXT 1000M MAXSIZE 20000M LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO; E. Login as: sqlplus system@blcog F. start create_portal_content_oracle_tablespaces_and_users.sql

4. Warehouse Database Setup

A. From EXTERNAL_FILES.ZIP, create_oracle_tablespaces_and_users.sql B. Edit the create_oracle_tablespaces_and_users.sql and change the following: a. All paths (/space/oracle/db/oradata/bsara) b. Reduce the tablespace sizes to 50M and 100M

BSARA Install Cheat Sheet

Page 9

i. CREATE TABLESPACE BSARA_DATA 1. DATAFILE '/space/oracle/db/oradata/bsara/BSARA_DATA01.dbf' ii. SIZE 5000M iii. AUTOEXTEND ON NEXT 1000M MAXSIZE 20000M LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO; C. Login as: sqlplus system@blware D. start create_oracle_tablespaces_and_users.sql E. Login as: sqlplus BSARA_DW@blware F. SQL> spool create_dw_master_script_oracle.log SQL> start create_dw_master_script_oracle.sql

a. Enter value for 1: BSARA_DATA b. Enter value for 2: BSARA_INDEX G. Test the linked server: select * from agent_state@db_site1_link;

BSARA Install Cheat Sheet

Page 10

BSARA Setup
1. Copy the BLCOG and BLWARE entries from the tnsnames.ora on the Database Server to the BSARA Server. This important to ensure that BSARA Server (appserver) can talk to Oracle on the database server correctly BLAPP = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = dbserver)(PORT = 1521)) ) (CONNECT_DATA = (SERVICE_NAME = blapp) ) ) BLCOG = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = dbserver)(PORT = 1521)) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = blcog) ) ) BLWARE = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = dbserver)(PORT = 1521)) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = blware) ) ) su oracle tnsping BLAPP tnsping BLCOG tnsping BLWARE

2. Install the webserver (only works on 32 bit Linux servers) A. Extract the external-files.tar.zip B. cd BSARA/WebServer/Linux C. tar zxvf webserver.tar.gz #This will create a directory called webserver D. mkdir p /usr/local/bmc/reports E. mv webserver /usr/local/bmc/reports F. /usr/local/bmc/reports/webserver/bin/apachectl start G. Verify connectivity to https://server (the webserver is only compiled for https) 3. Install the Agent and NSH; This is NOT needed when OM and BSARA are installed on the same server

BSARA Install Cheat Sheet

Page 11

4. Run the Reports Installer (SH file) ================== Select Installation Components ================== + 1 - Reports + 2 - Authentication Server 9 - Start the installation A - Select all components D - Deselect all components Select component: 9 ________________________________________________________________________________ Please enter the hostname of this BMC Service Automation Reporting and Analytics server. This will be the name referenced in URLs used to access BMC Service Automation Reporting and Analytics. Hostname [appserver]: You have chosen the following name for this server: Hostname = appserver Is this correct (y/n) ? y ________________________________________________________________________________ BMC Service Automation Reporting and Analytics Communication Protocol and Port Communication Protocol (http/https)[http]: https Communication Port (80/443)[443]: You have chosen the following: Protocol = https Port = 443 Is this correct (y/n) ? y ________________________________________________________________________________ Please enter your BMC Service Automation Reporting and Analytics Webserver home directory. Webserver Home [/usr/local/bmc/reports/webserver]: You have chosen the following Webserver home directory: Webserver Home = /usr/local/bmc/reports/webserver Is this correct (y/n) ? y NOTE: Make sure that the directory location matches the one in Step 2

BSARA Install Cheat Sheet

Page 12

________________________________________________________________________________ Configure the Authentication Server host and port against which the BMC Service Automation Reporting and Analytics module will authenticate. Host [appserver]: Port [9640]: You have chosen the following Authentication Server parameters: Server Port = appserver = 9640

Is this correct (y/n) ? y ________________________________________________________________________________

Please configure an SMTP relay through which notifications will be sent from the BMC Service Automation Reporting and Analytics module (leave Server blank to disable). Server []: You have chosen not to set your SMTP parameters. Is this correct (y/n) ? y ________________________________________________________________________________

Please enter the directory in which all of the Agent Logs will be stored. Agent Log Folder [/usr/local/bmc/reports/AgentLogs]: You have chosen the following Agent Log home directory: Agent Log Folder = /usr/local/bmc/reports/AgentLogs Is this correct (y/n) ? y

________________________________________________________________________________

Please enter the Reports Data Warehouse connection parameters: Oracle Database Connection String [Ex: jdbc:oracle:thin:@<db.host>:<db.port>:<db.sid>]: jdbc:oracle:thin:@dbserver:1521:blware Reports Data Warehouse User ID [BSARA_DW]: Reports Data Warehouse Password []:sa Reports Data Warehouse TNS Entry Name []: blware

BSARA Install Cheat Sheet

Page 13

You have chosen the following Reports Data Warehouse connection parameters: Type = oracle Connection = jdbc:oracle:thin:@ dbserver:1521:blware User = BSARA_DW Password = ******** TNS Entry Name = blware ________________________________________________________________________________

Oracle Home [/home/oracle/product/10.2.0/client_1]: You have chosen the following Oracle home directory: Oracle Home = /home/oracle/product/10.2.0/client_1 Is this correct (y/n) ? ________________________________________________________________________________

Please enter the Portal Contents Store connection parameters: Oracle Database Connect Descriptor [Ex: (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=<db.host>)(PORT=<db.port>))(CONNECT _DATA=(SERVER=DEDICATED)(SERVICE_NAME=<db.sid>) ) )]: (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=dbserver)(PORT=1521))(CONNECT_DA TA=(SERVER=DEDICATED)(SERVICE_NAME=blcog) ) ) Portal Contents Store User ID [BSARA_PORTAL]: Portal Contents Store Password []:sa You have chosen the following Portal Contents Store connection parameters: Type = oracle Descriptor = (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=betadbo1)(PORT=1521))(CONNECT_DAT A=(SERVER=DEDICATED)(SERVICE_NAME=blcog) ) ) User = BSARA_PORTAL Password = ********

________________________________________________________________________________ Please enter the ETL Master Repository connection parameters: Oracle Database Connection String [Ex: jdbc:oracle:thin:@<db.host>:<db.port>:<db.sid>]: jdbc:oracle:thin:@dbserver:1521:blware ETL Master Repository User [BSARA_ETL_MASTER]:

BSARA Install Cheat Sheet

Page 14

ETL Master Repository Password []:sa You have chosen the following ETL Master Repository connection parameters: Type Connection User Password = oracle = jdbc:oracle:thin:@ dbserver:1521:blware = BSARA_ETL_MASTER = ********

________________________________________________________________________________ Please enter the ETL Work Repository connection parameters: Oracle Database Connection String [jdbc:oracle:thin:@ dbserver:1521:blware]: ETL Work Repository User [BSARA_ETL_WORK]: ETL Work Repository Password []:sa You have chosen the following ETL Work Repository connection parameters: Type Connection User Password = oracle = jdbc:oracle:thin:@ dbserver:1521:blware = BSARA_ETL_WORK = ********

________________________________________________________________________________ Please create the password that you want to use for the ETL BL_Reader. ETL BL_READER User Password []:bladelogic You have chosen the following: BL_READER Password = ******** Is this correct (y/n) ? y ________________________________________________________________________________ Specify the name of the Primary Site [Primary]: You have chosen the following: Primary Site Name = Primary Is this correct (y/n) ? y

________________________________________________________________________________

Please enter the BMC Bladelogic Core Database connection parameters:

BSARA Install Cheat Sheet

Page 15

Oracle Database Connection String [Ex: jdbc:oracle:thin:@<db.host>:<db.port>:<db.sid>]: jdbc:oracle:thin:@ dbserver:1521:blapp BMC Bladelogic Core Database User ID []: bladelogic BMC Bladelogic Core Database Password []:sa BMC Bladelogic Core Database TNS Entry Name []: blapp You have chosen the following BMC Bladelogic Core Database connection parameters: Type = oracle Connection = jdbc:oracle:thin:@ dbserver:1521:blapp User = bladelogic Password = ******** TNS Entry Name = blapp Is this correct (y/n) ? y ________________________________________________________________________________ Preparing for unattended install. Reading archive information /usr/local/bmc/reports/install_dir/3rdparty-installers/cognos/Linux_x86/linuxi386/setup.csp. Please wait... Total 250 components to install. ################################################################################ ################################################################################ ################################################################################ ########## Transfer is complete. The Cognos Installation Wizard is complete. The Cognos Installation Wizard End Time: Tue 20 Jan 2009 05:32:02 AM EST All selected components were transferred successfully.

... Done =========== Installing the Authentication Server =============

A self-signed certificate will now be generated for the Authentication Server to use SSL. Enter a password for this certificate. Password: Confirm Password:

BUILD SUCCESSFUL Total time: 11 minutes 20 seconds Configuring Uninstallation Information ... Done

BSARA Install Cheat Sheet

Page 16

Removing temporary files. This may take a minute ... =================== Installation Complete ==================== The installation is complete. You are now ready to begin using BMC software. Don't forget to look at the Release Notes and any appropriate documentation in /usr/local/bmc/reports/Doc for more information. For support please e-mail us at support@bmc.com ________________________________________________________________________________ 5. IF YOU ARE USING OM v7.4.x, Run create_om_smart_group_members_table_in_OM_database.sql against the bladelogic database 6. Run ETL A. Launch NSH B. cd /usr/local/bmc/reports/etl/bin C. ./run_etl.nsh -s 1 -v 75 -d 3 -p 3

BSARA Install Cheat Sheet

Page 17