Section 1 - Planning - Given vendor documentation, customer documentation, and requirements, validate customer environment, so that customer requirements are fulfilled and TBSM is ready to install.
- Verify Operating Systems
- Verify OS patches
- Verify DNS
- Identify non root login
- Determine disk space
- Determine memory
- Determine failover configuration
- Determine authentication types
- Given business service information, determine which services to monitor, service dependencies, service-affecting events and data, and create a diagram so that all service dependencies are shown.
With emphasis on performing the following tasks: - Determine the highest-level services to monitor
- Determine what applications, devices, etc. that support the high-level services
- Determine how the lower-level services affect the higher-level services
- Determine what events and/or data affects each service type
- Given TBSM prerequisites, server information, and expected product load information, verify the prerequisites are met, create a deployment plan, so that business objectives are met.
With emphasis on performing the following tasks: - Ensure the prerequisites for TBSM product are met
- Determine TBSM installation plan (simple or advanced; 1 host, 2 hosts, or 4 hosts)
Section 2 - Installation - Given the installation media and prerequisites for TBSM, install TBSM using the installation program so that all TBSM components are installed.
With emphasis on the following steps:
- Create TBSM user. (Unix: local non root user id with shell capabilities, Windows: user that is a member of the local administrator group, not a user that is a member of the domain administrator group)
- Obtain installation media
- Ensure prerequisites for TBSM product are met
- Run installation program using launchpad.sh (Windows: launchpad.exe)
- Given a running ObjectServer and TBSM server, discover the ObjectServer schema so that TBSM events appear in the ObjectServer.
With emphasis on the following steps:
- Run $NCHOME/bin/rad_discover_schema ObjectServer
- Run $NCHOME/bin/rad_discover_schema OutputObjectServer
- Verify that TBSM events are appearing in ObjectServer
Section 3 - Configuration - Given the customer requirements, service model requirements, product manuals, maintenance schedules, edit log levels and maintenance schedules, verify OMNIbus connection, and configure properties, so that a TBSM server settings are configured.
With emphasis on the following steps:
- Edit log detail levels (RAD_server.props, RAD_policylogger.props, and log4j.properties)
- Edit maintenance schedules using the GUI
- Edit scheduleTime.xml file to delete a maintenance schedule
- Configure properties (Servicetree refresh interval, service model timeout, discriminator field, default
service viewer type) in RAD_sla.props and RAD_av.props.
- Given a Data Source type and the correct Data Source connectivity information, and assuming they exist and work, create a Data Source mapping within TBSM so that external information can affect the status of services in a service model.
With emphasis on the following steps:
- Login to TBSM
- Switch to Service Administration Page
- Click the Data tab
- Click the New button
- Enter the Data Source Settings and connectivity information
- Click Test Data Source
- Save
- Given the query data, a timing interval, and an existing data source name, create a Data Fetcher so that results are returned to TBSM.
With emphasis on the following steps:
- Login to TBSM
- Switch to Service Administration Page
- Click the Data Fetcher tab
- Click the New button
- Enter unique name for data fetcher
- Select the Data Source
- Enter the SQL Query
- Enter the expression for the SQL query
- Set up interval
- Click the View button
- Given access to TBSM, service template and service instance information, configure a service template and service instance so that a service model is displayed.
With emphasis on the following steps:
- Login to TBSM
- Switch to Service Administration Page
- Select Templates tab
- Click New button
- Enter the template settings
- Create template rules
- Save service template
- Switch to Service Administration Page
- Select Services tab
- Click New button
- Enter the service instance settings
- Select service template
- Click on Identification field tab
- Enter field value
- Save service instance
- Given the SSL certificate was created or purchased, TBSM installed, server login information, create SSL Secured Access to the TBSM server so that customer data is protected.
With emphasis on the following steps:
- Security Manager SSL Authentication:
- Login to the SecurityManager server
- Create SecurityManager Server Certificate
- Add the certificate properties to SM_servletservice.props
- Encrypt the keypass password
- Configure SM_server.props
- TBSM SSL Authentication
- Login to the TBSM server
- Create SecurityManager Server Certificate (if different from NCSM)
- Add the certificate properties to server.props
- Configure server.xml
- Given access to TBSM and an existing and configured Data Source, Data Fetcher, and service template, create AutoPopulation rules in a template so that a Service is created automatically.
With emphasis on the following steps:
- Login in to TBSM
- Switch to Service Administration Page
- Click on Templates tab
- Edit the template
- Click Create Auto-Population Rules button
- Enter unique rule name
- Select incoming status rule
- Enter Auto-Population information
- Repeat step 8 for any parent configuration
- Save service template
- Given an existing template and access to TBSM, create rules so that an enriched event can be displayed on the service model.
With emphasis on the following steps:
- Edit template
- Create dependency rule by clicking on Rule tab
- Select outage information
- Save
- Edit template
- Create incoming status rule by clicking on Rule tab
- Determine whether to create good/marginal/bad rule or numerical rule
- Enter the rule settings
- Save
- Edit template
- Given an existing service template, data sources, and product documentation, create a service using ESDA so that the ESDA rule is configured.
With emphasis on the following steps:- Edit template
- Create ESDA rule by clicking on Rule tab
- Determine whether the ESDA is a child or parent rule
- Select Data Source
- Enter SQL query
- Enter expressions field information
- Verify selected template
- Click Enabled
- Given an existing service instance and existing user or group, add security permissions to service instance so that access to view or edit the server instance is restricted.
With emphasis on the following steps:
- Edit service instance
- Click the Security tab
- Select users or groups
- Select privilege
- Save service instance
Section 4 - Customization - Given the customer page template was verified, product documentation, TBSM installed, and admin user defined, create a custom page using customer specified layouts and viewpoints so that a custom page is properly displayed.
With emphasis on the following steps:
- Login to the TBSM GUI with admin user
- Switch to the Adminstration page
- Switch to the layout tab
- Click the add button
- Type in the page name and page title
- Select correct category name and value
- Click add
- Edit the page from the designated view
- Select layout (menu pane, one column, tab pane, three columns, two columns, state-maintained tab pane)
- Select Security ID ( user only, default, admin view only, admins only, user view only)
- Add designated viewpoint (active event list, chartview, iframe example, lightweight event list, mapview, service details, service tree, service viewer, table view, urgent service, version information, end of viewpoints), pane, or view
- Organize viewpoints as specified by the template
- Select decoration as specified by the template
- Save the page
- Given a TBSM install, Admin user defined, service model, product documentation, and canvas template, create a custom canvas in the appropriate way, add and organize indicator icons and decorations, select the background color, and save the canvas so that the custom canvas can be displayed.
With emphasis on the following steps:
- Login to TBSM install with admin user
- Switch to the Service administration page
If the canvas should be tied to an instance:- Display the instance in the service viewer
- Click the create canvas button from the service viewer
If the canvas shouldn't be tied to an instance:- Click the Custom canvases selector
- Click the Create custom canvas button
- Add the indicator icons as specified by the predefined canvas template
- When adding indicator icons, specify correct rules for each value
- Organize icons on the canvas
- Add and organize decorations
- Select background color
- Save canvas
If canvas is not tied to a service instance, supply name as defined by client
- Given a TBSM install, admin user defined, existing custom page, templates, metric rules, data sources, data fetchers, and product documentation, create a new tree template which defines the templates to be used and data to be displayed so that a custom scorecard is created to display external data.
With emphasis on the following steps:
- Login to the TBSM GUI with the admin user
- Switch to the Service administration page
- From the services selector, click the tree template editor button
- Create a new tree template
- Select the new tree template
- Change sizing for columns to be displayed
- Create the columns to be displayed on the custom scorecard
- Select templates to be used
- For each template, select the user defined metric/incoming status rule or system defined rule
- Relate each rule that is selected to a column on the tree
- Edit the policy to customize what is displayed in the column, such as value being received, or custom icon
- Save the Tree template
- Switch to the custom page where the custom service tree should be located
- Edit the service tree viewpoint
- Select the new tree template and the starting service instance
- Given the client's custom images, customize the TBSM page header and viewpoint header, as well as the custom service tree icons, so that TBSM displays the customer's header images. and custom service tree icons.
With emphasis on the following steps:
- Place all custom background header images in the appropriate directory
- Edit the background-image for the file: $NCHOME/guifoundation/webapps/desktop/css/ngf/ngf.css to point TBSM to display new header images in the following sections:
Table.netcool-topheader Td.netcool-topheader-left Td.netcool-topheader-right- Edit the background-image for the file:
- $NCHOME/guifoundation/webapps/desktop/css/viewpoint.css to point TBSM to display new viewpoint header images in the following sections: table.vp_header td.vp_header_left table.vp_header vp_header_title table.vp_header td.vp_header_right
- Given the custom icons and defined service model, customize TBSM, so that the client service tree displays custom icons.
With emphasis on the following steps:
- Place all custom icon images in the following directory: $NCHOME/guifoundaiton/webapps/sla/images
- Edit the following policy to change the icon based on the current column by using the tree template
editor in the TBSM GUI. @Change the VALUE variable for each icon that should display if the column name is customized, based on the icon that would normally be displayed - Save policy
Section 5 - Operations - Given the dependencies between all four TBSM components, perform correct starting order (1.License Server 2.Omnibus 3.Security Manager 4.TBSM) and stopping order (1.TBSM 2.Security Manager 3.Omnibus 4.License Server) of all four components so that all four components will function properly and will allow for a login to the tbsm console.
With emphasis on the following steps:
- The order of starting TBSM components are:
- Start IBM Tivoli Netcool Common License Server
Unix - $NCHOME/license/bin/nc_start_license Windows net start NCO Flex License Manager or can start from services panel - Start IBM Tivoli Netcool OMNIBus
Unix - $OMNIHOME/bin/nco_objserv & Windows net start Netcool/OMNIbus Object Server - Start IBM Tivoli Netcool Security Manager
Unix - $NCHOME/security/bin/ncsm_server & Windows net start Netcool Security Manager Server - Start TBSM
Unix - $NCHOME/bin/rad_server Windows - net start Netcool Postgres Database net start Netcool GUI Foundation Server
- The order of stopping TBSM components are:
- Stop TBSM
Unix - $NCHOME/bin/rad_shutdown Windows - net stop Netcool GUI Foundation Server, net stop Netcool Postgres Database - Stop IBM Tivoli Netcool Security Manager
Unix - $NCHOME/security/bin/ncsm_shutdown Windows net stop Netcool Security Manager Server - Stop IBM Tivoli Netcool OMNIBus
Unix - $OMNIHOME/bin/nco_sql -S NCOMS -U root -P "" alter system shutdown go Exit Windows - net stop Netcool/OMNIbus Object Server - Stop IBM Tivoli Netcool Common License Server
Unix - $NCHOME/license/bin/nc_stop_license Windows - net stop NCO Flex License Manager or can stop from services panel
- Given that you have configured a service model, use the rad_sendevent utility to send test events to the TBSM ObjectServer so that one can confirm that the services in the model respond to service-affecting ObjectServer events properly.
With emphasis on the following steps:
- Issue the rad_sendevent command using the following syntax:
rad_sendevent <ObjectServer host> <ObjectServer port> <ObjectServer userid> <ObjectServer Password or ""> where: ObjectServer host - Name of host machine running the ObjectServer monitored by TBSM ObjectServer port - Port number for the ObjectServer monitored by TBSM ObjectServer userid - The user name needed to access the ObjectServer ObjectServer Password - Password for the Userid. Enter "" for no password - After issuing the rad_sendevent command, a READY prompt will appear and then type the field name
- Press the enter key
- Type the field value pair on the next line
- Press the enter key again
- When finished typing the field name and value pairs for an event, press the enter key twice.
- Then either send another event, or press the Ctrl-C keys to exit rad_sendevent.
- Given TBSM 4.1.1 is installed and object server is running, modify the OMNIbus schema using the tbsm_db_update.sql file so that the additional fields are now imported to the alerts.status table and an additional table called alerts.service_deps is also added into the schema of the object server.
With emphasis on the following steps:
- Verify the tbsm_db_update.sql file is located in the appropriate directory.
- Modify the OMNIbus Object server schema by issuing the following command:
cat $NCHOME/guifoundation/webapps/sla/install/ tbsm_db_update.sql | $OMNIHOME/bin/nco_sql -server <servername> -user <username> -password <password> where: servername is the name of the ObjectServer you want to create for Netcool/RAD. username is the Objectserver user name. password is the Objectserver password.
- Given that a file is manually edited in the $NCHOME/guifoundation/webapps/sla/av/xmlconfig and $NCHOME/guifoundation/webapps/sla/av/css directories, issue the rad_reinitcanvas script so that you see the changes from the tbsm gui without having to restart the RAD server.
With emphaiss on the following steps:
- Edit any file manually within the following directories: $NCHOME/guifoundation/webapps/sla/av/css and $NCHOME/guifoundation/webapps/sla/av/xmlconfig
- Execute $NCHOME/bin/rad_reinitcanvas (Windows: %NCHOME%/bin/rad_reinitcanvas.bat)
- View the service tree to see changes
- Given the desired services, templates, data fetchers, data sources are configured on another TBSM server, perform the exporting and importing of service configuration using radshell function so that services are configured successfully without having to manually create them again.
With emphasis on the following steps:
- On the TBSM server with existing services configured, use the radshell export function
@execute $NCHOME/bin/rad_radshell @When the prompt changes to radshell>, type export (); @Press enter @When finished exporting, then type exit (); @Press enter (All of the service templates, services, data fetchers, and data sources are now written to a file named export.radsh in the $NCHOME/guifoundation/webapps/sla directory.)- Copy the export.radsh file into the $NCHOME/guifoundation/webapps/sla directory of the
TBSM server you want to import the services to - Import the file into that TBSM server, enter the command: cat export.radsh | $NCHOME/bin/rad_radshell
Section 6 - Troubleshooting - Given Statement: Given a TBSM 4.1.1 install failure on Windows platform with MSIEXEC error 1603 in install logs and a console error �Insufficient space in Javaheap to satisfy allocation request', first uninstall TBSM including removing the %NCHOME% directory and when reinstalling TBSM make sure the pgservice user is created using the correct guidelines so that the TBSM install will not fail due to the rights of the pgservice user.
With emphasis on the following steps:
- Make sure failed install is cleaned up.
- Stop all Netcool Services (must have rebooted since original installation).
- Start > Control Panel > Add or remove programs; select IBM® Tivoli® Business Service Manager (TBSM) and the Change/Remove button.
- Read the information on the Welcome panel and click Next.
- On this panel, all the features that have been installed are selected by default. Select the
features to uninstall and click Next. - Read the listing of features that will be removed. Click Uninstall.
- Read the post-uninstallation summary information and click Finish.
- Reboot the computer after the uninstallation process finishes.
- If all components have been uninstalled, remove the %NCHOME% directory
- Given a TBSM 4.1.1 install failure on Unix platform, and subsequent installation attempts also fail with 'Import of the schema failed', uninstall TBSM using the �uninstaller.bin', delete the file /var/tmp/locknetcool , login as a non-root user and reinstall TBSM so that a successful install is achieved.
With emphasis on the following steps:
- cd $NCHOME/_uninst and run ./uninstaller.bin
- Delete the file: /var/tmp/locknetcool (/var/tmp/locknetcool file remains from a previous installation attempt. License server fails to start and as a result, the OMNIbus Object Server installation also fails (failure to import
schema into the Object Server). - Installation must be done by someone with a non-root userid. The TBSM 4.1.1 installation
program does not support logging in as root and then switching from root to a different userid. If you are logged in as root, logout and then login using a non-root userid. - Re-install TBSM 4.1.1.
- Given an upgrade from TBSM 4.1 to TBSM 4.1.1 on Windows with the TBSM Reports component, out of memory errors occur after you view a few reports and TBSM server stops running, set the registry entries for JVM options for the NCGFServer service executable so that the server should continue running when reviewing reports.
With emphaiss on the following steps:
- Set the registry entries for JVM options for the NCGFServer service executable as follows:
- If it is running, stop the Netcool GUI Foundation Server service.
- To open the Registry Editor, select: Start->Run-> and enter regedit in the window that opens.
- From the Registry Editor, select:
HKEY_LOCAL_MACHINE -> SOFTWARE -> Apache Software Foundation -> Procrun2.0 -> NCGFServer -> Parameters -> Java- To see the JVM options, double click on Options in the right-hand column.
- In the Edit Multi-String window, add these parameters:
-XX:MaxPermSize=128m -XX:+DisableExplicitGC- Start the Netcool GUI Foundation Server service.
|