What does OpenApp Ruby include?
OpenApp Ruby consists of the following software:
- Apache2 with mod_php and mod_passenger
- Mysql server
- OpenPanel with mod-apache2, mod-backup, mod-smtp
Installing OpenApp Ruby
- 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 Ruby
apt-get install openapp-ruby
- During the install, you will get some questions:
- The password that the user root should use to login to Mysql (Twice)
- 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 create a vhost so that you can start using Ruby.
- In the Virtual Host-tab, create a vhost. This will create configuration and a directory structure in /var/www/$domainname. You need to configure your Ruby application via the shell.
- 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
- Login to the Ruby admin-interface at the url you entered in OpenPanel, and don't forget to configure Ruby.
Updating OpenApp Ruby
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.
That will upgrade all the software on the machine.
Backing up OpenApp Ruby
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. In addition to other OpenApp installs, OpenApp-ruby can use xtrabackup. This is useful when you have large (InnoDB) databases that you want to backup. Because xtrabackup doesn't dump the databases like mysqldump does, you do not suffer from locking of large table. To use xtrabackup, you must install it manually. Please see the instructions on the instructions on the Percona website. After you configured the sources of Percona's xtrabackup, type:
apt-get install openapp-xtrabackup
When apt-get is done, the xtrabackupmodule for OpenApp Backup will be enabled.
Building an image
To build an image for OpenApp Ruby (so that you have pre-configured everything for your user) take the following steps:
- Follow OpenApp Ruby#Installing OpenApp Ruby
/var/openpanel/tools/openapp-smtp-configure-postfix "<hostname of the machine>" "<true|false smarthost>" "<smarthost, if former value is true>" "<admin emailaddress>"
openpanel-cli "update user password=<password>"