HOME Downloads

SimQ Version 1.3
Installation Instructions for Linux

Table of Contents

Overview

This page describes how to install SimQ version 1.3 (released 2024-10-17) on your Linux system. SimQ includes two main components:

Key points about simd installation and runtime behavior:

Prerequisites

Step 1: Prepare Your Environment

  1. Open a terminal window.
  2. Navigate to the directory where you want to download the SimQ package.
  3. Download the latest SimQ release. You can find the latest version on the plato website. You can click on the link to download the archive from a web browser. If you are remote logged into a linux machine here are a couple of ways to do it. Note that you can right-click on the link of the release you want, select "Copy Link Address", and paste it into one of the following commands: 
    wget http://216.16.195.147/downloads/simq.1.2-2024-08-28.linux.x86_64.tar.gz

    or 

    curl -O http://216.16.195.147/downloads/simq.1.2-2024-08-28.linux.x86_64.tar.gz

Step 2: Unpack the Archive and Run the Installer

  1. Unpack the archive: 
    tar xzvf simq.1.2-2024-08-28.linux.x86_64.tar.gz
  2. Navigate to the unpacked directory: 
    cd simq
  3. Run the installer script with sudo privileges: 
    sudo ./linuxinstall.sh

The installer script will perform the following tasks:

Upon completion, the script will ask if you want to start the simd service. Press y (or just hit enter) to start the service, or n to start it later manually.

Configuration File

If this is the first installation, a configuration file named simdconfig.json5 will be created in /etc/simd/ with the following structure:

{
    "CPUs": 120,
    "Memory": "125GB",
    "CPUArchitecture": "x86_64",
    "MaxSimulations": 1,
    "SimdSimulationsDir": "/var/lib/simd",
    "DispatcherURL": "http://216.16.195.147:8250/"
}

Configuration values:

You can manually adjust these settings if needed, but the auto-detected values should work for most cases.

Step 3: Managing the simd Service

Use the following commands to manage the simd service:

Command Description
sudo systemctl start simd Starts the simd service
sudo systemctl stop simd Stops the simd service
sudo systemctl restart simd Restarts the simd service
systemctl status simd Reports the current status of the simd service
systemctl is-enabled simd Reports whether the simd service is enabled to start at boot
tail -n 30 /usr/local/simq/simd/simd.log View the last 30 lines of simd.log
journalctl -u simd View system logs related to the simd service

Step 4: Using psq

psq (Plato Simulation Queue) is used to add, remove, and manage simulation jobs. Jobs added to the simulation queue will be executed by the first available simd instance in the network.

To use psq:

  1. Add /usr/local/simq/bin to your PATH: 
    echo 'export PATH=$PATH:/usr/local/simq/bin' >> ~/.bashrc
source ~/.bashrc

For more detailed information on using psq use the 'help' command at the psq prompt.

Post-Installation Verification

  1. Check if the simd service is running, you should see "active (running)" in the output: 
    systemctl status simd
  2. Verify psq is accessible, this should display the version number of psq: 
    psq -v

Troubleshooting

Uninstallation

To remove SimQ from your system you can run the linuxuninstall.sh script:

sudo ./linuxuninstall.sh -v

This will do the following:

Support and Contact Information

If you encounter any issues not covered in this guide or have questions about SimQ:

Changelog

1.0 - Initial release

1.1 - Updates

1.2 - Updates

1.3 - Updates