This Docker image runs an instance of XAgent. It actually contains all the available fat clients (XAgent, XContinuousIntegration, XImporter, XReportDebugger, XReportGenerator, XDatabaseShifter and even XStudio) for linux.
The tag (i.e. "6sp4") represents the version of XAgent installed. Please refer to https://www.xqual.com/documentation/install/install_xstudio_docker.html#Versions to use a version compatible with the xqual/xstudio-mariadb image's version.
The docker needs a few parameters to be customized with your own preferences:
| Parameter | Description | Example |
|---|---|---|
| SERVER_NAME | Name of the server | xstudio-prod1.acme.com |
| SERVER_PROTOCOL | Protocol to connect to the server | http (or https if you provide a SSL certificate) |
| SERVER_PORT | Port to connect to the server | 8080 (or 8443 if you provide a SSL certificate) |
| XSTUDIO_USER | Name of the XStudio account that will be used to connect to the REST API | admin |
| XSTUDIO_PASSWORD_ENCRYPTED | Encrypted password that will be used to connect to the REST API | password |
| XAGENT_ALIAS | Alias that the agent will use | - |
| LICENSE_KEY (opt.) | The license key you purchased from us. If you do not provide a license key, the server will stay in community version with all its limitations | - |
As you can see, this docker image can take a few optional parameters which are used only if you wish to:
Based on the above example values, the image can be run in a container using the command:
docker run --name xagent-linux-container
-e SERVER_NAME=xstudio-prod1.acme.com
-e SERVER_PROTOCOL=http
-e SERVER_PORT=8080
-e XSTUDIO_USER=admin
-e XSTUDIO_PASSWORD_ENCRYPTED=984F1197F84B21DDA2A631F72F9D082501B4FA1AA3798DC420A26ADE0B8792504325EBD701
-e XAGENT_ALIAS=DockerAgent1
-e LICENSE_KEY=<license_key>
xqual/xagent-linux:6sp4
That's it! the XAgent is running and you can run some test sessions on this agent (aliased as DockerAgent1)
NOTE: When the container is running, you can connect to it (for instance to check the log) bu running the command:
docker exec -it xagent-linux-container bash
If you don't want the container to run XAgent by default but only get an interactive access to the container, use:
docker run --name xagent-linux-container
-it
-e SERVER_NAME=xstudio-prod1.acme.com
-e SERVER_PROTOCOL=http
-e SERVER_PORT=8080
-e XSTUDIO_USER=admin
-e XSTUDIO_PASSWORD_ENCRYPTED=984F1197F84B21DDA2A631F72F9D082501B4FA1AA3798DC420A26ADE0B8792504325EBD701
-e XAGENT_ALIAS=DockerAgent1
-e LICENSE_KEY=<license_key>
xqual/xagent-linux:6sp4 bash
In this case, you will need first to the run the configuration manually:
root> /root/config-app.sh
Then run manually XAgent (or any other program in /usr/local/xqual/xstudio):
root> cd /usr/local/xqual/xstudio
root> java -jar xagent.jar --alias DockerAgent1 --headless true
Content type
Image
Digest
sha256:a3332caf3…
Size
389.9 MB
Last updated
17 days ago
docker pull xqual/xagent-linux:v15sp2