Java error messages and troubleshooting

The Java deployment steps include a number of unique error codes that may be displayed in the output if there was an error. Below is a list of the errors, along with any additional troubleshooting steps that can be taken to rectify them.

WILDFLY-DEPLOY-ERROR-0001

There was an error taking a snapshot of the current configuration.

WILDFLY-DEPLOY-ERROR-0002

There was an error deploying the artifact.

WILDFLY-DEPLOY-ERROR-0003

There was an error reading the existing deployments.

WILDFLY-DEPLOY-ERROR-0004

There was an error adding the package to the server group.

WILDFLY-DEPLOY-ERROR-0005

There was an error deploying the package to the server group.

This may be due to duplicate context paths. Check that the context path is not already assigned to an existing application.

See Defining Context Paths for more information on how context paths are assigned in WildFly.

This may also occur if invalid server group names where supplied when deploying to a domain controller. Look for entries like this in the verbose log output:

INFO: Result as JSON: {
    "outcome" : "failed",
    "failure-description" : "WFLYCTL0216: Management resource '[(\"server-group\" => \"invalid-server-group-name\")]' not found",
    "rolled-back" : true
}

WILDFLY-DEPLOY-ERROR-0006

There was an error undeploying the package to the server group

WILDFLY-DEPLOY-ERROR-0007

There was an error deploying the package to the standalone server.

This may be due to duplicate context paths. Check that the context path is not already assigned to an existing application.

See Defining Context Paths for more information on how context paths are assigned in WildFly.

This may also be caused by an error that prevents the application being deployed from starting up. Check the application server logs for more information.

WILDFLY-DEPLOY-ERROR-0008

There was an error enabling the package in the standalone server

WILDFLY-DEPLOY-ERROR-0009

There was an error logging into the management API.

Ensure the server has started and that the ip/hostname and port details are correct.

Make sure the credentials are correct.

WILDFLY-DEPLOY-ERROR-0010

There was an error logging out of the management API

WILDFLY-DEPLOY-ERROR-0011

There was an error terminating the CLI object

WILDFLY-DEPLOY-ERROR-0012

There was an error changing the deployed state of the application.

Make sure the application name is correct.

WILDFLY-DEPLOY-ERROR-0013

The login was not completed in a reasonable amount of time.

This can happen if no credentials where supplied with the step, and silent authentication failed.

Either supply credentials to be used, or ensure that the user performing the deployment (the Tentacle service user in Windows or the SSH user in Linux and MacOS) has access to the application server $JBOSS_HOME/standalone/tmp/auth or $JBOSS_HOME/domain/tmp/auth directory.

Also ensure that the hostname and port are correct. You should be able to open the admin console using these details.

Wildfly Admin Console

WILDFLY-DEPLOY-ERROR-0014

An exception was thrown during the deployment.

WILDFLY-DEPLOY-ERROR-0015

Failed to deploy the package to the WildFly/EAP standalone instance

WILDFLY-DEPLOY-ERROR-0016

Failed to deploy the package to the WildFly/EAP domain

WILDFLY-DEPLOY-ERROR-0017

There was a mismatch between the server type defined in the Octopus Deploy step and the server that was being deployed to. For example, the Octopus Deploy step defined the server as Standalone in the Standalone or Domain Server field, but the server was actually a domain controller. This error won’t stop the deployment, but possibly means that the Octopus Step has not configured the correct fields.

TOMCAT-DEPLOY-ERROR-0001

There was an error deploying the package to Tomcat

TOMCAT-DEPLOY-ERROR-0002

There was an error deploying a tagged package to Tomcat

TOMCAT-DEPLOY-ERROR-0003

There was an error undeploying a package from Tomcat

TOMCAT-DEPLOY-ERROR-0004

There was an error enabling or disabling a package in Tomcat

TOMCAT-DEPLOY-ERROR-0005

This is a catch all error message for unexpected errors during a Tomcat deployment. Ensure that:

  • The manager URL is correct. Ensure the URL includes the context of the manager application, and that the port and hostname/IP address are correct. Also ensure that the hostname/IP address can be resolved from the target machine hosting the Tentacle. A common example of a correct manager URL is http://localhost:8080/manager.
  • The Tomcat credentials are correct, and that the Tomcat user has been granted the manager-script role.
  • The firewall allows connection to the Tomcat server.
  • Tomcat is started and running.

