How to install SysON?

This section delves into the detailed step-by-step instructions for installing SysON. Detailed explanations walk you through each step.

Before you proceed with the installation, please ensure you have the following prerequisites:

Java supported version
Docker installed, or an existing supported database installation with a user that has administrator privileges.

1. Get SysON

SysON is distributed as a single executable Java Archive JAR which contains the complete SysON application along with all its dependencies. This distribution simplifies the setup process, enabling convenient exploration of SysON’s features.

To download the latest pre-built JAR for SysON, follow these steps:

Before you begin the installation process, navigate to the download page for org.eclipse.syson.syson-application-YYYY.M.X.jar to access all versions.
Identify the SysON latest available version for download.
Click the latest version to open its specific page.
In the Assets section, locate the JAR file named org.eclipse.syson.syson-application-YYYY.M.X.jar.
Click the JAR file to start the download to your local machine.

This process ensures that you get the most recent version of the SysON application in the form of a pre-built JAR file.

2. Start the database instance

SysON uses PostgreSQL as its database.

For development or local testing, the simplest approach is to initiate a PostgreSQL instance using Docker.

docker run -p 5434:5432 --name syson-postgres \
                            -e POSTGRES_USER=dbuser \
                            -e POSTGRES_PASSWORD=dbpwd \
                            -e POSTGRES_DB=syson-db \
                            -d postgres

This may take a while the first time you run this as Docker will first pull the PostgreSQL image.

If you don’t have Docker or prefer to use an existing PostgreSQL installation, modify the following command-line parameters and ensure the POSTGRES_USER possesses administrative rights on the database. These rights are necessary for the automatic creation of the database schema.

3. Start the application

To run the application, you’ll need to use the Java Runtime Environment (JRE) to execute the pre-build JAR (org.eclipse.syson.syson-application-YYYY.M.X.jar) you downloaded earlier.

java -jar syson-application.jar \
          --spring.datasource.url=jdbc:postgresql://localhost:5434/syson-db \
          --spring.datasource.username=dbuser \
          --spring.datasource.password=dbpwd \
          --spring.liquibase.change-log=classpath:db/changelog/syson.db.changelog.xml

4. Open your web browser

Navigate to http://localhost:8080 to experience SysON.

To end your local testing session, ensure you stop the running PostgreSQL Docker container using the command docker kill syson-postgres. Please note that this will erase all the data you have generated during testing.

If you encounter any issues during the installation process, please refer to the troubleshooting guide for detailed solutions.

5. Other resources

Configuring HTTPS for local server deployment of SysON