IQOQ

The IQOQ app runs Installation Qualification and Operational Qualification (IQ/OQ) checks against your JuliaHub platform and produces a PDF report you can use as evidence for compliance and validation activities. As a customer admin, you can run it on demand — no JuliaHub support involvement needed.

Access

As a customer admin, you already have access to the IQOQ app. If you don't see the IQOQ Test card under Applications, contact JuliaHub support.

Running IQOQ

  1. Click Applications in the left navigation.
  2. Filter or scroll to find the IQOQ Test card.
  3. Click Launch on the IQOQ Test card.
  4. Wait for the job to complete. A full IQOQ run typically takes 25–35 minutes (a few minutes for the job to start, ~10 minutes for the qualification checks, and a few minutes to generate the PDF).

You can navigate away while the job runs. The platform will keep running it in the background.

Downloading the Report

  1. Open Jobs from the left navigation.
  2. Find your IQOQ job (it may be under the Completed tab — see the note below about Failed jobs).
  3. Click the job to open its details.
  4. In the output files section, find the file named JuliaHub_IQOQSummaryReport*.pdf and click the download link.

This PDF is the qualification report. Store it alongside your other compliance records.

Failed Jobs Still Produce a Report

If one or more internal qualification checks fail, the job's status will be Failed rather than Completed, and it will appear under the Completed tab in the Jobs list. The PDF report is still produced and uploaded — the report itself documents which checks passed and which failed. A Failed status means "at least one check failed," not "no report was produced." Open the PDF to see what didn't pass.

Collecting Raw Test Artifacts (Optional)

If you need to drill into the underlying test outputs — for example, to share with JuliaHub support during an audit — you can ask the job to also collect the raw Playwright test artifacts alongside the PDF. This requires launching with custom configuration so you can set an environment variable:

  1. On the IQOQ Test card, click Launch with custom configuration instead of plain Launch.
  2. In the launch dialog, add a user environment variable:
    • Name: IQOQ_DEBUG
    • Value: true
  3. Click Start.

The job's results will then include an iqoq-debug/ directory with the raw test results, HTML report, and metadata files. Without this flag, only the PDF is uploaded.

Troubleshooting

The IQOQ Test app card doesn't appear under Applications. Confirm you're logged in as a customer admin. If you are and still don't see it, contact JuliaHub support.

The job has been running much longer than 35 minutes. Open the job details and check the logs for errors. If the platform itself is under heavy load or a dependency is unavailable, the qualification checks can take longer than usual. If the job appears stuck, stop it and re-run; if it stalls again, contact JuliaHub support with the job name.