Step-by-step Install Guide for Ubuntu
From Hypertopic
Contents |
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 "000-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 000-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 000-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>
ou 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 000-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 Argo
Directory & File Permissions
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
IMPORTANT! After installation is complete remove install/ subdirectory in your Argos script directory.
Finnally, you're finished. Congratulations!
