HCL Workload Automation, Version 9.4

Generating the plugin-cfg.xml file

Run GenPluginCfg.bat to generate the plugin-cfg.xml file and save it in JazzSM_WAS_Profile/config/cells.

About this task

Complete this procedure to generate the plug-cfg.xml file. You must carry out these steps on each node.

Important: You must run GenPluginCfg.bat to generate a new plugin-cfg.xml file each time that a dashboard application is installed into a load balanced Jazz™ for Service Management application server environment.

Procedure

On a node, change to JazzSM_WAS_Profile/bin/ and run the following command:
- GenPluginCfg.bat
- GenPluginCfg.sh
This command generates a file that is named plugin-cfg.xml and saves it to the JazzSM_WAS_Profile/config/cells directory.

On the IBM HTTP Server, in the following directory, replace the existing plugin-cfg.xml with the version generated in step 1:

HTTP_web_server_install_dir/plugins/config/webserver1

The following steps establish the new /hcl/* URI (Uniform Resource Identifier), which is where the plug-in redirects requests:

On the IBM HTTP Server, change to the directory where the web server definition file is (such as, cd plugins/config/webserver1).
Open the plugin-cfg.xml file in a text editor and edit the file to provide details of your IBM HTTP Server and all Jazz for Service Management application server instances. Refer to the sample content provided to assist you in editing plugin-cfg.xml. For more information about the plugin-cfg.xml file, see the reference material at: http://www-01.ibm.com/support/knowledgecenter/SSAW57_8.5.5/com.ibm.websphere.nd.doc/ae/rwsv_plugincfg.html.
Note: Where the provided sample differs from the WebSphere Application Server reference information, the WebSphere Application Server takes precedence.
- HTTP SERVER PATH is the path to where the HTTP server is installed.
- HTTP SERVER PORT is the port for the HTTP server.
- SERVER1 is the fully qualified name of the computer where the Jazz for Service Management application server is installed and started.
- SERVER2 is the fully qualified name of the computer where another Jazz for Service Management application server is installed and started.
- CLONE_ID is the unique clone ID assigned to a particular node (server) in the cluster.
In the ServerCluster section, the value for the keyring property must be HTTP SERVER PATH /plug-ins/etc/plug-in-key.kdb and the value for the stashfile property must be HTTP SERVER PATH /plug-ins/etc/plug-in-key.sth.
Continue to add Server entries for any other nodes, following the same pattern. Add an entry under PrimaryServers for each additional server.

Add CloneID and LoadBalanceWeight attributes for every Server entry.

Important: For more information about the web server plug-in workload management policies and to help you determine the appropriate values for the elements LoadBalance and LoadBalanceWeight, see:

Attention: The HTTP and HTTPS port values for all nodes must be the same.

While the following extract is from an IBM® HTTP Server Version 7.0 plugin-cfg.xml, its contents are still relevant. Some details are changed for IBM HTTP Server Version 8.5. For more information about the format of the plugin-cfg.xml file in IBM HTTP Server Version 8.5, see:plugin-cfg.xml file

<Config ASDisableNagle="false" IISDisableNagle="false" IgnoreDNSFailures="false" RefreshInterval="60" ResponseChunkSize="64" AcceptAllContent="false" IISPluginPriority="High" FIPSEnable="false" AppServerPortPreference="HostHeader" VHostMatchingCompat="false" ChunkedResponse="false"> 
	<Log LogLevel="Trace" Name="HTTP SERVER PATH/Plugins/logs/webserver1/http_plugin.log"/> 
	<Property Name="ESIEnable" Value="true" /> 
	<Property Name="ESIMaxCacheSize" Value="1024" /> 
	<Property Name="ESIInvalidationMonitor" Value="false" /> 
	<Property Name="ESIEnableToPassCookies" Value="false" /> 
	<Property Name="PluginInstallRoot" Value="HTTP SERVER PATH/Plugins" /> 
	<VirtualHostGroup Name="default_host"> 
		<VirtualHost Name="*:16310" /> 
		<VirtualHost Name="*:80" /> 
		<VirtualHost Name="*:16311" /> 
		<VirtualHost Name="*:5060" /> 
		<VirtualHost Name="*:5061" /> 
		<VirtualHost Name="*:443" /> 
   <VirtualHost Name="*:HTTP SERVER PORT"/>
	</VirtualHostGroup> 
 <ServerCluster CloneSeparatorChange="false" GetDWLMTable="false" IgnoreAffinityRequests="true" LoadBalance="Round Robin" Name="server1_Cluster" PostBufferSize="64" PostSizeLimit="-1" RemoveSpecialHeaders="true" RetryInterval="60"> 
	<Server Name="TIPNode1_server1" ConnectTimeout="0" CloneID="CLONE_ID" ExtendedHandshake="false" ServerIOTimeout="0" LoadBalanceWeight="100" MaxConnections="-1" WaitForContinue="false"> 
		<Transport Hostname="SERVER1" Port="16310" Protocol="http"/> 
 	<Transport Hostname="SERVER1" Port="16311" Protocol="https"> 
			<Property name="keyring" value="HTTP SERVER PATH\Plugins\config\webserver1\plugin-key.kdb"/> 
			<Property name="stashfile" value="HTTP SERVER PATH\Plugins\config\webserver1\plugin-key.sth"/> 
		</Transport> 
		</Server> 
<Server Name="TIPNode1_server2" ConnectTimeout="0" CloneID="CLONE_ID" ExtendedHandshake="false" ServerIOTimeout="0" LoadBalanceWeight="100" MaxConnections="-1" WaitForContinue="false">
  		<Transport Hostname="SERVER2" Port="16310" Protocol="http"/>
   	<Transport Hostname="SERVER2" Port="16311" Protocol="https">
  			<Property name="keyring" value="HTTP SERVER PATH\Plugins\config\webserver1\plugin-key.kdb"/>
  			<Property name="stashfile" value="HTTP SERVER PATH\Plugins\config\webserver1\plugin-key.sth"/>
  		</Transport>
  		</Server> 
		<PrimaryServers> 
      <Server Name="TIPNode1_server1" /> 
			<Server Name="TIPNode1_server2" /> 
		</PrimaryServers> 
	</ServerCluster> 
	<UriGroup Name="server1_Cluster_URIs"> 
		<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/ivt/*" /> 
		<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/HCL_WS_SYS_RESPONSESERVLET/*" /> 
		<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/HCL_WS_SYS_RESPONSESERVLET/*.jsp" /> 
		<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/HCL_WS_SYS_RESPONSESERVLET/*.jsv" /> 
		<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/HCL_WS_SYS_RESPONSESERVLET/*.jsw" /> 
		<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/HCL_WS_SYS_RESPONSESERVLET/j_security_check" /> 
		<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/HCL_WS_SYS_RESPONSESERVLET/hcl_security_logout" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/hcl/console/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/hcl/help/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/hcl/action/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/ISCWire/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/isc/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/ISCHA/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/tip_ISCAdminPortlet/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/ISCAdminPortlets/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/mum/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/hcl/TIPChangePasswd/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/hcl/TIPExportImport/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/hcl/tivoli/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/proxy/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/TIPWebWidget/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/hcl/dbfile/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/hcl/TIPChartPortlet/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/TIPUtilPortlets/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/WIMPortlet/*" /> 
		<Uri AffinityCookie="JSESSIONID_ibm_console_16310" AffinityURLIdentifier="jsessionid" Name="/SysMgmtCommonTaskGroups/*" /> 
		<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/hcl/tivoli/*"/>
		<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/hcl/console/*"/>
		<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/ITMOSD/*"/>
	</UriGroup> 
	<Route ServerCluster="server1_Cluster" UriGroup="server1_Cluster_URIs" VirtualHostGroup="default_host" /> 
	<RequestMetrics armEnabled="false" newBehavior="false" rmEnabled="false" traceLevel="HOPS"> 
		<filters enable="false" type="URI"> 
			<filterValues enable="false" value="/snoop" /> 
			<filterValues enable="false" value="/hitcount" /> 
		</filters> 
			<filters enable="false" type="SOURCE_IP"> 
			<filterValues enable="false" value="255.255.255.255" /> 
			<filterValues enable="false" value="254.254.254.254" /> 
		</filters> 
		<filters enable="false" type="JMS"> 
			<filterValues enable="false" value="destination=aaa" /> 
		</filters> 
		<filters enable="false" type="WEB_SERVICES"> 
			<filterValues enable="false" value="wsdlPort=aaa:op=bbb:nameSpace=ccc" /> 
		</filters> 
	</RequestMetrics> 
</Config>