[AIX HP-UX Linux Solaris Windows]

Configuring a web server plug-in using the pct tool

The WCT command-line utility invokes the command-line tool that is specified by the -tool parameter. You can use the WCT command-line utility and specify the pct tool to configure a web server to use an application server as a hosting server.

Procedure

Configure a web server to use an application server as a hosting server.
Location of the WCT command
The product includes the following script that sets up the environment and invokes the WCT command.
  • WCT_install_root\WCT\wctcmd.bat
  • WCT_install_root/WCT/wctcmd.sh
Syntax of the WCT command when invoking the pct tool
wctcmd.bat
      -tool pct
      -defLocPathname definition_location_pathname
      -createDefinitionLocation definition_location_name
      -importDefinitionLocation definition_location_name
      -removeDefinitionLocation definition_location_name
      -defLocName definition_location_name
      -defLocVersion definition_location_version
      -response response_file
      -listDefinitionLocations
      -deleteDefinition definition_name
      -listDefinitions
./wctcmd.sh
      -tool pct
      -defLocPathname definition_location_pathname
      -createDefinitionLocation definition_location_name
      -importDefinitionLocation definition_location_name
      -removeDefinitionLocation definition_location_name
      -defLocName definition_location_name
      -defLocVersion definition_location_version
      -response response_file
      -listDefinitionLocations
      -deleteDefinition definition_name
      -listDefinitions
Parameters of the WCT command when invoking the pct tool
-tool pct
Specifies the name of the tool to launch as it is registered with the WCT command-line utility

This parameter is required.

-defLocPathname definition_location_pathname
Specifies the absolute path name of the definition location to use when the specified tool is launched

This parameter is required.

-createDefinitionLocation definition_location_name
Specifies that the WCT command-line utility should create a definition location

This parameter is optional.

-importDefinitionLocation definition_location_name
Specifies that the WCT command-line utility should import a definition location

This parameter is optional.

-removeDefinitionLocation definition_location_name
Specifies that the WCT command-line utility should remove a definition location

This parameter is optional.

-defLocName definition_location_name
Specifies the name of the definition location as it resides in the definition location registry
-defLocVersion definition_location_version
Specifies the version of definition location to create

This parameter is optional.

-response response_file
Specifies the response file containing tool arguments

This parameter is optional.

-listDefinitionLocations
Lists the available definition locations.
-deleteDefinition definition_name
Specifies that the WCT command-line utility should delete a definition

This parameter is optional.

The definition_name is required. Either one of the following parameters is also required:
  • -defLocName definition_location_name
  • -defLocpathname definition_location_pathname
If both parameter values are supplied, the first one is used. If the first value supplied does not pass the validation check, the command fails with an error message.
-listDefinitions
Lists the available definitions at a specified definition location or definition location path name
Either one of the following parameters is required:
  • -defLocName definition_location_name
  • -defLocpathname definition_location_pathname
If both parameter values are supplied, the first one is used. If the first value supplied does not pass the validation check, the command fails with an error message.
Notes:
  • Command-line arguments are case sensitive.
  • If an argument accepts a value containing spaces, the value must be enclosed in double quotes (" ").
Parameters of the pct tool
General parameters
configType
Specifies the configuration type
local_standalone
WebSphere® Application Server and web server on same machine
remote
WebSphere Application Server and web server on separate machines
local_distributed
Profile on WebSphere Application Server is federated to a deployment manager
wasExistingLocation
Specifies the location of the WebSphere Application Server installation home directory

This option is valid only for a local configuration type.

webServerSelected
Specifies the web server to be configured
apache22
Apache Web Server Version 2.2
domino7
Lotus® Domino® Web Server Version 7.0

Not supported on HP-UX or Solaris x64 (x86_64)

domino8
Lotus Domino Web Server Version 8.0

Not supported on HP-UX or Solaris x64 (x86_64)

ihs
IBM® HTTP Server Version 7.0
iis6
Microsoft Internet Information Services Version 6

Supported on Windows

iis7
Microsoft Internet Information Services Version 7

Supported on Windows

sunone
Sun Java System Web Server Version 6.1 or Sun Java System Web Server Version 7.0

Specify only one web server to configure.

ihsAdminPort
Specifies the HTTP administration port number

Specify this value only when configuring IHS.

ihsAdminUserID
Specifies the IHS administrator user ID for the IHS administration server

Specify this value only when configuring IHS.

ihsAdminUserGroup
Specifies the user group for the IHS administration server

Specify this value only when configuring IHS.

webServerConfigFile1
Specifies the first web server configuration file
apache
httpd.conf
domino7
notes.jar
domino8
notes.jar
ihs
httpd.conf
sunone
magnus.conf

The specified file must exist.

