Skip to end of metadata
Go to start of metadata

Initial set up

Follow these instructions to instantiate a containerized instance of the MES Platform 3 demo server. At the current time, the produced instance uses Ignition 7.9.12, with 3.79.2 RC2 MES modules, using a MySQL 8.0.23 database.

Note: This setup relies on Docker Desktop. Installing Docker Desktop will enable Hyper-V, a Microsoft virtualization technology. Enabling Hyper-V will may conflict with older versions of VirtualBox, so if you rely on VirtualBox you may not want to proceed.

Prerequisites: Windows 10

Uninstall Docker Toolbox if you have it

  1. If you have installed Docker Toolbox, an older version of Docker on Windows, then uninstall it.

Installing Docker Desktop

  1. Download Docker Desktop for Windows
  2. Install Docker Desktop with the default options.
  3. Restart windows when prompted by Docker Desktop installer.
  4. You may be prompted to download WSL 2 Linux kernel updates and install them. If so, follow the links in the prompt then download and install the additional software.
  5. After restarting, Docker should start up automatically. It shows as an icon in the system tray (the area with small icons in the bottom right of the the windows task bar).
  6. Wait until Docker has completed starting. The system tray icon will be moving if it is in the process of starting up.

Installing/Running Sepasoft Demo

  1. Download sepasoft_demo.zip
  2. Extract the contents of the zip file. This can be done by right clicking on the file, selecting "Extract All" from the context menu, selecting where to extract the contents, then clicking the "Extract" button.
  3. In the extracted contents, there should be folder named sepasoft_demo. Under it there will be these files:
    docker-compose.yml
    configure_port.bat
    run.bat
    remove_containers_and_data.bat
    stop.bat
  4. The Ignition port for the Sepasoft Demo defaults to 9088. If you wish to change the default port then double-click configure_port.bat to run it and then enter the desired port number and hit enter. Otherwise go to step 4.
  5. Double click run.bat to run Ignition and it's corresponding MySQL database. Docker must already be running or you'll get an error. If Docker is not running then start Docker and try running the file again. If Windows Smart Screen blocks you from running the file, click "More Info", and then "Run anyway". The first time this is run it will download several hundred MB of data so it may take a while.
  6. When the process is complete you should see a message "Successfully started the sepasoft demo server. Open http://localhost:9088 in a web browser to use it".
  7. It will still take a minute or two for everything to finish starting up. Ignition will restart itself once after loading the demo project, so don't be surprised if Ignition stops then starts again during this process.
  8. The gateway has 2 users:
    1. Configurator
      1. Password is password
      2. Grants access to designer and configuration pages of Gateway
      3. Also grants access to Client with full MES privileges
    2. admin
      1. Password is password
      2. Grants access to Client with limited MES privileges
  9. If counts aren't coming through or OEE is not calculating, please try restarting the Production Module on the Config→Modules page.

Stopping Sepasoft Demo

The demo server will remain running unless you either stop it with the stop.bat script, or stop Docker. To stop it with the script:

  1. Find the stop.bat file that was extracted in the "Installing Sepasoft Demo" steps. If Windows Smart Screen blocks you from running the file, click "More Info", and then "Run anyway".
  2. Double-click the file to run it.
  3. If successful you'll see a message "Successfully stopped the Sepasoft demo server. You may close this window.

Removing Sepasoft Demo

Performing these steps will remove

  1. Find the remove_containers_and_data.bat file that was extracted in the "Installing Sepasoft Demo" steps. If Windows Smart Screen blocks you from running the file, click "More Info", and then "Run anyway".
  2. Double-click the file to run it.
  3. If successful you'll see a message "Successfully removed the Sepasoft demo server. You may close this window."


  • No labels