If you see errors such as:

23:22:33   Error    |       TOMCAT-DEPLOY-ERROR-0005: An exception was thrown during the deployment. https://oc.to/JavaAppDeploy#tomcat-deploy-error-0005
23:22:33   Error    |       org.apache.http.conn.HttpHostConnectException: Connect to tomcat-server:8080 [tomcat-server/127.0.1.1] failed: Connection refused

Then ensure that the IP address of the tomcat server (127.0.1.1 in this example, as found in the list [tomcat-server/127.0.1.1]) is valid. If not, there may be a DNS issue.

It may also be the case that the tomcat process running does not have the necessary permissions to modify the filesystem. Ensure that the process is running with the correct privileges.

TOMCAT-DEPLOY-ERROR-0006

A HTTP return code indicated that the login failed due to bad credentials. Make sure the username and password are correct.

TOMCAT-DEPLOY-ERROR-0007

A HTTP return code indicated that the login failed due to invalid group membership. Make sure the user is part of the manager-script group in the tomcat-users.xml file.

See the Tomcat documentation for more details on the groups used by the manager application.

TOMCAT-DEPLOY-ERROR-0008

The application was not successfully started or stopped.

This can happen if the application failed to initialize. Check the Tomcat logs for information on why the application could not be started.

Also confirm that the context path and version match a deployed application.

This is treated as a warning during deployment, but an error if encountered during the Tomcat start/stop step.

JAVA-DEPLOY-ERROR-0001

The Deploy a package step was used with an unsupported package. This step does not support specialized file formats, like those used with Java packages.

You may want to use a step like Deploy Java Archive instead.

TOMCAT-HTTPS-ERROR-0001

TOMCAT-HTTPS-ERROR-0002

TOMCAT-HTTPS-ERROR-0003

You have attempted to deploy a certificate using a protocol that is not supported by the installed version of Tomcat.

TOMCAT-HTTPS-ERROR-0004

TOMCAT-HTTPS-ERROR-0005

TOMCAT-HTTPS-ERROR-0006

You have attempted to add an additional certificate to an existing <Connector> configuration in Tomcat 8.5 and above, or overwrite an existing <Connector> configuration, where the new protocol does not match the existing protocol. For example the configuration already defines a <Connector> with the NIO protocol, and you are attempting to add a certificate with the APR protocol. This is not supported as changing the protocol may leave existing configurations in an invalid state.

This error may also be thrown if a certificate is being added to an existing <Connector> that does not define the protocol attribute. Tomcat will auto-switch between APR and NIO if the protocol attribute is not set, but Octopus requires a fixed implementation to be defined before it can deploy a certificate.

To solve this problem, either deploy the certificate using the same protocol that is already configured in the <Connector>, manually remove the existing <Connector> and redeploy the certificate via Octopus, or manually configure the <Connector> to use the new protocol and then deploy the certificate into it with Octopus.

TOMCAT-HTTPS-ERROR-0007

Tomcat 8.5 and above do not support the BIO protocol.

TOMCAT-HTTPS-ERROR-0008:

If we have an existing configuration like this:

<Connector
  defaultSSLHostConfigName="myHostName"
  port="12345"
  scheme="https"
  secure="true"
  SSLEnabled="true"
  SSLCertificateFile="/usr/local/ssl/server.crt"
  SSLCertificateKeyFile="/usr/local/ssl/server.pem"/>

then this certificate configuration is assumed to have the hostName of myHostName, because it is derived from the defaultSSLHostConfigName attribute. At this point trying to add another default <SSLHostConfig> element will fail. For example, this is not a valid configuration:

 <Connector
  defaultSSLHostConfigName="myHostName"
  port="12345"
  scheme="https"
  secure="true"
  SSLEnabled="true"
  SSLCertificateFile="/usr/local/ssl/server.crt"
  SSLCertificateKeyFile="/usr/local/ssl/server.pem">
      <SSLHostConfig hostName="myHostName">
          <Certificate ... />
      </SSLHostConfig>
  </Connector>

The above will throw an error about having duplicate default configurations.

