You can create a reusable deployment configuration from
the solution map to deploy your solution to a test server. After you
complete the server connection details, you can also manage your connectivity
configurations from the same wizard.
About this task
You use the Deployment Configurations wizard
during development to test a solution. A deployment configuration
establishes a connection to a local or remote server. You can specify
the server connection properties in a new deployment configuration
and modify existing server connection configurations.
If you
deploy your solution to a remote server, the wizard establishes an
HTTP connection to a running Liberty server, which can be a remote
host or a local host.
Restriction: Do not use
the Deployment configurations wizard to deploy
a solution to a production server.
Procedure
- In the solution map, click Manage deployment
configurations, or right-click a solution and click .
- In the Deployment configurations wizard,
either click New and enter a unique configuration
name, or select an existing deployment configuration.
- Select a Local or Remote server.
- If you select a Local server, you
must specify a server name or select an existing server name from
the menu. Local servers are configured in the Servers view.
The path to the administrator toolkit is completed
automatically if you select a server from the menu. If you do not
have a local server that is configured in the Servers view,
enter the name of a local server, and enter the path to your administrator
toolkit. The default administrator toolkit path is <InstallDir>/runtime/ia/bin.
- Click Next.
- Specify the Java™ Management
Extensions (JMX) connection properties for the server, or select Use
existing properties file to use the connection properties
in an existing file. By default, the fields in this wizard
use the values in the <InstallDir>/runtime/ia/etc/connection.properties file.
- Specify a value for host. The default host name for
cisDev is localhost.
- Specify a value for port. The default port
value for cisDev is 9443.
- Specify the user name and password of a user who has
the administrator role. The default name and password for
cisDev is tester.
- Optional: Specify the location and password
for the truststore (javax.net.ssl.trustStore). The truststore contains certificate authorities that you trust.
The default location is ${wlp.user.dir}/servers/cisDev/resources/security/key.jks.
- Optional: Specify the location and password
for the keystore. A keystore contains private keys for
client authentication. If you do not specify values, the keystore
is not used.
- Specify the SSL protocol for the connection. The default
value is TLSv1.2 (Transport Layer Security).
- Optional: Select Disable SSL
hostname verification to disable the SSL protocol for
the connection. You might want to disable the SSL host
name verification if the certificate has a host name that is different
from the host name to which you are connecting. For
example, you might disable the SSL protocol if the certificate is
signed "localhost" and you want to connect to an IP address.
- Optional: If you do not want the client
to check whether the certificate presented by the server is trusted,
select Disable server certificate verification.
If you select this option and the server is not trusted, authentication
credentials and other user information might be passed on through
the JMX connection.
If you have a connectivity definition in your solution,
click Next to configure the connectivity assets.
- Optional: Create a connectivity configuration,
or modify an existing one.
- On the connectivity configuration page, choose to create
a new file or import an existing file, and then click Next.
- Select the inbound and outbound endpoints that you want
to configure, and then click Next.
- Complete the fields to configure the endpoints that
you selected.
- Click Finish. The
wizard prompts you to deploy your solution. Click Yes to
deploy or No to exit the wizard without deploying
the solution.
If you deploy your solution, the solution archive
and any connectivity configuration are deployed to the server. If
your deployment contains a connectivity configuration, the connectivity
configuration file opens in the XML editor.
Results
The deployment configuration is added to the context menu
of your solution. You can redeploy your solution by clicking the deployment
configuration name: Right-click your solution and then click .
What to do next
Modify the connectivity configuration file with advanced
features. If you modify the file, the changes are present in subsequent
deployments that use this file. For more information, see
Completing connectivity configuration files.