Skip to main content

Manual execution

Execution format

./pandora_oculix.exepandora_playwright --scriptc <path to oculix scriptconf.json> \-s <test.ts> --conft <path to .conf file> \
--jar <path to oculix JARtask_name> \
  [--workspacei <workinginterval>] directory[-g <group_id>] \
  [-x [-debugS <debugserver:port>] level[-T <temp_folder>]] \
  [-v]
  • Without -console]x, \the [--native-access]plugin \prints [--checkpoint]Discovery \ [--artifacts <artifacts directory>] \ [--phase-names <phase names, comma-separated>] \ [--transaction <transaction name>] \ [--retries <number of retries>] \ [--post-command <commandJSON to executeSTDOUT after(native completion>]Discovery task mode).
  • With -x, it builds agent XML and sends it via Tentacle directly (standalone/manual mode).

Examples

SingleNative scriptmode (backwardJSON compatible)to STDOUT, as run by a Discovery task):

./pandora_oculix.exepandora_playwright --scriptc scripts/login.pyconf.json --confs oculix.conftask.spec.ts --jart oculix.jarqa-test -g 0 -debug 1v

WithStandalone baselinemode andagainst console:a real Pandora server (creates real agents/modules via Tentacle):

./pandora_oculix.exepandora_playwright --script scripts/login.pyx --confS oculix.conf127.0.0.1:41121 \
    --jarc oculix.jarconf.json -s task.spec.ts -t qa-console -g 2 -checkpointT /tmp

Multi-phaseRemote transactionworker with(Docker retries:runs over SSH; worker_mode=remote in conf.json):

./pandora_oculix.exepandora_playwright --scriptc login.py,search.py,logout.pyconf_remote.json --phase-namess Login,Search,Logouttask.spec.ts --transactiont "MiApp"qa-remote --retriesg 20 --conf oculix.conf --jar oculix.jar --debug 1v

Verbose mode

With-v post-prints a timestamped, step-by-step trace to STDERR — useful for manual runs. It logs every Docker/SSH command afterverbatim completion:($ local, ssh$ remote), the config summary, report size, screenshot harvest, per-agent build, and emission summary:

Task <id>: worker=remote browser=chromium image=...:noble timeout=15s ...
Connecting SSH to 10.0.0.5:22 as root
SSH authenticated
SCP test.ts -> /pandora_oculix.exetmp/<id>.spec.ts
ssh$ docker run -d --scriptname login.py,search.py,logout.py<id> ...:noble sleep 300
ssh$ docker cp "/tmp/<id>.spec.ts" <id>:/pandora/task.spec.ts
ssh$ docker exec <id> sh -c 'cd /pandora && ... npx playwright test ... --phase-namesreporter=json'
Login,Search,Logoutssh$ docker exec <id> cat /tmp/report.json
Report retrieved (10744 bytes)
Screenshot harvested: .../test-failed-1.png (7416 b64 chars)
ssh$ docker rm --transactionf "MiApp"<id>
--post-commandAgent "echoa...  Done"[passing --confcheckout]: oculix.confPASS, --jar2 oculix.jarphases, --debug9 1modules
Emitting monitoring_data: 2 agents
Back to top