Bsara Install Cheat Sheet v1 1 2

7/30/2019 Bsara Install Cheat Sheet v1 1 2

1/17

BSARA Install Cheat Sheet Page 1

BSARA INSTALL ON SQL SERVER 2005

Pre-Requisites

1. 2 Servers are recommended: One for OM+Reports and one for the Database2. 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 forall databases.

2. Install database schema on bsara_dw: create_dw_master_script_sqlserver.sqlsqlcmd -d bsara_dw -U sa -P n3wy34r :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, thenumber of rows should be 86400.

3. Edit the create_linked_db.sql script and change the following parameters:a. b. c. d. e. f. 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 tosa/n3wy34r

j. Run select * from db_site1_link.bladelogic.dbo.agent_state to check the link

4. Run the INSTALLER

BMC Service Automation Reporting & AnalyticsJDK 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 ParametersServer: bldemoPort: 1433SID: bsara_dwUser: sa


2/17


Portal Database ParametersServer: bldemoPort: 1433SID: bsara_contentUser: sa

ODI Database ParametersMaster Repository URL:jdbc:sqlserver://bldemo:1433;DatabaseName=bsara_etlmaster;SelectMethod=cursorUser: saWork Repository URL:jdbc:sqlserver://bldemo:1433;DatabaseName=bsara_etlwork;SelectMethod=cursorUser: sa

OM Primary Site Database Parameters (THIS IS CRITICAL TO GET RIGHT)Server: bldemoPort: 1433SID: bladelogicUser: 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.sqlagainst 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 -d3.

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


3/17


BSARA INSTALL ON ORACLE

Pre-Requisites

1. 2 Servers are recommended: One for OM+Reports and one for the Database2. 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 instanceB. 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

(Hostname: dbserver)

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)


4/17


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 DatabaseServer and put it in here.

The tnsnames.ora on the appservershould be able to talk to all the 3 database instances; youcan verify this with a tnsping


5/17


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)


6/17



7/17



8/17


2. BSARA Warehouse Database Creation (non-unicode)Run dbca on the database server (dbserver)


9/17


3. Cognos Database SetupA. From EXTERNAL_FILES.ZIP, extract

create_portal_content_oracle_tablespaces_and_users.sql

B. Edit the create_portal_content_oracle_tablespaces_and_users.sql scriptC. Change the directory location for BSARA_PORTAL01.dbf.D. Change the tablespace size from 1000M to 100M

a. CREATE TABLESPACE BSARA_PORTALi. DATAFILE '/space/oracle/db/oradata/bsara/BSARA_PORTAL01.dbf'

b. SIZE 1000Mc. 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 SetupA. 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


10/17


i. CREATE TABLESPACE BSARA_DATA1. DATAFILE '/space/oracle/db/oradata/bsara/BSARA_DATA01.dbf'

ii. SIZE 5000Miii. 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.logSQL> start create_dw_master_script_oracle.sql

a. Enter value for 1: BSARA_DATAb. Enter value for 2: BSARA_INDEX

G. Test the linked server: select * from agent_state@db_site1_link;


11/17


BSARA Setup

1. Copy the BLCOG and BLWARE entries from the tnsnames.ora on the Database Server to the BSARAServer. This important to ensure that BSARA Server (appserver) can talk to Oracle on the databaseserver 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 oracletnsping BLAPPtnsping BLCOGtnsping BLWARE

2. Install the webserver (only works on 32 bit Linux servers)A. Extract the external-files.tar.zipB. cd BSARA/WebServer/LinuxC. tar zxvf webserver.tar.gz #This will create a directory called webserverD. mkdirp /usr/local/bmc/reportsE. mv webserver /usr/local/bmc/reports

F. /usr/local/bmc/reports/webserver/bin/apachectl startG. Verify connectivity tohttps://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
https://server/https://server/https://server/https://server/


12/17


4. Run the Reports Installer (SH file)

================== Select Installation Components ==================

+ 1 - Reports+ 2 - Authentication Server

9 - Start the installationA - Select all componentsD - 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 andAnalytics.

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]: httpsCommunication Port (80/443)[443]:

You have chosen the following:

Protocol = httpsPort = 443


________________________________________________________________________________

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


NOTE: Make sure that the directory location matches the one in Step 2


13/17


________________________________________________________________________________

Configure the Authentication Server host and port against which theBMC Service Automation Reporting and Analytics module will authenticate.

Host [appserver]:Port [9640]:

You have chosen the following Authentication Server parameters:

Server = appserverPort = 9640


________________________________________________________________________________

Please configure an SMTP relay through which notifications will be sentfrom the BMC Service Automation Reporting and Analytics module (leave Server blank to disable).

Server []:

You have chosen not to set your SMTP parameters.


________________________________________________________________________________

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


________________________________________________________________________________

Please enter the Reports Data Warehouse connection parameters:

Oracle Database Connection String [Ex: jdbc:oracle:thin:@::]: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


14/17


You have chosen the following Reports Data Warehouse connection parameters:

Type = oracleConnection = jdbc:oracle:thin:@ dbserver:1521:blwareUser = BSARA_DWPassword = ********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=)(PORT=))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=) ) )]:(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=dbserver)(PORT=1521))(CONNECT_DATA=(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 = oracleDescriptor =

(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=betadbo1)(PORT=1521))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=blcog) ) )

User = BSARA_PORTALPassword = ********

________________________________________________________________________________

Please enter the ETL Master Repository connection parameters:

Oracle Database Connection String [Ex: jdbc:oracle:thin:@::]:jdbc:oracle:thin:@dbserver:1521:blware

ETL Master Repository User [BSARA_ETL_MASTER]:


15/17


ETL Master Repository Password []:sa

You have chosen the following ETL Master Repository connection parameters:

Type = oracleConnection = jdbc:oracle:thin:@dbserver:1521:blwareUser = BSARA_ETL_MASTERPassword = ********

________________________________________________________________________________

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 = oracleConnection = jdbc:oracle:thin:@dbserver:1521:blwareUser = BSARA_ETL_WORKPassword = ********

________________________________________________________________________________

Please create the password that you want to use for the ETL BL_Reader.

ETL BL_READER User Password []:bladelogic


BL_READER Password = ********


________________________________________________________________________________

Specify the name of the Primary Site [Primary]:


Primary Site Name = Primary


________________________________________________________________________________

Please enter the BMC Bladelogic Core Database connection parameters:


16/17


Oracle Database Connection String [Ex: jdbc:oracle:thin:@::]: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 = oracleConnection = jdbc:oracle:thin:@dbserver:1521:blappUser = bladelogicPassword = ********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. Pleasewait...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 ESTAll selected components were transferred successfully.

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

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

BUILD SUCCESSFULTotal time: 11 minutes 20 seconds

Configuring Uninstallation Information

... Done


17/17


Removing temporary files. This may take a minute ...

=================== Installation Complete ====================

The installation is complete. You are now ready to begin usingBMC software. Don't forget to look at the Release Notes andany appropriate documentation in /usr/local/bmc/reports/Doc for more information.

For support please e-mail us [email protected]

________________________________________________________________________________

5. IF YOU ARE USING OM v7.4.x, Run create_om_smart_group_members_table_in_OM_database.sqlagainst 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
mailto:[email protected]:[email protected]:[email protected]:[email protected]

Bsara Install Cheat Sheet v1 1 2

Documents

Transcript of Bsara Install Cheat Sheet v1 1 2