Other Host Installation of Martini Designer Online

Martini Designer Online is versatile and can be installed on any platform that supports Docker, including various public cloud providers and private servers. This flexibility allows you to choose the hosting environment that best meets your needs.

General Steps for Docker-Based Installation

1. Prepare the Hosting Environment

Set up your hosting environment, which can be a public cloud provider or a your own private server.
Ensure that the environment is configured to support Docker, including enabling any necessary virtualization settings.

2. Install Docker

Install Docker on your chosen host. You can find detailed installation instructions for different operating systems in the Docker official documentation.
Verify the Docker installation by running:

1	`docker --version`

3. Set your License

From the command line of your host machine, set your license as an environment variable:

export LICENSE="<your_license_value>"

4. Create the Worskpace folder and apply permissions

Create a workspace folder.
1
mkdir <workspace-folder>
Apply the following permissions:
1
sudo chmod 777 <workspace-folder>

5. Run the Docker Container

Start the Martini Designer Online container with the following command. This includes port mapping:

docker run --name <container-name> -p 3000:3000 -p 8080:8080 -v ./<workspace-folder>:/home/martini/martini-designer-workspace -e MR_LICENSE=$LICENSE toroio/martini-designer:latest

6. Verify the Installation

Check that the container is running properly:

1	`docker ps`

Access Martini Designer Online via the host’s IP address or domain name in your web browser (e.g., http://your-host-ip:3000).

Using Docker Compose

Docker Compose simplifies setting up Martini Designer by consolidating configurations like ports, volumes, and environment variables into a single file, making it easier to manage and deploy the setup consistently across different environments.

1. Create a folder on your preferred directory

Once created, navigate to your newly created folder and create another folder

1	`mkdir <workspace-folder>`

Give the appropriate permissions to the folder by running
1
sudo chmod 777 <workspace-folder>

2. Create a docker-compose.yml file

Create the file within the first folder you have created.
Here is an example docker-compose.yml file:

services:
  mide-1:
   image: toroio/martini-designer:latest
   container_name: mide-1
   ports:
      - "3000:3000" # Martini Designer UI
      - "8080:8080" # HTTP Port
   volumes:
      - "./<workspace-folder>:/home/martini/martini-designer-workspace" 
   environment:
      - MR_LICENSE=${LICENSE}

You can set the license by creating an .env file in the same folder and inputting the following:

LICENSE="<your-license>"

You can enable other ports such as HTTP ports (8443:8443), ActiveMQ (61616:61616), and Solr (8983:8983) depending on your needs.

3. Start your Docker container

With Docker Compose, you can execute the following commands:

docker compose up -d: starts the docker container in detach mode
docker compose up: starts the docker container in verbose mode
docker compose down: stops the docker container

Other Useful commands are:

docker compose logs -f: Views the docker compose logs in verbose mode
docker compose logs: View the last few lines of the docker compose logs
docker exec -it <container-name> /bin/bash: Enter the console of your container
docker compose down && docker compose pull && docker compose up -d: Update the docker container to the newest image

Network and Security Considerations

Firewall Configuration: Ensure that necessary ports are open in your firewall for Martini Designer Online. Common examples include:
HTTP and HTTPS Access:
- e.g., 8080: If configured to use for default HTTP access.
- e.g., 8443: HTTPS access if SSL is configured.
Secure Connections: Consider configuring SSL/TLS for encrypted communication (HTTPS) using a valid certificate.
Access Controls: Restrict access to Martini Designer Online using firewall rules or security groups, allowing only trusted IP addresses.

Important Notes

Data Persistence: Use Docker volumes or bind mounts to ensure that your data is not lost when the container is stopped or removed.
Security: Configure firewall rules to allow traffic on the necessary ports and secure your Docker host with appropriate access controls.
Resource Allocation: Monitor the resource usage (CPU, memory) of your Docker container and adjust limits as necessary for optimal performance.
Cloud-Specific Configuration: For public cloud environments, refer to the respective cloud provider’s documentation for additional configuration and security best practices.

Troubleshooting

If you encounter issues accessing Martini Designer Online, ensure that the Docker container is running (docker ps) and that there are no network or firewall restrictions blocking the configured ports.