Installing Martini Server Runtime on Windows

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.

Steps to Install on Windows

1. Download the Installer

Visit the Martini download page at https://www.lonti.com/martini/download.
Download the installer specific to Windows.

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

Visit the Martini download page at https://www.lonti.com/martini/download.
Download the installer for macOS.

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. An efficient approach to ensure data persistence is by persisting the entire /Martini-Runtime folder. This comprehensive strategy ensures that all necessary data for Martini Server Runtime is retained even if the Docker instance is stopped and removed.

1. Prepare Data Directories

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

mkdir -p /opt/apps/Martini-Runtime/{data,packages,code,logs,.java}

2. Deploy Martini Server Runtime

Start the Martini Server Runtime container with mounted volumes:

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:

Pull the latest image:

1	`docker pull toroio/martini-runtime:latest`

Delete the existing container:

docker rm -f martini

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.