Have a question? Want to report an issue? Contact JFrog support

Skip to end of metadata
Go to start of metadata

Artifactory Does Not Start Up

 There are no log file entries in $ARTIFACTORY_HOME/logs/artifactory.log
Cause
Something within your $ARTIFACTORY_HOME or $CLUSTER_HOME directory is either not defined, or misconfigured
Resolution
In some cases in which the $ARTIFACTORY_HOME directory tree is not validly constructed, log file entries are written to $ARTIFACTORY_HOME/logs/catalina/localhost/<date>/logs. Check the contents of this file to see which specific errors were logged.
 The log says "Stopping Artifactory start up ,another server running converting process".
Cause
You are upgrading more than one server at a time.
Resolution
When upgrading your system, make sure you complete the upgrade process on one server before starting to upgrade the next one.
 The log says "Stopping Artifactory start up ,another server with different version has been found".
Cause
You are trying to install different versions of Artifactory into the same system.
Resolution
Make sure that all the instances of Artifactory installed in your system are the same version.
 The log says "Stopping Artifactory since duplicate node ids have been found in registry. If you restarted this server, make sure to wait at least 30 seconds before re-activating it"
Cause

This may happen in one of two cases:

  1. Two servers are configured into your system with the same node.id specified in the $ARTIFACTORY_HOME/etc/ha-node.properties file.
  2. You have shut down an Artifactory server and tried to restart it within 30 seconds.
Resolution

Make sure that all servers within your Artifactory HA installation have a unique node.id value.

Shut down your server and wait at least 30 seconds before you restart it.

Page Contents

 An exception is thrown for "java.lang.IllegalStateException: Provided private key and latest private key fingerprints mismatch"
Symptoms

During startup, Artifactory fails to start and an error is thrown:

java.lang.IllegalStateException: Provided private key and latest private key fingerprints mismatch.

Cause

Artifactory tries to validate and compare access keys' fingerprint that reside on Artifactory's database and the local file system. If the keys do not match, the exception above will be thrown along with the mismatching fingerprint IDs.

Scenarios:

A. During an attempted upgrade/installation of an Artifactory HA cluster node.

B. When setting up your circle of trust, something has gone wrong and the different participating Artifactory installations do not share the same private key and root certificate. This causes cross-site authentication to fail since keys between the different sites cannot be validated.

Resolution

Follow the steps below to make sure that all instances in your circle of trust have the same private key and root certificate:

Key rotation will invalidate any issued access tokens

The procedure below will create new key pairs which in turn will invalidate any existing Access Tokens.

  1. Copy the private key and root certificate files from the first Artifactory instance to a location on your file system that is accessible by all other instances/nodes that are in your circle of trust.

  2. Before bootstrapping, for each of the other instances/nodes:
    1. Delete the existing private key and root certificate files (private.key and root.cert) from the $ARTIFACTORY_HOME/access/etc folder.
    2. Create the $ARTIFACTORY_HOME/access/etc/access.bootstrap.config with the following contents:

      key=/path/to/private.key
      crt=/path/to/root.crt
    3. Add the following JVM property to $ARTIFACTORY_HOME/bin/artifactory.default (or $ARTIFACTORY_HOME/etc/default for service installations):

      -Djfrog.access.force.replace.existing.root.keys=true
    4. Start up the new instance and verify that the artifactory.log file shows the following entry: 

      *******************************************************************
      *** Forcing replacement of the root private key and certificate ***
      *******************************************************************
    5. Delete the JVM property you added to $ARTIFACTORY_HOME/bin/artifactory.default (or $ARTIFACTORY_HOME/etc/default for service installations) in step c.

 


Artifactory Starts Up But Remains Offline

 The log says "Changing Artifactory mode to offline since the server is configured as HA but the license does not exist or is not an HA License"
Cause
Your server does not have a valid HA license installed
Resolution
Install a valid HA license in your server and restart it
 The log says "Changing Artifactory mode to offline since the local server is running as HA but found no HA server in registry."
Cause
You are starting an Artifactory server as an HA installation, however you already have an Artifactory Pro (or OSS version) running within the same system.
Resolution
Make sure your system is consistent - either you have a set of Artifactory Pro instances running separately, or you all of your servers are configured as Artifactory HA
 The log says "Could not find cluster properties"
Cause
Your $CLUSTER_HOME/ha-etc/cluster.properties file is not defined.
Resolution
When installing Artifactory HA, you need to manually create a $CLUSTER_HOME directory and the $CLUSTER_HOME/ha-etc/cluster.properties file. For details please refer to Configuring the Cluster.

Artifactory Starts Up But Not as an HA Installation

 Artifactory starts up as an instance of Artifactory Pro
Cause
You have not created a valid $ARTIFACTORY_HOME/etc/ha-node.properties file
Resolution
  1. Shutdown the node
  2. Delete the $ARTIFACTORY_HOME/access folder
  3. Delete the $ARTIFACTORY_HOME/etc/security/access folder
  4. Delete $ARTIFACTORY_HOME/etc/security/communication.key
  5. Delete $ARTIFACTORY_HOME/etc/binarystore.xml
  6. Delete $ARTIFACTORY_HOME/etc/db.properties
  7. Delete $ARTIFACTORY_HOME/etc/cluster.id
  8. Copy the bootstrap bundle you created on the primary node, bootstrap.bundle.tar.gz, to the $ARTIFACTORY_HOME/etc folder on the secondary node.
  9. Ensure that the bundle is owned by artifactory user (chown artifactory:artifactory bootstrap.bundle.tar.gz)
  10. Create a valid $ARTIFACTORY_HOME/etc/ha-node.properties file as described in Installing Artifactory HA.
  11. Start up the node

A Cluster Node Does Not Synchronize with Other Nodes

 The node does not contain the right bootstrap bundle
Cause
The node was installed without the right bootstrap bundle (bootstrap.bundle.tar.gz) or no bootstrap bundle at all.
Resolution

Install the right bootstrap bundle using the following procedure:

  1. Shutdown the node
  2. Delete the $ARTIFACTORY_HOME/access folder
  3. Delete the $ARTIFACTORY_HOME/etc/security/access folder
  4. Delete $ARTIFACTORY_HOME/etc/security/communication.key
  5. Delete $ARTIFACTORY_HOME/etc/binarystore.xml
  6. Delete $ARTIFACTORY_HOME/etc/db.properties
  7. Delete $ARTIFACTORY_HOME/etc/cluster.id
  8. Copy the bootstrap bundle you created on the primary node, bootstrap.bundle.tar.gz, to the $ARTIFACTORY_HOME/etc folder on the secondary node.
  9. Ensure that the bundle is owned by artifactory user (chown artifactory:artifactory bootstrap.bundle.tar.gz)
  10. Start up the node

 

 

  • No labels