The error TOMCAT-HTTPS-ERROR-0008 means Octopus prevented a certificate deployment that would lead to this invalid configuration.

You can fix this error by not deploying the new certificate as the default, or by manually moving the certificate configuration from the <Connector> element into a <SSLHostConfig> before deploying another certificate with Octopus.

TOMCAT-HTTPS-ERROR-0009

Tomcat 7.0 does not support the Non-Blocking IO 2 Connector

TOMCAT-HTTPS-ERROR-0010

The server.xml file could not be found.

When the CATALINA_BASE location is defined, server.xml is expected to be found at $CATALINA_BASE/conf/server.xml.

When the CATALINA_BASE location is not defined, server.xml is expected to be found at CATALINA_HOME/conf/server.xml.

Ensure that the CATALINA_BASE directory is valid (if it is defined) and that the user account performing the deployment (i.e. the Tentacle service or the SSH user) has permissions to access the server.xml file.

TOMCAT-HTTPS-ERROR-0011

Failed to extract the version number from the information supplied.

TOMCAT-HTTPS-ERROR-0012

Failed to generate a unique file.

TOMCAT-HTTPS-ERROR-0013

The server.xml file was not valid XML, or was not accessible.

Check to make sure that the user running the Octopus Tentacle in Windows or the SSH user in Linux/MacOS has permissions to read the server.xml file.

TOMCAT-HTTPS-ERROR-0014

Failed to save the server.xml file.

Check to make sure that the user running the Octopus Tentacle in Windows or the SSH user in Linux/MacOS has permissions to write to the server.xml file.

TOMCAT-HTTPS-ERROR-0016

The private key could not be created.

Check to make sure that the user running the Octopus Tentacle in Windows or the SSH user in Linux/MacOS has permissions to create files in the Tomcat conf directory.

TOMCAT-HTTPS-ERROR-0017

The public key could not be created.

Check to make sure that the user running the Octopus Tentacle in Windows or the SSH user in Linux/MacOS has permissions to create files in the Tomcat conf directory.

TOMCAT-HTTPS-ERROR-0018

Failed to find the lib/catalina.jar file in the Tomcat directory.

Make sure the Tomcat installation path is correct.

Also check to make sure that the user running the Octopus Tentacle in Windows or the SSH user in Linux/MacOS has permissions list the Tomcat lib directory, and has read access to the lib/catalina.jar file.

TOMCAT-HTTPS-ERROR-0019

The path defined to hold the keys does not exist.

TOMCAT-HTTPS-ERROR-0020

The keystore, private key or public key filename must be an absolute path if it is specified.

WILDFLY-HTTPS-ERROR-0001

An exception was thrown during the HTTPS configuration.

WILDFLY-HTTPS-ERROR-0004

There was an error configuring the Elytron server SSL context

WILDFLY-HTTPS-ERROR-0005

There was an error removing the legacy security realm, or an error creating the keystore file.

Check for an error like java.io.FileNotFoundException: /opt/wildfly/standalone/configuration/Internet_Widgits_Pty_Ltd1.keystore (Permission denied) , and ensure the Tentacle user account has the correct permissions to create the keystore file.

WILDFLY-HTTPS-ERROR-0006

There was an error adding the Elytron security context.

WILDFLY-HTTPS-ERROR-0007

There was an error with the batched operation to remove the legacy security realm and add the Elytron security context.

WILDFLY-HTTPS-ERROR-0008

There was an error reloading the server.

WILDFLY-HTTPS-ERROR-0009

There was an error adding the Elytron key store.

WILDFLY-HTTPS-ERROR-0010

There was an error configuring the Elytron key store.

WILDFLY-HTTPS-ERROR-0011

There was an error adding the Elytron key manager.

WILDFLY-HTTPS-ERROR-0012

There was an error configuring the Elytron key manager.

WILDFLY-HTTPS-ERROR-0013

There was an error adding the Elytron server ssl context.

WILDFLY-HTTPS-ERROR-0014

There was an error configuring the Elytron server ssl context.

WILDFLY-HTTPS-ERROR-0015

There was an error reading the app server config path.

WILDFLY-HTTPS-ERROR-0017

Configuring a keystore requires that the keystore name be defined.

WILDFLY-HTTPS-ERROR-0018

A required property was not defined.

