Skip to content

Installing Martini Server Runtime On-Premise

On-Premise Windows Installation

Setting up Martini Server Runtime on a Windows environment is straightforward. The process involves downloading the Windows installer and following a few simple steps to get the server up and running.

Installing Martini Server Runtime on Windows

1. Download the Installer

2. Run the Installer

  • Navigate to the location where the installer was downloaded.
  • Double-click the installer file to begin the installation process.

3. Follow the Installation Prompts

  • The installer will guide you through a series of steps. Follow these prompts to complete the installation.
  • You may be asked to specify installation preferences such as directory location, components to install, and configuration settings.

Post-Installation Steps

  • License Installation: Remember to install your Martini Server Runtime license. Without a valid license, the server will not function properly.
  • Initial Configuration: Configure Martini Server Runtime according to your requirements. This may include setting up connections, adjusting server settings, and more.

Installing Martini Server Runtime on Linux

Installing Martini Server Runtime on Linux can be done using a GUI-based setup or via the command line for CLI environments or headless servers. Follow these steps to install Martini on your Linux system.

Installing via GUI

1. Prepare for Installation

  • Open a command-line application.
  • Change to the directory where the Martini_Runtime.sh shell executable file is located: 
    1
    cd path/to/directory

2. Start the Setup Wizard

  • Run the following command to initiate the GUI-based setup wizard: 
    1
    sh Martini_Runtime.sh
  • Follow the on-screen prompts in the setup wizard to complete the installation.

Installing via Command Line

For CLI environments or headless servers, you have two options:

Console Mode

  • For interactive console-based installation, use the -c flag: 
    1
    sh Martini_Runtime.sh -c
  • Follow the console prompts to complete the installation.

Unattended Mode

  • For a non-interactive, unattended installation, use the -q flag: 
    1
    sh Martini_Runtime.sh -q
  • This mode will install Martini Server Runtime with default settings and no user interaction.

Post-Installation Steps

  • License Installation: Ensure to install your Martini Server Runtime license. The server requires a valid license to function correctly.
  • Initial Configuration: After installation, configure the Martini Server Runtime according to your specific needs and requirements.

Installing Martini Server Runtime on macOS

Installing Martini Server Runtime on a macOS system is a straightforward process. This guide will walk you through downloading the macOS installer and completing the installation steps.

Steps to Install on macOS

1. Download the Installer

2. Run the Installer

  • Locate the downloaded installer file in your Downloads folder or wherever you have saved the file.
  • Double-click the installer to initiate the installation process.

3. Follow the Installation Prompts

  • The installation wizard will guide you through several steps. Follow these prompts, which may include agreeing to terms, choosing an install location, and selecting installation options.

4. Complete the Setup

  • Once all prompts are addressed, complete the installation process.
  • You may need to enter your macOS user password to grant necessary permissions for the installation.

5. Verify Installation

  • After installation, you can verify that Martini Server Runtime is installed correctly by opening a terminal and checking for the Martini service.

Post-Installation Steps

  • License Installation: Ensure you install your Martini Server Runtime license. The server requires a valid license to operate effectively.
  • Initial Configuration: Set up and configure Martini Server Runtime according to your specific needs. This may include network configurations, service setups, and other custom settings.

Deploying Martini Server Runtime within a Docker Container

Docker simplifies application deployment by bundling applications and their underlying operating systems, making them portable across environments. This guide will walk you through deploying Martini Server Runtime using Docker.

Docker Image

The official Martini Server Runtime Docker image is available on the Docker registry. It's based on Alpine Linux and comes pre-configured for production use.

Details

  • Image Base: Alpine Linux
  • Exposed Ports:
  • 8080
  • 8443: Although the Dockerfile exposes port 8443, by default the Martini Server Runtime Docker image is configured to serve requests over HTTP only.
  • Default Configuration: HTTP-only setup
  • Working Directory: /data
  • Environment Variables:
  • JAVA_XMX: Maximum heap memory for Java
  • JAVA_XMS: Initial heap memory for Java
  • Entry Point: /data/bin/toro-martini

Deployment Steps

Prerequisites

Ensure Docker is installed on your system.

Important directories

Normally, when a Docker instance is stopped and removed, the data inside the container will be lost unless you have defined the directories or files as volumes for them to be persisted. As such it is important to mount the following directories:

  • For a standalone instance of Martini Server Runtime mount the following directories:

    • /data
    • /conf/db-pool
    • /conf/overrides

  • Where multiple instances of Martini Server Runtime are running in the same environment with a shared configuration mount the following directories only:

    • /conf/db-pool
    • /conf/overrides

NOTE: The /data directory contains files related to Martini's embedded databases and message queues. It is not recommended to use these embedded databases and message queues for larger production environments or where two or more Martini Server Runtime instances are running. Martini Server Runtime creates locks on these files and as such the /data directory should not be mounted where two or more instances would be sharing the same folder.

1. Prepare Data Directories

Create directories on your host machine to persist Martini Server Runtime data:

1
mkdir -p /opt/apps/Martini-Runtime/{data,db-pool,overrides}

2. Deploy Martini Server Runtime

Start the Martini Server Runtime container with mounted volumes:

1
2
3
4
5
docker run -p 8080:8080 \
-v /opt/apps/Martini-Runtime:/data \
--privileged=true \
--name martini \
toroio/martini-runtime

3. Verify Deployment

Check if the container is running:

1
docker ps

Upgrading Martini Server Runtime

To upgrade to the latest version:

  1. Pull the latest image:
1
docker pull toroio/martini-runtime:latest
  1. Delete the existing container:
1
docker rm -f martini
  1. Start a new container with the latest image, following the deployment steps above.

Memory Considerations

For memory-intensive systems:

  • Optimize memory allocation from the Docker container to the JVM using the following command on Docker run:

XX:+UseContainerSupport -XX:MaxRAMPercentage=75.0

The variable 75.0 can be modified to the user's requirements. We recommend setting this option to a value that is less than or equal to 75.0. A value of 75.0 will allocate 75% of the memory allocated to the Docker image to the JVM.

Refer to Docker documentation for detailed resource limitation options.

Post-Installation Steps

  • License Installation: Ensure you install your Martini Server Runtime license. The server requires a valid license to operate effectively.
  • Initial Configuration: Configure Martini Server Runtime according to your requirements.