Deployer 10.15 | Using Deployer Commands | Specifying Logon Parameters
 
Specifying Logon Parameters
 
Creating a Configuration File for Logon Parameters
All Deployer commands require parameters for logging into Integration Server that hosts Deployer. You can have Deployer commands connect to Integration Server using HTTP or HTTPS.
If you want Deployer commands to log on using HTTP, you can use an existing HTTP port on Integration Server or configure a new one.
If you want Deployer commands to log on using HTTPS, do the following:
*Use an existing HTTPS port on Integration Server or configure a new one.
*Place the command line interface's client certificate, private key, and signing authority's certificate on the Integration Server host machine.
*Map the command line interface's client certificate to an Integration Server user that has Administrator or Developer privileges.
For instructions for these tasks, see the webMethods Integration Server Administrator’s Guide.
When you run Deployer commands, the logon parameters you provide depend on whether you want to use HTTP or HTTPS.
*Logon parameters for logging into an HTTP port
Deployer.{sh|bat} --command -host host -port port-user user-pwd password     
*Logon parameters for logging into an HTTPS port
Deployer.{sh|bat} --command -host host -port port-user user-pwd password
-useSSL -senderCert path_to_cert-privKey path_to_key-caCert path_to_cert     
Ensure that the certificates are in DER format; if not, convert them to DER format using a certificate management tool, such as Java keytool. See the Prerequisites to Configuring a Port for SSL section in the webMethods Integration Server Administrator’s Guide for more information on the type of certificate format supported.
The following table describes the function of the parameters included in the command syntax:
Parameter
Description
-host host -port port
Integration Server logs on to this host machine and port.
-user user-pwd password
User name and password to use to log on to Integration Server.
Note: 
If you do not provide a password, Deployer prompts you for the password.
-useSSL
Log on to an HTTPS port.
-senderCert path_to_cert
Command line interface's client certificate.
-privKey path_to_key
Command line interface's private key.
-caCert path_to_cert
Command line interface's signing authority's certificate. If the certificates and private key do not exactly match the ones in the Integration Server installation for the command line interface, the command will fail.
The following table shows which parameters are required when you log into an HTTPS port, based on the options you select in the Security Configuration section in Integration Server Administrator. (Integration Server Administrator > Ports > Add Port > Select Type of Port to Configure as webMethods/HTTPS > Security Configuration > Client authentication section).
If you select the Client Authentication option as...
Provide the following parameters...
Username/Password
Required parameters
*Username (-user)
*password (-pwd)
Optional parameters
*-senderCert
*-privKey
*-caCert
Request Client Certificates
Required parameters
*Username (-user)
*password (-pwd)
or provide
Required parameters
*-senderCert
*-privKey
Optional parameter
-caCert
Require Client Certificates
Required parameters
*-senderCert
*-privKey
Optional parameter
-caCert