WILDFLY-HTTPS-ERROR-0019

The server being configured did not match the type of server (either standalone or domain) defined in the step.

WILDFLY-HTTPS-ERROR-0020

There was an error adding the security realm.

WILDFLY-HTTPS-ERROR-0021

There was an error adding the keystore to the security realm.

WILDFLY-HTTPS-ERROR-0022

There was an error configuring the existing keystore information in the security realm.

WILDFLY-HTTPS-ERROR-0023

There was an error getting the undertow servers.

WILDFLY-HTTPS-ERROR-0024

There was an error adding a new https listener in undertow.

This can happen if the application server fails to start an existing https listener. Check the log files for messages like:

No SSL Context available from security realm 'realmname'. Either the realm is not configured for SSL, or the server has not been reloaded since the SSL config was added.

WILDFLY-HTTPS-ERROR-0025

There was an error configuring the existing https listener.

WILDFLY-HTTPS-ERROR-0026

Failed to get the default interface for socket group.

WILDFLY-HTTPS-ERROR-0027

Failed to get the https socket binding.

WILDFLY-HTTPS-ERROR-0028

Failed to get socket binding for standalone.

WILDFLY-HTTPS-ERROR-0029

There was an error adding a new https connector in the web subsystem.

WILDFLY-HTTPS-ERROR-0030

There was an error configuring the existing https connector.

WILDFLY-HTTPS-ERROR-0031

Failed to get socket binding for host.

WILDFLY-HTTPS-ERROR-0032

Failed to get slave hosts.

WILDFLY-HTTPS-ERROR-0033

Failed to get master hosts.

WILDFLY-HTTPS-ERROR-0034

Failed to get master hosts.

WILDFLY-HTTPS-ERROR-0035

Failed to get servers for host.

WILDFLY-HTTPS-ERROR-0036

Failed to save legacy web subsystem https connector as a batch operation.

WILDFLY-HTTPS-ERROR-0037

A supplied profile did not exist in the domain.

WILDFLY-HTTPS-ERROR-0038

The server is not in a running state.

WILDFLY-HTTPS-ERROR-0039

Failed to find either web or undertow subsystems.

This means that Calamari has tried to find either the web or undertow subsystem to determine how the certificate is to be configured, and neither could be found. This probably means the server is still starting up and is not responding to the read-resource queries.

WILDFLY-HTTPS-ERROR-0040

Failed to load any extensions.

WILDFLY-HTTPS-ERROR-0041

The keystore filename must be an absolute path if it is specified.

For example, you may have entered a value like my.store as the Keystore Filename. This value is required to be a path like C:\my.store or /opt/my.store.

WILDFLY-HTTPS-ERROR-0042

When the keystore is not relative to a path, it must be absolute.

WILDFLY-HTTPS-ERROR-0043

When the keystore is relative to a path, it must not absolute.

WILDFLY-ERROR-0001

There was an error entering batch mode.

WILDFLY-ERROR-0002

There was an error running the batch.

JAVA-HTTPS-ERROR-0001

Certificate file does not contain any certificates. This is probably because the input certificate file is invalid.

JAVA-HTTPS-ERROR-0002

Could not find a private key. This is probably because the input key file is invalid.

JAVA-HTTPS-ERROR-0003

The path supplied as the location of a unique file was not a directory.

JAVA-HTTPS-ERROR-0004

The path supplied as the location of a unique file does not exist.

JAVA-HTTPS-ERROR-0005

Failed to create the keystore file.

Ensure that the user running the Tentacle service for a Windows target or the SSH account Octopus uses to connect to the Linux or MacOS target has permissions to create a new file, or overwrite the existing file, at the configured path.

KEYSTORE-ERROR-0001

An exception was thrown during the deployment of the Java keystore.

KEYSTORE-ERROR-0002

The keystoreName and defaultCertificateLocation both can not be blank.

KEYSTORE-ERROR-0003

The keystore filename must be an absolute path if it is specified.

For example, you may have entered a value like my.store as the Keystore Filename. This value is required to be a path like C:\my.store or /opt/my.store.

KEYSTORE-ERROR-0004

The keystore filename must be supplied.

Help us continuously improve

Please let us know if you have any feedback about this page.

Send feedback

Page updated on Sunday, January 1, 2023