Configuring the cross-launch application
The probe is supplied with a launch-in-context feature that enables you to launch the SAM Fault Management Web app from Netcool/OMNIbus Web GUI Event Viewer right-click tool using two separate methods. Users can configure the GUI manually. Users may also configure the Web GUI using WAAPI which requires createCrossLaunchTool.xml and modifyAlertsMenu.xml.
Users must run addObjectFullName.sql
by running one of these commands according
to the platform to add ObjectFullName
field in alerts.status.
The files are located here:
On Unix:
$OMNIHOME/bin/nco_sql –server <objectserver_name> –user <username> –password <password> < <path_to_file>/addObjectFullName.sql
On Windows:
%NCHOME%\bin\redist\isql.exe -S <objectserver name> -U <username> -P <password> -i <path_to_file>\addObjectFullName.sql
The createCrossLaunchTool.xml, modifyAlertsMenu.xml and addObjectFullName.sql are located here:
$OMNIHOME/probes/<arch>/5620_SAM_CrossLaunch/
$OMNIHOME/probes/<arch>/5620_SAM_CrossLaunch/addObjectFullName.sql
addObjectFullName.sql
is required for the two methods. After running this, you
need to uncomment the following lines in the rules file:
#if (exists($objectFullName))
#{
#@ObjectFullName = $objectFullName
#}
Configure the Web GUI manually
To configure the Web GUI manually, complete the following steps.
- Edit the object server alerts.status table to add ObjectFullName field using sql file
addObjectFullName.sql
For example:
$OMNIHOME/bin/nco_sql -server NCOMS -username root -password
'' </opt/IBM/tivoli/netcool/omnibus/probes/
linux2x86/5620_SAM_CrossLaunch/addObjectFullName.sql - Login into the IBM Tivoli Netcool/OMNIbus WebGUI Dashboard Application Service
Hub.
https://<DASH IP or hostname>:16311/ibm/console
Refer to the IBM Tivoli Netcool/OMNIbus Web GUI Administration and User's Guide to create a new tool of script type named 5620SAM-CrossLaunch with the following inputs.
For example:
- Open the Event Management Tool (from the Dashboard's side bars)
- Select 'Tool Configuration' and create a new tool named "5620SAM-CrossLaunch"
- Choose type as script and input script as below:
var objName=’{@ObjectFullName}’; var samhost = ’127.0.0.1’;
var address = ’http://’ + samhost + ’/FaultManagement?view=alarmListImpacts&objectFullName=’+ objName;
window.open (address,"5620SAM Cross Launch"); - * replace the IP <127.0.0.1> with 5620 SAM IP / hostname accordingly
- Refer to IBM Tivoli Netcool/OMNIbus Web GUI Administration and User's Guide to perform
the menu configuration and modify alert menu to include 562SAM-CrossLaunch that should be created in
step 2 from available items.
For example:
- Click on "alerts" from the available menu and click on the "Modify" button.
- Add the 5620SAM-CrossLaunch tool that was previously created in step 2 from the available items to the current items.
- Click Save.
- Open Event Viewer.
- Click Refresh.
- Right click on one of the alarms received from SAM. You should see 5620SAM-CrossLaunch as an option.
Configure the Web GUI using WAAPI
To configure the Web GUI using the WAAPI, complete the following steps.
- Refer to the IBM Tivoli Netcool/OMNIbus Web GUI Administration API (WAAPI) User's Guide
to create a new tool by using createCrossLaunchTool.xml. 5620SAM-CrossLaunch must not exist before
this step.
For example:
- Go to WebGUI WAAPI bin dir.
- Modify the createCrossLaunchTool.xml to change the samhost in below line to your SAM EMS host ip or name and save the xml file.
- After reviewing and modifying createCrossLaunch.xml run this command:
$WAAPI_BIN_DIR/bin/runwaapi -file
$OMNIHOME/probes/<platforms>/5620_SAM_CrossLaunch/createCrossLaunchTool.xml
-username <WAS_USER_ID> -password <WAS_USER_PASSWORD>
- Refer to the IBM Tivoli Netcool/OMNIbus Web GUI Administration API (WAAPI) User's Guide
to modify the alert menu by using modifyAlertsMenu.xml.Note: Running the modifyAlertsMenu.xml will overwrite your existing alerts menu items. Make sure in modifyAlertsMenu.xml the content under modify.menu does not overwrite any of your existing items in the Alerts menu.
Make any changes if required, or you can run the manual step in above section to add in the newly created 5620SAM-CrossLaunch tool to the Event Viewer alerts right-click tool menu.
- After reviewing and modifying the modifyAlertsMenu.xml run this command:
$WAAPI_BIN_DIR/bin/runwaapi -file
$OMNIHOME/probes/<platforms>/5620_SAM_CrossLaunch/modifyAlertsMenu.xml
-username <WAS_USER_ID> -password <WAS_USER_PASSWORD> - Open Event Viewer and click Refresh.
- Right click on one of the alarms received from SAM. You should see 5620SAM-CrossLaunch as an option.