AppSuite:InstallerCollection

Revision as of 10:08, 21 December 2009 by Mheiland (talk | contribs) (Usage Example)

Open-Xchange Server quick installation script

Purpose

When deploying a lot of Open-Xchange Server installations, either for testing or for production, manual configuration becomes annoying. At Open-Xchange we set up hundreds of installations a week - just for testing. This requires an automated process and universally usable deployment tools. While setting up a test system usually occurs unattended, setting up a productive system requires user interaction. To ease the installation process, even for single installation, we've released this quick installation script to the public.

Supported platforms

The script supports all Linux distributions Open-Xchange supports commercially.

  • Debian 4.0 (Etch)
  • Debian 5.0 (Lenny)
  • SuSE Linux Enterprise Server 10 (SLES10)
  • SuSE Linux Enterprise Server 11 (SLES11)
  • RedHat Enterprise Linux 5 (RHEL5)

Contributions

The script is written in bash and does not require any tools installed on the target system. Is structured pretty simple and designed to be extensible for additional Linux distributions to support. Feel free to add support for any distribution you like and send patches.

Download

The script is available through our Subversion repository.

$ svn --password "" --username anonymous co https://svn.open-xchange.com/ox-quickinstall/

Usage

Just run the script within a bash

$ ./ox-quickinstall.sh

Use -u <version> to run in unattended mode. Make sure to configure the unattended mode before since the defaults won't work externally.

$ ./ox-quickinstall.sh -u 6.14

or, depending on the repository

$ ./ox-quickinstall.sh -u 6.14-rev5

Usage Example

lenny:~# ./ox-quickinstall.sh 
Checking user...OK.
Checking operating system...Linux, DebianLenny

Enter the Open-Xchange Server version to install. Please keep in mind that only the most current release contains latest features and bugfixes.
* 6.12
* 6.14
* snapshot (Unstable, development release)
What version do you want to install? 6.14

If you have a valid Open-Xchange maintenance subscription, please enter the LDB account credentials. Using your subscription will enable the system to get personal fixes and additional products. If you don't have a maintenance subscription, do not enter anything and press enter. You can add a maintenance subscription at any time after the installation as well.
LDB username: maintenanceaccount
LDB password: ********

Please enter an Open-Xchange Server license code. If you do not plan to license this Open-Xchange Server installation, do not enter anything and press enter. You can add a license code at any time after the installation as well.
OX License: 13374711

Do you accept the Operating System Distributor License for Java?
See http://download.java.net/dlj/DLJ-v1.1.txt for details.
Do you accept the license agreement? [y/n]: y

No installation of MySQL has been found. The installer will install MySQL.
Please provide a strong password for the MySQL 'root' user: ********
Please enter again for verification: ********

To enable database access for Open-Xchange Server, this installer will create a new user account 'openexchange' within MySQL.
Please enter a strong password for the MySQL 'openexchange' user: ********
Please enter again for verification: ********

Open-Xchange Server requires a low-level administrator called 'oxadminmaster'. This user is required to manage contexts or add resources like databases or storage.
Please enter a strong password for the 'oxadminmaster' user: ********
Please enter again for verification: ********

The installer will create a single groupware context. This context requires a administrative user called 'oxadmin'. This user is required to manage users, groups and resources inside the context. This user also becomes the owner of shared objects where the original owner has been deleted.
Please enter a strong password for the 'oxadmin' user: ********
Please enter again for verification: ********

The installer will create a single user within the default context for testing purposes. Please note that the users password must be equal to the IMAP accounts password. In contrast to this wizard, users are typically created using command line tools. Please refer to the documentation how to use those tools.
Do you want to create a user? [y/n] y
Please enter a username: ttester
Please enter a strong password for the user: ********
Please enter again for verification: ********
Please enter the users givenname: Tony
Please enter the users surname: Tester
Please enter the users e-mail address: tony@ox.io
Please enter the users e-mail account IMAP server: ox.io
Please enter the users e-mail account SMTP server: ox.io
Please enter the login name for the users IMAP account: tony

### Installation summary ###

Open-Xchange Server version 6.14 will be installed. Apache httpd will be auto-configured to serve the web interface at http://your-server.tld/ox6/ by default. New database schema will be created within MySQL (configdb, oxdatabase). A new password protected and access restricted user 'openexchange' will be added to MySQL.

* A groupware user 'ttester' will be created within the default context.
* Using maintenance account maintenanceaccount.
* Using license code 13374711.

Open-Xchange Server and other components use default configuration, please review it before going to production with this system.
Please report any problems at https://bugs.open-xchange.com/.
Contact the Open-Xchange Community through the forums, wiki or IRC, see http://oxpedia.org/ for more information.
Support Open-Xchange by buying support/licenses at http://www.open-xchange.com/

In order to complete the installation, several software packages are downloaded. Depending on the network connection speed, this might take a while.

Press enter to start the installation

Adding Open-Xchange repository build key...OK
Adding repository information...
Installing packages...

[package manager output]

Configuring compatible JVM...
Adding database user 'openexchange' to MySQL...
Creating filestore at '/var/opt/filestore/'...
Creating 'configdb'...
Creating basic configuration...
Starting admin service...
Sleeping 10 seconds...
Registering groupware system at the database...
Registering filestorage at the database...
Registering groupware database at configdb...
Loading Apache httpd modules...
Configuring Apache proxy_ajp...
Configuring Apache mod_deflate...
Configuring Apache mod_expires...
Restarting web server: apache2 ... waiting .
Starting groupware service...
Creating default context (contextid: 1)...OK.
Creating testuser in default context...OK.

Installation complete, thanks for using Open-Xchange Server. Have a lot of fun!

lenny:~#