Deploying Hyperon

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:


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