1. User Guide
  2. Appendix: About Deployments
  3. Deployment: Basic Troubleshooting

Deployment: Basic Troubleshooting

This section describes basic deployment troubleshooting scenarios.

Deployments not uploaded successfully to apache

When a deployment cannot be uploaded successfully to Apache, the cause will typically be one or more of the following four issues. See the xcenter-admin.log and server.log files on the Oracle Retail Xstore Office server to determine which of the issues is the cause for the failure.

  1. The Apache URL configured in the xcenter.properties file is incorrect.

  2. The Apache credentials configured in the xcenter.properties file are incorrect.

  3. The SSL certificate for the Apache server is not located in the truststore file in the xcenter-config\res\ssl folder.

  4. The Apache server cannot be reached from the Oracle Retail Xstore Office system.

Deployments not being downloaded and applied by xenvironment

When Oracle Retail Xenvironment is unable to download a deployment from the Apache server, the cause will typically be one or more of the following three issues. See the environment's process.log file to determine which of the issues is the cause for the failure.

  1. The URL provided in the manifest cannot be reached from the store.

  2. The SSL certificate needed to communicate with the Apache server is not present in the trusted.ca-bundle file.

  3. The Oracle Retail Xenvironment role of one or more of the registers in the store is incorrectly configured.

Deployments downloaded and applied by xenvironment, no status information appears in xstore office

When Oracle Retail Xenvironment is unable to transmit status information to Xcenter, the cause is typically related to the DataSourceConfig file's Xcenter DataSource not including a GetUpdates context path. Confirm that this path is present and accurate, and add it if it is missing.