Skip to main content
Skip table of contents

Troubleshoot OC Admin

This section details some resolutions to common issues that may arise during use of OC Admin.


The OC Admin Server logs a sizable amount of information.


All logs are accessible via the following Docker command:

docker logs --follow oc-admin

The logs are divided in several categories:

LoginAuthentication-related logs.2021-12-10T23:09:13.521Z | INFORMATION | Login | Credentials for User are valid | user: ocAdmin
AdminAdministrative task-related logs, such as RBAC admin.2021-12-13T23:12:22.256Z | INFORMATION | Admin | User Account created | Login: TonyMasse | Role UID: cb36e823-e68f-46aa-acbd-71c35cae43b5 | user: ocAdmin
SOCKETWeb Socket-related logs.2021-12-11T06:30:46.819Z | INFORMATION | SOCKET | X8nxt_wxyz_cbylTAQHS | ocUser | CONNECTION - Connection requested.
HTTP RequestWeb server's access logs. Typically only available if LOGLEVEL is set to Verbose.2021-12-11T06:30:44.893Z | VERBOSE | HTTP Request | client_ip: | client_port: 3030 | username: ocUser | roles: User | method: GET | path: /API/v1/config/GetPipelines
HTTP ErrorWeb server's error logs.2021-12-13T17:25:15.536Z | ERROR | HTTP Error | client_ip: | client_port: 56486 | username: - | roles: - | method: GET | path: /robot.txt | error code: HTTP Return Code: 404

A grouping of less common logs.

For example: service start/stop, greeting message at start up, etc.

2021-12-13T22:39:33.759Z | INFORMATION | Listening for HTTPS requests on:

Changing the Log Level

This operation requires modifying an important OC Admin configuration file.

Please follow the instructions carefully, as an error could prevent OC Admin from functioning correctly.

To check or change the Log Level, perform the following steps:

  1. Open a new Shell inside the OC Admin container (oc-admin).

    docker exec -it oc-admin sh 
  2. Double check the current directory is /app .

  3. Open the .env file into a Text editor.

    vi .env 
  4. Change the value of the LOGLEVEL variable to either:
    • Critical
    • Error
    • Warning
    • Information (default value) 
    • Verbose (necessary to see the HTTP Request logs)
    • Debug (not recommended)
  5. Save the file by running the following from within vi:

    : x

    Do not include the space.

  6. Exit the running container:

  7. Restart the OC Admin Server container:

    ./lrctl oc-admin restart

Configuration Files


  1. Inside the OC Admin container (oc-admin), the files are all located under /app .
  2. View the .env and .env.sample files from this directory.
  3. View the config/ directory for the current configuration.
  4. Open the config.sample/ directory to see examples of configuration files

    This directory contains a file set containing illustrative values.


File NamesLocationDescriptions

Stores low level configuration: Host binding IP, listening Port, Log level, etc.

Use caution in this directory, as errors can cause OC Admin to stop functioning.

.env.sample./Same as above, but with only illustrative values and comments
https.cert.pem./config/ & ./config.sample/Provided as part of the Self-Signed HTTPS certificate.
https.key.pem./config/ & ./config.sample/Provided as part of the Self-Signed HTTPS certificate.
https.keytmp.pem./config/ & ./config.sample/Provided as part of the Self-Signed HTTPS certificate.
https.HOW TO - README.txt./config/ & ./config.sample/Explanation on how to create your own Self-Signed HTTPS certificate.
secure.json./config/ & ./config.sample/Stores the AES key used to encrypt secrets provided by the user via the UI.
ez-market-place.json ./config/ & ./config.sample/Stores the unique deployment ID, the base URL for the Marketplace API, and the Public Key of the Marketplace.

HTTPS Certificate

By default, the certificate provided is a temporary Self-Signed certificate.

This default certificate could prevent some of the API calls from working if the window is left open for too long, as the "bypass the bad certificate" action from the user can timeout. The user will not see it, but the next API call will fail.

In this case, the solution is to either:

  • Without losing unsaved changes:
    1. Open a second tab to the same URL.
    2. Bypass the "bad certificate" warning.
    3. Try to hit the API again (by clicking Save, or repeating the previous failed action).
  • Losing all unsaved changes:
    1. Log out.
    2. Click refresh.
    3. Log back in.

Simply refreshing the page may not ask for a login, but it will break the socket connection. Logging out and then logging back in after a refresh ensures that the socket connection is properly established.

Shipper Logs (Tail/Field Mapping Editor)

These logs can reveal why the Tail is not providing logs to the Field Mapping Editor.

The shipper logs can be accessed from the main OC Admin page by performing the following steps:

  1. From the menu, open the Advanced drop-list.
  2. Toggle the Show Communication & Shipper's Logs to active.
  3. Scroll to the bottom of the page (past the last field of the Editor, if active).

Some errors may not be in red. The shipper's logs can be verbose and difficult to navigate.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.