Run Sepasoft Demo with Docker

Setting Up Docker

Initial set up

Follow these instructions to instantiate a containerized instance of the MES Platform 3 demo server. The demo uses Ignition 8.1.22 with 3.81.7 RC1 MES modules, along with a Postgres 14 database.

Prerequisites: Windows 10 or 11

Uninstall Docker Toolbox if you have it

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

Installing Docker Desktop

  • Download Docker Desktop for Windows
  • Install Docker Desktop with the default options.
  • Restart windows when prompted by Docker Desktop installer.
  • 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.
  • Restart your computer if prompted to do so
  • After restarting, Docker should start up automatically. Docker shows as an icon in the system tray (the area with small icons in the bottom right of the the windows task bar). See icon below:
  • 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

  • Download sepasoft_demo.zip
  • 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.
  • 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
  • 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 the next step.
  • Double click run.bat to run Ignition and it's corresponding 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 run.bat runs Docker will download nearly 2GB of data so it may take several minutes. This 2GB is Ignition, the database, and any data associated with the demo project.
  • When the process is complete you should see a message "Successfully started the sepasoft demo server. Open http://127.0.0.1:9088 in a web browser to use it".
  • It will still take a minute for everything to finish starting up.
  • Open http://127.0.0.1:9088 in a web browser to see the Ignition home screen. You can navigate to the Demo application by scrolling down to "Perspective Session Launcher" and clicking "View Projects". On the next screen click the "Launch Project" button.
  • You can log in with one of two users:
    • admin
      • Password is password
      • The password should be changed if the demo server will be accessible by anyone else.
      • Grants access to designer and the Ignition configuration pages settings.
      • Also grants access to the perspective application with full application privileges
    • demo
      • Password is password
      • Grants access to perspective application with limited application privileges

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:

  • Find the stop.bat file that was extracted in the "Installing Sepasoft Demo" steps.
  • Double-click the file to run it. If Windows Smart Screen blocks you from running the file, click "More Info", and then "Run anyway".
  • 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 the demo server and all data associated with it:

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