configurePerfDW command

Use the configurePerfDW command to configure Performance Data Warehouse on a server of cluster.

Purpose

This command provides a command line method to configure Performance Data Warehouse on a server or cluster.

After using the command, save your changes to the master configuration using one of the following commands:
  • For Jython:
    AdminConfig.save()
  • For Jacl:
    $AdminConfig save

Required parameters

-serverName
Specifies the name of the server you are configuring.
-nodeName
Specifies the name of the node you are configuring.
-clusterName
Specifies the name of the cluster you are configuring.
-dbDesign
Specifies the path to a database design document, which holds the database configuration for both Performance Data Warehouse and its Process Center / Process Server.

The value must be the complete path name for the database design file.

Optional parameters

-meServerName
Specifies the name of the messaging engine server for a remote configuration.

Include this value when the Bus Member resides on another server (not the server you are configuring currently).

-meNodeName
Specifies the name of the messaging engine node for a remote configuration.

Include this value when the Bus Member resides on another server (not the server you are configuring currently).

-meClusterName
Specifies the name of the messaging engine cluster for a remote configuration.

Include this value when the Bus Member resides on another cluster (not the cluster you are configuring currently).

-psServerName
Specifies the name of the Process Server for a remote configuration.

Include this value when the Process Server resides on another server (not the server you are configuring currently).

If you do not specify a value, the command assumes the server or cluster you are configuring is this server or cluster.

-psNodeName
Specifies the name of the Process Server node for a remote configuration.

Include this value when the Process Server resides on another server or cluster (not the server or cluster you are configuring currently).

If you do not specify a value, the command assumes the server or cluster you are configuring is this server or cluster.

-psClusterName
Specifies the name of the Process Server cluster for a remote configuration.

Include this value when the Process Server resides on another server or cluster (not the server or cluster you are configuring currently).

If you do not specify a value, the command assumes the server or cluster you are configuring is this server or cluster.

Examples

Note: The examples are for illustrative purposes only. They include variable values and are not meant to be reused as snippets of code.
The following example uses configurePerfDW to configure Performance Data Warehouse on AppServer. The database configuration in the dbDesign document includes configuration data for both Process Server and Performance Data Warehouse.
  • Jython example:
    AdminTask.configurePerfDW('[-serverName AppServer -nodeName node1
      -meNodeName me_node1 -meServerName pdwsvr -dbDesign C:/dbDesigns/procsvr.dbDesign]')
  • Jacl example:
    $AdminTask configurePerfDW { -serverName AppServer -nodeName node1
       -meNodeName me_node1 -meServerName pdwsvr -dbDesign C:/dbDesigns/procsvr.dbDesign}
The following example uses configurePerfDW to configure Performance Data Warehouse on AppServer. The database configuration in the dbDesign document includes configuration data for both Process Center and Performance Data Warehouse.
  • Jython example:
    AdminTask.configurePerfDW('[-serverName AppServer -nodeName node1
      -meNodeName me_node1 -meServerName pdwsvr -dbDesign C:/dbDesigns/pctrsvr.dbDesign]')
  • Jacl example:
    $AdminTask configurePerfDW { -serverName AppServer -nodeName node1
       -meNodeName me_node1 -meServerName pdwsvr -dbDesign C:/dbDesigns/pctrsvr.dbDesign}
The following example uses configurePerfDW to configure Performance Data Warehouse on cluster Cluster1. The database configuration in the dbDesign document includes configuration data for both Process Server and Performance Data Warehouse.
  • Jython example:
    AdminTask.configurePerfDW('[-clusterName Cluster1 
      -meClusterName MessagingEngine1 -dbDesign C:/dbDesigns/procsvr.dbDesign]')
  • Jacl example:
    $AdminTask configurePerfDW { -clusterName Cluster1 
      -meClusterName MessagingEngine1 -dbDesign C:/dbDesigns/procsvr.dbDesign }
The following example uses configurePerfDW to configure Performance Data Warehouse on cluster Cluster1. The database configuration in the dbDesign document includes configuration data for both Process Center and Performance Data Warehouse.
  • Jython example:
    AdminTask.configurePerfDW('[-clusterName Cluster1 
      -meClusterName MessagingEngine1 -dbDesign C:/dbDesigns/pctrsvr.dbDesign]')
  • Jacl example:
    $AdminTask configurePerfDW { -clusterName Cluster1 
      -meClusterName MessagingEngine1 -dbDesign C:/dbDesigns/pctrsvr.dbDesign }