redeploy
The solutionManager redeploy command redeploys a solution that you previously deployed on a development server. The command copies the solution archive file to the server and deploys the solution.
Purpose
Use the solutionManager redeploy command to replace an existing solution with a new copy of the solution.
You can run the solutionManager script to redeploy a solution on a local host or a remote host. If you run the script with the local parameter, it modifies files on the local system. If you run the script with the remote parameter, it establishes an HTTP connection to a running Liberty server, which might be a remote host or the local host. You must provide administrator authentication credentials to run the command.
The redeployed solution is the same version as the original solution. This command allows you to undeploy and redeploy a solution without changing the solution version. Run this command only on a development server.
Restriction: You can only run the redeploy command
on single servers.
Syntax
solutionManager redeploy local file_location/solution.esa
[--server=server_name]
[--propertiesFile=properties_file]
[--enableOnly=true|false]
[--username=username]
[--password=password]
[--host=hostname]
[--port=port]
[--keyStoreLocation=keystore_location]
[--keyStorePassword=keystore_password]
[--readTimeout=timeout_value]
[--sslProtocol=sslProtocol]
[--trustStorePassword=truststore_password]
[--trustStoreLocation=truststore_location]
[--disableSSLHostnameVerification=true|false]solutionManager redeploy remote file_location/solution.esa
[--propertiesFile=properties_file]
[--enableOnly=true|false]
[--username=username]
[--password=password]
[--host=hostname]
[--port=port]
[--keyStoreLocation=keystore_location]
[--keyStorePassword=keystore_password]
[--readTimeout=timeout_value]
[--sslProtocol=sslProtocol]
[--trustStorePassword=truststore_password]
[--trustStoreLocation=truststore_location]
[--disableSSLHostnameVerification=true|false]
[--disableServerCertificateVerification=true|false]Description
| Mandatory parameter | Description |
|---|---|
| file_location/solution.esa | Identify the location of the solution archive to redeploy. |
| Optional parameter | Description |
|---|---|
| server | The name of the local server. If you do not specify a value, the value specified by the propertiesFile option in the properties file is used. The name of the server where you want to install the solution. |
| enableOnly | The default value is false. If the value of the parameter is true, then the .esa archive file is not copied to the server, but the server.xml file is modified to enable the solution. |
| propertiesFile | The path to a properties file from which to read properties. If you do not specify a value, the default path to the connection.properties file in the runtime/ia/etc directory is used. |
| username | The user name of a user who has the administrator role. |
| password | The password of a user who has the administrator role. |
| host | The default host name is localhost. To change the host name, specify the fully qualified name of the remote server. For example: myserver.mycompany.com |
| port | The default port value is 9443.
To change the port, specify the port of the remote server. |
| trustStorePassword | The password for remote Secure Sockets Layer (SSL) authentication. |
| trustStoreLocation | Location of the truststore (javax.net.ssl.trustStore). Default is cisDev/resources/security/key.jks in the servers directory. |
| disableSSLHostnameVerification | This parameter is used for remote connections
only. If set to true, it disables SSL host name verification.
If no value is specified, it defaults to the value in the properties
file that is specified by the --propertiesFile parameter.
If no value is specified by that parameter, it defaults to false. |
| disableServerCertificateVerification | This parameter is used to disable server certificate verification. If you set this parameter to true, the client does not check whether the certificate presented by the server is trusted. If the server is not trusted, authentication credentials and other user information might be passed on through the JMX connection. This parameter is optional. If not specified, it uses the value in the properties file specified by the --propertiesFile option. If no value is specified on the command line or in the properties file, it defaults to false. |
| keyStoreLocation | The location of the keystore. If you do not specify a value, this parameter uses the value in the properties file specified by the --propertiesFile option. If no value is specified on the command line or in the properties file, no keystore is used. |
| keyStorePassword | The keystore password. If you do not specify a value, this parameter uses the value in the properties file specified by the --propertiesFile option. If no value is specified on the command line or in the properties file, you are asked to provide a password interactively. |
| readTimeout | The amount of time expressed in milliseconds that the utility waits for a response from the server before closing a connection. This parameter is optional. If you do not specify a value, it uses the value that is specified by the --propertiesFile option. If no value is specified on the command line or in the properties file, the default value is 60000 (1 minute). |
| sslProtocol | The SSL protocol for the connection. If you do not specify a value, this parameter uses the value in the properties file specified by the --propertiesFile option. If no value is specified on the command line or in the properties file, the value "TLSv1.2" is used. |
| Mandatory parameter | Description |
|---|---|
| file_location/solution.esa | Identify the location of the solution archive to redeploy. |
| Optional parameter | Description |
|---|---|
| enableOnly | The default value is false. If the value of the parameter is true, then the .esa archive file is not copied to the server, but the server.xml file is modified to enable the solution. |
| propertiesFile | The path to a properties file from which to read properties. If you do not specify a value, the default path to the connection.properties file in the runtime/ia/etc directory is used. |
| username | The user name of a user who has the administrator role. |
| host | Specify the host name of the server to make the remote call to. This is required for a remote call, and is not used for a local call. |
| port | The default port value is 9443.
To change the port, specify the port of the remote server. |
| password | The password of a user who has the administrator role. |
| trustStorePassword | The password for remote Secure Sockets Layer (SSL) authentication. |
| trustStoreLocation | Location of the truststore (javax.net.ssl.trustStore). Default is cisDev/resources/security/key.jks in the servers directory. |
| disableSSLHostnameVerification | This parameter is used for remote connections only. If set to true, it disables SSL host name verification. If no value is specified, it defaults to the value in the properties file that is specified by the --propertiesFile parameter. If no value is specified by that parameter, it defaults to false. |
| keyStoreLocation | The location of the keystore. If you do not specify a value, this parameter uses the value in the properties file specified by the --propertiesFile option. If no value is specified on the command line or in the properties file, no keystore is used. |
| keyStorePassword | The keystore password. If you do not specify a value, this parameter uses the value in the properties file specified by the --propertiesFile option. If no value is specified on the command line or in the properties file, you are asked to provide a password interactively. |
| readTimeout | The amount of time expressed in milliseconds that the utility waits for a response from the server before closing a connection. This parameter is optional. If you do not specify a value, it uses the value that is specified by the --propertiesFile option. If no value is specified on the command line or in the properties file, the default value is 60000 (1 minute). |
| sslProtocol | The SSL protocol for the connection. If you do not specify a value, this parameter uses the value in the properties file specified by the --propertiesFile option. If no value is specified on the command line or in the properties file, the value "TLSv1.2" is used. |