Step-by-step Install Guide for Ubuntu

What you need to start

Ubuntu 7.10 (Gutsy Gibbon)
Internet connection.
30 minutes.

Directions

Create Users for Ubuntu

Create a standard user

sudo adduser argos

Answer the questions and then press y.

Add users to sudoers file

The sudoers (/etc/sudoers) file is a very special file. To edit it, you should use the command visudo which must be run as root or by using sudo.

sudo visudo

Add user alias:

User_Alias WEBMASTERS = argos

Add user specifications[1]

WEBMASTERS ALL=(ALL) ALL

The Sudoers File

After the modification, the sudoers file should look like this:

# /etc/sudoers
#
# This file MUST be edited with the 'visudo' command as root.
#
# See the man page for details on how to write a sudoers file.
# Host alias specification

# User alias specification
User_Alias WEBMASTERS = argos
# Cmnd alias specification

# Defaults

Defaults        !lecture,tty_tickets,!fqdn

# User privilege specification
root    ALL=(ALL) ALL
WEBMASTERS ALL=(ALL) ALL

# Members of the admin group may gain root privileges
%admin ALL=(ALL) ALL

Install PostgreSQL

Download and install PostgreSQL

To install PostgreSQL, we need to login to the server, and type following commands:

sudo apt-get install postgresql

Press Y to continue.

Create user for PostgreSQL

We now need to create the database user 'argos'.

sudo -u postgres createuser -D -A -P argos

Enter in a DatabasePassword here, then answer 'Y' to the question.

Create database

We now need to use command createdb[2] to create the database 'argos' for the user 'argos'. You'll need to enter the password that you just created.

sudo -u postgres createdb -W -E utf8 -O argos argos

Restart PostgreSQL

Now, restart PostgreSQL.

sudo /etc/init.d/postgresql-8.2 restart

Install Apache2

Instal apache2

Install Apache2.2 by following command:

sudo apt-get install apache2 libapache2-mod-php5 php5-pgsql

Create Argos documents root directory.

cd /var/www/
sudo mkdir argos.hypertopic.org

Make a new "sites-available" file

In the /etc/apache2/sites-available/ directory, you will see a default file called "default". Use this as a template for your virtual host files. To to this, simply make a copy of it, that is renamed something else. For example:

cd /etc/apache2/sites-available/
sudo cp default argos.hypertopic.org

Edit the new "sites-available" file

Now you need to edit the file you have just created so that it will work for Argos.

sudo vi argos.hypertopic.org

Below is an example of how the beginning of the edited new "sites-available" will look:

<VirtualHost *:80>
        ServerName      argos.hypertopic.org
        ServerAdmin     aurelien.benel@utt.fr

        DocumentRoot "/var/www/argos.hypertopic.org/"
    <Directory "/var/www/argos.hypertopic.org/">
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        Allow from all
    </Directory>

    ErrorLog /var/log/apache2/argos.hypertopic.org-error.log
    LogLevel warn

    CustomLog /var/log/apache2/argos.hypertopic.org-access.log combined
    ServerSignature On
   
    #Allows URLs which contain encoded path separators to be used. 
    AllowEncodedSlashes On
</VirtualHost>

If you have no virtual host, you can remove the first line NameVirtualHost * that is copied from the default file.

Enable the site to "site-enabled"

Now, you need to enable this site. To do this type:

sudo a2ensite argos.hypertopic.org

You also need to disable the default site.

sudo a2dissite default

Enable mod_rewrite on Apache

Argos needs rewrite URL to php scripts, you should enable mod_rewrite on Apache.

sudo a2enmod rewrite

Enable mod_headers on Apache

For customization of HTTP request and response headers, you should enable mod_headers on Apache.

sudo a2enmod headers

Restart Apache

For the Apache settings to take effect, you need to restart Apache2.

sudo /etc/init.d/apache2 restart

Install Subversion

To install subversion, just type following command:

sudo apt-get install subversion

Press Y to continue the install.

Install Argos

Get latest Argos code

Check out the latest version from subversion:

cd /var/www/argos.hypertopic.org
sudo svn checkout https://argos-viewpoint.svn.sourceforge.net/svnroot/argos-viewpoint/trunk .

Press Y to continue.

In the future you will be able to update to the latest version using:

svn update

Set up Argos

Directory & File Permissions

Create an empty configure file name config.inc.php or just rename config.sample.inc.php to config.inc.php.

Set correct permissions for all your configuration files. Installation process can not be completed until you set writable permissions for config.inc.php and .htaccess in your Argos root directories.

Run Installation Script

Run the Argos installation script by accessing install/index.php in your favorite web browser.

If you installed Argos in the root directory, you should visit: http://example.com/install/index.php
If you installed Argos in its own subdirectory called myargos, for example, you should visit: http://example.com/myargos/install/index.php