Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

It’s not necessary to immediately obtain access to CHES and CDOGS. If you wanted to take advantage of the document generator and email service in the future then this is where you would do it.

...

Cannot

...

Connect to the Docker

...

Daemon

Before running docker compose up, you will need to start the Docker daemon. Most Linux distributions use systemctl to start services and the macOS equivalent is launchctl. Use the following command sudo systemctl start docker to run the Docker daemon :

Code Block
sudo systemctl start docker

or

Code Block
sudo launchctl start docker

for Mac users.

(replace with launchctl for Mac). If you are using the Docker desktop app, starting the application and then running docker compose up will also work.

App not loading on localhost

After running npm run serve, the App should be running at http://localhost:8081/app/, but if you have issues where it is not loading, try the following:

...

Code Block
function loadKeycloak(config) {
  Vue.use(VueKeycloakJs, {
    init: { onLoad: 'check-sso', checkLoginIframe: false },
    config: {
      clientId: config.keycloak.clientId,
      realm: config.keycloak.realm,
      url: config.keycloak.serverUrl
    },
    onReady: () => {
      initializeApp(true, config.basePath);
    },
    onInitError: error => {
      console.error('Keycloak failed to initialize'); // eslint-disable-line no-console
      console.error(error); // eslint-disable-line no-console
    }
  });
}

...

setting the checkLoginIframevalue to false.

Before pushing your code, remember to revert the changes to main.js, removing the checkLoginIFrame variable from the code.

2. CORS Unblock Extension

In case you get an error message where access is blocked by CORS policy similar to the one below:

...

Download the CORS Unblock extension for chrome and enable the following settings:

...

Using Test Installation JSON

Add section and more details about dev vs test installation JSON, and how to configure (change realm-export.json or KeyCloak settings)

...

For any other issues not covered on this page, kindly contact Jason Chung.