• docker
• docker-compose

• Easy installation via Docker

The official Xyna applications are included in the Xyna-Factory bundle, which is located in the directory /tmp/XynaFactoryBundle inside the xyna container. The file has the following format: XynaFactory_<version>_<timestamp>.zip. Execute the command

docker cp xyna:/tmp/XynaFactoryBundle/XynaFactory_<version>_<timestamp>.zip .  

to copy the bundle to your local machine. Unzip the archive and use find . -name "*.app" to locate the applications. In the "Xyna Factory Manager" you can click "Import Application" to add the applications you want to use.

When using the containers for developing and testing Xyna, a few configuration changes in the docker-compose.yml are helpful. By default, the xyna container stops when the Xyna-Factory shuts down. To change this behavior set the option

SYNC_CONTAINER_LIFECYCLE_TO_FACTORY=false

to false, to keep the container running independently of the Xyna-Factory process. If you change this parameter before the container was initially created via docker-compose, you need to run the script /k8s/xyna/factory.sh manually once.

Next, we can expose an additional port, e.g. 4000 for remote debugging. Add the following line to the ports property of the xyna service:

ports:
  - 4000:4000

The first number specifies the host port and the second number is the container port. To start the factory in debug mode, run

./xynafactory.sh -d 4000 start

with the correct container port. Then you can remote debug the Xyna-Factory inside the container by attaching to the host port with your IDE.