Exporting KPIs

You can use the ExportKpis script to export one or more key performance indicators (KPI) to an XML file so that the XML file can be imported on another monitor instance.

Purpose

The ExportKpis script exports one or more KPIs to an XML file so that the XML file can be imported on another monitor instance. In a network deployment environment, run the ExportKpis script on the system where you deployed the monitor model moderator and logic modules.

Location

monitor_root/scripts.wbm/kpi/exportKpis.jy

Parameters

Parameter Description Comments
export_type One of: [ALL, MODELED, RUNTIME, SPECIFIED].  
KPI_list A list of kpiIds separated by commas. Applicable when export_type =SPECIFIED.
host_name The name of the host where IBM® Business Monitor is installed (this may be localhost).  
port_number The SOAP connector port of the WebSphere® Application Server server. Using the WebSphere Application Server administrative console, you can find this information by clicking Servers > Server Types > WebSphere application servers > server1 > Ports (SOAP_CONNECTOR_ADDRESS)  
Windows

Windows usage

For a stand-alone or network deployment IBM Business Monitor environment:
In an ND environment, run the command on the application cluster, on the system where you deployed the monitor model moderator and logic modules.

profile_root\bin> wsadmin -wsadmin_classpath "..\..\..\plugins\com.ibm.wbimonitor.lifecycle.spi.jar;..\..\..\plugins\com.ibm.wbimonitor.repository.jar" -lang jython -f "..\..\..\scripts.wbm\kpi\exportKpis.jy" "export_filename.xml" model_ID version_ID export_type [KPI_list] -conntype SOAP -host host_name -port port_number

where:
  • host_name is the stand-alone server or the deployment manager host name
  • port_number is the stand-alone server or the deployment manager port number (SOAP_CONNECTOR_ADDRESS)
For Rational® Application Developer development toolkit:

profile_root\bin> wsadmin -wsadmin_classpath "..\..\..\plugins\com.ibm.wbimonitor.lifecycle.spi.jar;..\..\..\plugins\com.ibm.wbimonitor.repository.jar" -lang jython -f "..\..\..\scripts.wbm\kpi\exportKpis.jy" "export_filename.xml" model_ID version_ID export_type [KPI_list] -conntype SOAP -host host_name -port port_number

For Integration Designer development toolkit:

profile_root\bin> wsadmin -wsadmin_classpath "..\..\..\plugins\com.ibm.wbimonitor.lifecycle.spi.jar;..\..\..\plugins\com.ibm.wbimonitor.repository.jar" -lang jython -f "..\..\..\scripts.wbm\kpi\exportKpis.jy" "export_filename.xml" model_ID version_ID export_type [KPI_list] -conntype SOAP -host host_name -port port_number

The following example is for a stand-alone environment:
exportKpis.jy "c:/kpiExport.xml" Mymodel 2007-12-31T23:59:59 SPECIFIED "Kpi1,Kpi2,Kpi3" -conntype SOAP -host localhost -port 8880
Linux Unix

Linux and UNIX usage

For a stand-alone or network deployment IBM Business Monitor environment:
(in an ND environment, run the command on the application cluster, on the system where you deployed the monitor model moderator and logic modules)

profile_root/bin> ./wsadmin.sh -wsadmin_classpath "../../../plugins/com.ibm.wbimonitor.lifecycle.spi.jar:../../../plugins/com.ibm.wbimonitor.repository.jar" -lang jython -f "../../../scripts.wbm/kpi/exportKpis.jy" "export_filename.xml" model_ID version_ID export_type [KPI_list] -conntype SOAP -host host_name -port port_number

where:
  • host_name is the stand-alone server or the deployment manager host name
  • port_number is the stand-alone server or the deployment manager port number (SOAP_CONNECTOR_ADDRESS)
The following example is for a stand-alone environment:
exportKpis.jy "/kpiExport.xml" Mymodel 2007-12-31T23:59:59 SPECIFIED "Kpi1,Kpi2,Kpi3" -conntype SOAP -host localhost -port 8880
The following is a network deployment example:
root@wbiaixp517 /usr/IBM/WebSphere/AppServer/profiles/Custom01/bin]#./wsadmin.sh -wsadmin_classpath "../../../plugins/com.ibm.wbimonitor.lifecycle.spi.jar:../../../plugins/com.ibm.wbimonitor.repository.jar" -lang jython -f "../../../scripts.wbm/kpi/exportKpis.jy" "/tmp/kpiExport.xml" model_ID version_ID ALL -conntype SOAP -host wbiaixp513 -port 8879