GAMPS Howto

From GoboLinux Knowledge Base

GAMPS is a GoboLinux/Apache/MySql/P/SSL web serving system. This document is intended to be a step-by-step manual on setting up a MySQL database server and Apache web server with PHP/Python/Perl/SSL support in GoboLinux.

Contents 1 MySQL 2 OpenSSL - Part 1 3 Apache 4 OpenSSL - Part 2 5 PHP 6 Python 7 Perl 8 Celebrate

[edit] MySQL

1. First, you have to install MySQL. Fire up a console and type

Compile MySQL

Once you've answered Compile's initial wave of questions, you should have enough time to make yourself some coffee.

1. When the compilation has finished, you may choose a config file to use.
   
   The mysql configuration is stored in /Programs/MySQL/Settings/mysql, and the config file actually used has to be named my.cnf. The default config file is my-small.cnf. If you're happy with this, go to the next step; otherwise choose one of the other config files and overwrite my.cnf with it.
2. Now it's time to start the MySQL server. Do this by typing

StartTask MySQL

The server is now running.

1. Note:
   

   If the server crashes at this moment you might want to check the permissions of /Files/MySQL. Owner and group must both be mysql. You can achieve this by typing

chown -R mysql:mysql /Files/MySQL

and starting the server again.

1. The next step is to set a password for the mysql root user. Type

   mysqladmin -u root password mYNewpAsSw0rD
   

2. If you want to start the mysql server automatically at boot time, type

echo 'Exec "Starting MySQL Database Server..." MySQL Start' \
   >> /System/Settings/BootScripts/BootUp

1. You can test your MySQL installation by typing

mysql -u root -p

If everything worked, you'll be prompted for a password, then taken to the MySQL monitor.

[edit] OpenSSL - Part 1

The OpenSSL installation is divided into two parts. Part 1 is easy:

Compile OpenSSL

[edit] Apache

1. As usual, compiling is the first step:

   Compile HTTPD
   

2. After compilng, Apache should be ready to start. Just type

   StartTask HTTPD
   

3. If you want to start the Apache server automatically at boot time, type

echo 'Exec "Starting Apache Web Server..." HTTPD Start' \
   >> /System/Settings/BootScripts/BootUp

[edit] OpenSSL - Part 2

Todo: To be written.

[edit] PHP

1. To install Apache PHP Module, type

Compile Mod_PHP

This will install the Apache Module only! The CLI version of PHP and PEAR will not build.

1. You have to restart Apache to load the new PHP module

StopTask HTTPD
StartTask HTTPD

[edit] Python

1. Compile the module

Compile Mod_Python

1. Restart Apache again

StopTask HTTPD
StartTask HTTPD

1. If you use HTTPD 2.0.x you have to edit your httpd.conf (/Programs/HTTPD/Settings/httpd/httpd.conf) to load the Python module with Apache. Add the following line after the other LoadModule directives:

LoadModule python_module modules/mod_python.so
AddType application/x-python-code pyo pyc
AddType text/x-python py

[edit] Perl

Todo: To be written.

[edit] Celebrate

You're done! All you have to do now is place your websites at /Depot/WWW/Documents