Let's begin by describing Heroku.Heroku is a cloud application platform a new way of building and deploying web applications,(www.heroku.com). This guide provides the steps required for creating a Heroku account, instaling Heroku Toolbelt, configuration and last deployment in the Heroku environment.
Create a Heroku account
- Go to www.heroku.com and hit sign up button, add your credentials and hit Create Free Account.
Go to your dashboard to start creating the application environment.
Installing Heroku toolbelt
What is it? Heroku client - CLI tool for creating and managing Heroku apps
- Go to https://toolbelt.heroku.com
- Hit the download button for you OS.
Instal the Heroku-deploy plugin
This project is a Heroku toolbelt plugin for deploying WAR files. It can also be used to deploy executable JAR files.
- Go to https://github.com/heroku/heroku-deploy or using the Heroku toolbelt
Add the line
export
JAVA_OPTS=
"$JAVA_OPTS -Xms128m -Xmx512m"
Restart Tomcat after the file is edited and saved. You can confirm that Tomcat has picked up the correct settings by running
ps aux | grep java |
and see that the settings for -Xms
and -Xmx
are as desired.
Database connection
When Tomcat is installed, please refer to Connecting TermWeb to a Database for setting up and configuring the database.
Web application installation
Copy the termweb.war
file to <tomcat-install>/webapp
. The war file is extracted automatically into <tomcat-install>/webapps/termweb
if Tomcat is running.
In the file <tomcat-install>/webapps/termweb/WEB-INF/termweb.properties.sample
you will find settings that may have to be adjusted according to your environment. Rename this file to termweb.properties
and edit the values for termweb.home
, base.url
and work.dir
values.
Please note
Prior to TermWeb v3.15, all changes to termweb.properties
requires a restart of TermWeb webapp or Tomcat to take effect.
Logging
Configuration for logging is configured in <tomcat>/webapps/termweb/WEB-INF/log4j.properties
. You may need to change the path to the log file (log4j.appender.logfile.file
) to make TermWeb write its log file in desired location.
See http://logging.apache.org/log4j for more information about logging configuration options.
Set Environment Variable
Set the TERMWEB_HOME environment variable according to the instructions in Setting TermWeb Home Directory and copy termweb.properties
and log4j.properties
to the directory specified by the variable.
Installation complete
Start up Tomcat and check the log files for any errors.
Open your browser and enter http://localhost:8080/termweb. TermWeb now asks for a license. Enter the license that you have received from Interverbum Technology.
You should now see the TermWeb login screen. You can log in with client admin
, user admin
and password admin
.
Congratulations! Your TermWeb deployment on Heroku is now completed!