Contents 1 What does OpenApp Tomcat include? 2 Installing OpenApp Tomcat 3 Updating OpenApp Tomcat 4 Backing up OpenApp Tomcat 5 Building an image

What does OpenApp Tomcat include?

OpenApp Tomcat consists of the following software:

• Tomcat 6
• Lighttpd with mod_proxy and mod_cgi
• Mysql server
• Postfix
• OpenPanel with mod-tomcat, mod-mysql, mod-backup, mod-smtp
• OpenApp-tuning
• OpenApp-backup

Installing OpenApp Tomcat

• Please note that OpenApp always expects a clean install! /var/www/ and directories like that might be deleted by OpenApp
• Make sure that you have the OpenPanel sources in your sources.list and your softwarelist is up to date. Follow instructions on OpenPanel_and_APT
• Now install OpenApp Tomcat

apt-get install openapp-tomcat

• During the install, you will get some questions:
  • Mysql-server
    • The password that the user root should use to login to Mysql (Twice)
  • Postfix
    • The type of configuration you want. Select 'Internet Site' (press enter). OpenApp will configure postfix later on
    • System mail name. This should be the hostname of your system and should already be entered (press enter). OpenApp can configure this later on
• Set a password for OpenPanel

openpanel-cli "update user password=<your password>"

• You can now login at https://<your ipaddress>:4089/ with the password entered in the previous step
• You are now in the OpenPanel-interface of your machine. Here, you can easily configure backups, outgoing email and the basic settings needed to be able to login on the Tomcat admin-interface.
  • In the Tomcat-tab, you can set a password for the Tomcat Manager. You can also add an SSL-certificate and key if you want your site to support https.
  • Configure your SMTP-settings in the SMTP-tab. If you do not know which smarthost you should be using, you can leave it disabled. That should work in most of the situations.
  • Configure your backups! That will make sure that your machine creates a backup each day/week/month, and will enable you to easily recover from disasters
• Upload your Tomcat appliction via FTP (you can enable it via the 'OpenApp admin'-tab) or via the shell.

Updating OpenApp Tomcat

OpenApp will run apt-get update and apt-get dist-upgrade every night if you enable it in the 'Upgrades'-tab. That will upgrade all the software on the machine and may install new packages when needed.

Backing up OpenApp Tomcat

When you configure backups via OpenPanel, OpenApp-backup will run daily/weekly/montly and leave a executable file in /var/backups/. To restore from this file, please read about OpenApp_Backup.

Building an image

To build an image for OpenApp Tomcat (so that you have pre-configured everything for your user) take the following steps:

• Follow OpenApp Tomcat#Installing OpenApp Tomcat
• Run

/var/openpanel/tools/openapp-smtp-configure-postfix "<hostname of the machine>" "<true|false smarthost>" "<smarthost, if former value is true>" "<admin emailaddress>"

• Run

openpanel-cli "update user password=<password>"