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