Page History
| Table of Contents |
|---|
Example package
| Warning |
|---|
| These procedures are intended for users with Docker knowledge. We do not provide Docker support, just provide guidelines on how to use it with our product. For more information about Docker, see https://docs.docker.com/ |
This page provides an example package for building Cassandra and Magic Collaboration Studio components from a Magic Collaboration Studio No-Install package. The example package uses Docker Compose to build all the components required to deploy a fully-functional Magic Collaboration Studio containerized environment. Such an environment can be deployed in an orchestration framework to enhance scaling and management.
Magic Collaboration Studio Container Example Package Components
Docker Hub Pulled Images:
- Cassandra 4.1.1
- Zookeeper 3.7.0
- ZooNavigator 1.1.1 (elkozmon) (optional)
- Elasticsearch 7.16.2
External Packages:
- Magic Collaboration Studio 2024x Refresh1 No-Install Linux (downloaded from the 3DS software download page)
- ActiveMQ Artemis 2.26.0 (downloaded automatically after executing the containerization environment staging script)
Example with Docker Compose
| Note |
|---|
The example package requires at least 32GB of available RAM. |
- Download and extract the example package into an empty working directory.
- Download a 2024x or later version of Magic Collaboration Studio No-Install Linux package.
- Rename or symbolically link the no-install package to twcoudsuite.zip.
- Execute the config.tw-compose.sh script to stage the containerization environment.
Run the following command to initialize Docker Compose container configurations:
Code Block language bash theme DJango linenumbers true docker compose build
Run the following command to launch containers:
Code Block language bash theme DJango linenumbers true docker compose up -d
If you execute this command for the first time, it will build the containers as well.
- Use the following URLs:
To access web UI:
Code Block language bash https://host.docker.internal:8443/webapp
To connect from a modeling tool client (with default port 3579):
Code Block language bash host.docker.internal
To access REST API/Swagger Page:
Code Block language bash https://host.docker.internal:8111
| Info |
|---|
You can apply the Magic Collaboration Studio license via the web UI or REST API. |
Helpful commands
To follow the output (tail) the output of a specific container:
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
docker compose logs -f <Container Name or ID> |
To stop all containers but retain data in non-persistent storage:
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
docker compose stop |
To stop all and remove all running containers (non-persistent storage data will be lost):
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
docker compose down -v |