webServerConfigFile2
Specifies the second web server configuration file
domino7
names.jar
domino8
names.jar
sunone
obj.conf

The specified file must exist.

webServerPortNumber
Specifies the web server port for the web server to be configured
dominoUserID
Specifies the Domino Version 7.0 or 8.0 user ID
webServerDefinition
Specifies the web server definition name

No spaces are allowed in the web server definition name.

wasMachineHostName
Specifies the WebSphere Application Server machine hostname
For a remote installation type:
"hostname"

Installation will use the hostname hostname on the machine.

For a local installation type:
""

The hostname of the target installation machine will be used.

This specification can be omitted for a local_standalone installation type.
Advanced parameters (available in silent installations only)
mapWebserverToApplications
Specifies whether or not to map all the existing deployed applications to the web server
true
The web server definition is mapped as a target to the existing deployed applications such as snoop and hit count. (Recommended)
false
No applications are mapped to the web server definition.
If this not set to a valid option, the installer will set it to true and continue the installation.
webServerHostName
In advanced scenarios where a user has multiple web server hostnames on a machine, specifies the web server hostname used to configure
""
Installation will resolve to the hostname detected on the machine. (Recommended)
"hostname"
Installation will use the hostname hostname on the machine.
webServerInstallArch
Specifies the web server installation architecture
"32"
Valid for 32-bit web server installations
"64"
Valid for 64-bit web server installations
""
Architecture of the web server machine will be used
profileName
Specifies the name of the WebSphere Application Server profile to be configured
"profile_name"
You must enter the name of an existing WebSphere Application Server profile.

Leaving the string empty will result in the installer using the default profile.

This option is valid only in local installation scenarios.

ihsWindowsStartupType
Specifies the startup type of the IHS administrative service that is to be created on Windows
automatic
Service will automatically start when the system is booted up.
manual
Service will start only when requested.

Specify this value only when configuring IHS.

ihsAdminWinUserID
Specifies the ID of the user that will be used to configure the IHS administrative server on Windows
"IHS_admin_user_ID"
You must enter the name that will be used to configure the IHS administrative server.

Specify this value only when configuring IHS.

ihsAdminWinPassword
Specifies the password of the user that will be used to configure the IHS administrative server on Windows
"IHS_admin_password"
You must enter the password of the user that will be used to configure the IHS administrative server.

Specify this value only when configuring IHS.

ihsAdminPassword
Specifies the user password to the IHS administrative server to be configured
"IHS_admin_password"
You must enter the password of the user that will be used to configure the IHS administrative server.

Specify this value only when configuring IHS.

enableAdminServerSupport
Specifies whether or not to configure the IHS administrative server
true
Support will be enabled and the IHS administrative server will be configured.
false
Support will not be enabled and the IHS administrative server will not be configured.

Specify this value only when configuring IHS.

enableUserAndPass
Specifies whether or not to enable support to configure the IHS administrative server with a user ID and password as credentials
true
Support to configure the IHS administrative server with a given user ID and password will be enabled.

The additional relevant credentials must be supplied.

false
Support to configure the IHS administrative server with a given user ID and password will not be enabled.

No additional values are required.

Specify this value only when configuring IHS.

enableWinService
Specifies whether or not to configure the IHS administrative server to run as a Windows service
true
Support to configure the IHS administrative server as a Windows service will be enabled
false
Support to configure the IHS administrative server as a Windows service will not be enabled.

Specify this value only when configuring IHS.

webServerType
Specifies the type of web server to be configured
APACHE
Apache Web Server Version 2.2
DOMINO
Lotus Domino Web Server Version 7.0 or Version 8.0

Not supported on HP-UX or Solaris x64 (x86_64)

IHS
IBM HTTP Server Version 7.0
IIS
Microsoft Internet Information Services Version 6 or Version 7

Supported on Windows

SUNJAVASYSTEM
Sun Java System Web Server Version 6.1 or Version 7.0

Specify only one web server to configure.

Examples
Using the pct tool to configure an IHS Web Server to use an application server as a hosting server:
  • wctcmd.bat -tool pct -defLocPathname C:\data\IBM\WebSphere\Plugins -defLocName someDefLocName -response C:\IBM\WebSphere\tools\WCT\responsefile.txt
  • ./wctcmd.sh -tool pct -defLocPathname /data/IBM/WebSphere/Plugins -defLocName someDefLocName -response /var/IBM/WebSphere/tools/WCT/responsefile.txt

[Updated in March 2013] The following is an example of the content of a response file for an IHS local plug-in configuration. The valid values for the webServerOS parameter, which is used to specify the web server operating system, are Windows, Linux, Solaris, AIX, HPUX, OS390, OS400. [Updated in March 2013]

mar2013

