Specifying 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 |