Installing Hyperon Studio

Tomcat

Java

To run Hyperon Studio you will need Java Runtime Environment (JRE) version 11 . Check version of Java available on your system:

$ java -version                           
openjdk version "11.0.11" 2021-04-20
OpenJDK Runtime Environment 18.9 (build 11.0.11+9)
OpenJDK 64-Bit Server VM 18.9 (build 11.0.11+9, mixed mode)

Installing Hyperon Studio

• Download Hyperon Studio Bundle.
• For Linux/Unix or MacOS X, download the .tgz file.
• For Windows, download the .zip file.
• Next, extract Hyperon Studio Bundle to whatever directory you want.

Once archive file is extracted you should see such directory structure:

- hyperon-studio-X.Y.Z/    ($HYPERON_DIR)
  - bin/
  - conf/
  - database/
  - lib/
  - licenses
  - logs
  - temp
  - webapps
  - work

Enter $HYPERON_DIR/bin and execute:

• ./startup.sh on Linux/Unix/MacOS X
• startup.bat on Windows

You can see Hyperon logs in $HYPERON_DIR/logs/hyperon.log:

INFO  [ContextLoader] - Root WebApplicationContext: initialization started
...
INFO  [SpringContextMonitor] - Spring context started, initializing Hyperon Studio...
...
INFO  [SpringContextMonitor] - Hyperon Studio is fully initialized
INFO  [ContextLoader] - Root WebApplicationContext: initialization completed...

Now open your web browser and enter: http://localhost:38080/hyperon/app

You should see login page.

Log in using default credentials:

• username: admin
• password: admin

To stop Hyperon Studio Enter $HYPERON_DIR/bin and execute:

• ./shutdown.sh on Linux/Unix/MacOS X
• shutdown.bat on Windows

Changing the database server

By default, Studio starts with the H2 database. This is a good database for POC or just quick testing. If you decide to take Hyperon further on your journey we strongly recommend switching database for something more robust and reliable like:

• PostgreSQL
• MS SQL Server
• Oracle
• MySQL (since 2.2.0 version)
  

What you need to do is:

1) Add JDBC driver to the $HYPERON_DIR/lib directory. You can get this driver from the product pages:

• PostgreSQL
• MS SQL Server
• Oracle
• MySql

‍

2) Change connection properites in $HYPERON_DIR/conf/application.properties file

hyperon.database.url=jdbc:h2:${catalina.base}/database/hyperon.demo;AUTO_SERVER=TRUE;IFEXISTS=TRUE
hyperon.database.username=sa
hyperon.database.password=sa

to proper ones

‍

More about properties

‍

3) Finally, you need to restart the tomcat server.

Docker

To run Hyperon Studio with docker go to Hyperon Docker Hub

‍