configType=local_standalone
enableAdminServerSupport=true
enableUserAndPass=true
enableWinService=false
ihsAdminCreateUserAndGroup=true
ihsAdminPassword=******
ihsAdminPort=8008
ihsAdminUnixUserGroup=grp101
ihsAdminUnixUserID=user1
mapWebServerToApplications=true
profileName=AppSrv01
wasExistingLocation=opt/IBM/WebSphere/AppServer80
webServerConfigFile1=opt/IBM/HTTPServer/conf/httpd.conf
webServerDefinition=webserver1
webServerHostName=local.ibm.com
webServerOS=operating_system_value
webServerPortNumber=80
webServerSelected=ihs
configType=local_standalone
enableAdminServerSupport=true
enableUserAndPass=true
enableWinService=true
ihsAdminPassword=******
ihsAdminPort=8008
ihsAdminUserID=admin1
ihsWindowsPassword=******
ihsWindowsStartupType=Automatic
ihsWindowsUserID=user1
mapWebServerToApplications=true
profileName=AppSrv01
wasExistingLocation=D:\IBM\WebSphere\AppServer80
webServerConfigFile1=D:\IBM\HTTPServer\conf\httpd.conf
webServerDefinition=webserver1
webServerHostName=local.ibm.com
webServerInstallArch=32
webServerOS=windows
webServerPortNumber=80
webServerSelected=ihs

[Updated in March 2013] The following is an example of the content of a response file for an IHS local plug-in configuration. The valid values for the webServerOS parameter, which is used to specify the web server operating system, are Windows, Linux, Solaris, AIX, HPUX, OS390, OS400. [Updated in March 2013]

mar2013

configType=remote
enableAdminServerSupport=true
enableUserAndPass=true
enableWinService=false
ihsAdminCreateUserAndGroup=true
ihsAdminPassword=******
ihsAdminPort=8008
ihsAdminUnixUserGroup=grp101
ihsAdminUnixUserID=user1
mapWebServerToApplications=true
profileName=AppSrv01
wasExistingLocation=opt/IBM/WebSphere/AppServer80
wasMachineHostname=192.168.1.2
webServerConfigFile1=opt/IBM/HTTPServer/conf/httpd.conf
webServerDefinition=webserver1
webServerHostName=remote.ibm.com
webServerOS=operating_system_value
webServerPortNumber=80
webServerSelected=ihs
configType=remote
enableAdminServerSupport=true
enableUserAndPass=true
enableWinService=true
ihsAdminPassword=******
ihsAdminPort=8008
ihsAdminUserID=admin1
ihsWindowsPassword=******
ihsWindowsStartupType=Automatic
ihsWindowsUserID=user1
mapWebServerToApplications=true
profileName=AppSrv01
wasExistingLocation=D:\IBM\WebSphere\AppServer80
wasMachineHostname=192.168.1.2
webServerConfigFile1=D:\IBM\HTTPServer\conf\httpd.conf
webServerDefinition=webserver1
webServerHostName=remote.ibm.com
webServerInstallArch=32
webServerOS=windows
webServerPortNumber=80
webServerSelected=ihs
Importing a definition location for the pct tool:
wctcmd.bat -tool pct -importDefinitionLocation -defLocName someDefLocName -defLocPathname C:\data\IBM\WebSphere\Plugins -response C:\IBM\WebSphere\tools\WCT\responsefile.txt
./wctcmd.sh -tool pct -importDefinitionLocation -defLocName someDefLocName -defLocPathname /data/IBM/WebSphere/Plugins -response /var/IBM/WebSphere/tools/WCT/responsefile.txt
Removing a definition location for the pct tool:
wctcmd.bat -tool pct -removeDefinitionLocation -defLocName someDefLocName -defLocPathname C:\data\IBM\WebSphere\Plugins
./wctcmd.sh -tool pct -removeDefinitionLocation -defLocName someDefLocName -defLocPathname /data/IBM/WebSphere/Plugins
Listing the available definition locations for the pct tool:
wctcmd.bat -tool pct -defLocPathname C:\data\IBM\WebSphere\Plugins -listDefinitionLocations
./wctcmd.sh -tool pct -defLocPathname /data/IBM/WebSphere/Plugins -listDefinitionLocations
Removing a definition for the pct tool:
wctcmd.bat -tool pct -deleteDefinition someDefName -defLocName someDefLocName
./wctcmd.sh -tool pct -deleteDefinition someDefName -defLocName someDefLocName
Listing the available definitions for the pct tool:
wctcmd.bat -tool pct -defLocPathname C:\data\IBM\WebSphere\Plugins -listDefinitions
./wctcmd.sh -tool pct -defLocPathname /data/IBM/WebSphere/Plugins -listDefinition
Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Feb 6, 2014 8:11:25 PM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-mp&topic=tins_pctcl_using
File name: tins_pctcl_using.html