Migrating KPIs

You can use the MigrateKpis script to migrate one or more key performance indicators (KPI) from a model version to a new model version. Note that the new model version must have been previously created on the monitor instance.

Purpose

The MigrateKpis script migrates one or more KPIs from a model version to a new model version. In a network deployment environment, run the MigrateKPIs script on the system where you deployed the monitor model moderator and logic modules.

Location

monitor_root/scripts.wbm/kpi/migrateKpis.jy

Parameters

Parameter Description Comments
migrate_type One of: [ALL, MODELED, RUNTIME, SPECIFIED].  
KPI_list A list of kpiIds separated by commas. applicable only 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\migrateKpis.jy" model_ID from_version_ID to_version_ID migrate_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\migrateKpis.jy" model_ID from_version_ID to_version_ID migrate_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\migrateKpis.jy" model_ID from_version_ID to_version_ID migrate_type [KPI_list] -conntype SOAP -host host_name -port port_number

The following example is for a stand-alone environment:
migrateKpis.jy 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/migrateKpis.jy" model_ID from_version_ID to_version_ID migrate_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)
z/OS
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/migrateKpis.jy" model_ID from_version_ID to_version_ID migrate_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:
migrateKpis.jy Mymodel 2007-08-31T23:59:59 2007-12-31T23:59:59 SPECIFIED "Kpi1,Kpi2,Kpi3" -conntype SOAP -host localhost -port 8880