• A web server - preferably Apache
  • PHP 4.3 or above with xml support
  • SQL server - preferably MySQL 4.1 or above
  • GD or ImageMagick for the photo organizer


  • Un serveur web - de préférence Apache
  • PHP 4.3 ou supérieur avec support xml
  • Un serveur SQL - de préférence MySQL 4.1 ou supérieur
  • GD ou ImageMagick pour l’organiseur de photo

Getting the most recent version

Download the tarball that suits your needs (stable release) from here, for those that like the newest of new you can checkout the latest SVN release. To obtain the SVN release:

svn co svn://

Obtenir la version la plus récente

Télécherger le fichier correspondant à vos besoins (version stable) depuis ici. Pour ceux qui aiment le plus nouveau que nouveau, voue pouvez vérifier les dernières version svn. pour obtenir une svn:

svn co svn://

Installation process

Download the tarball that suites your needs from here.

Extract the tarball:

~>tar -zxvf jaws-[your-tarball-choice]-0.6.0.tar.gz

Change to the newly created Jaws directory:

~>cd jaws

Copy the contents of the html directory to the web server documentation root directory that you wish to use - for example /srv/www/htdocs (you may need root privileges):

~/jaws>cp -r html/* /srv/www/htdocs

Change to the directory that you copied the files to:

~/jaws>cd /srv/www/htdocs

Ensure that the data and include directories are writeable by your webserver:

/srv/www/htdocs>chown -R wwwrun data/ include/

Check what the webserver user is called, on SUSE it is wwwrun, Red Hat it is apache and Ubuntu it is www-data Open install.php in your web browser:

You will be greeted with the following screen:

Follow the instructions on the screen and then click “next”. The next screen asks you to authenticate your installation. This is done by simply creating a text file with the randomly created authentication key that is presented to you like this one:

Once you have done the “key.txt” file as asked and selected next, Jaws then check permissions on the required directories. You will need to resolve anything that is red:

Once the file permissions are satisfied you are then asked to enter your Data Base details:

The options are pretty self explanatory -

  • Hostname: The hostname of the SQL server that you wish to use.
  • Username: The database username that you wish to use.
  • Password: The database user’s password.
  • Database Name: The name of the database that you wish to use.
  • Table Prefix: An identifier so that you can have several sites using the same database.

Once you have entered the database details, you are then presented with the initial user details that you would like to use (more users may be added after installation is complete - if you want):

Again, the questions asked are self explanatory -

  • Username: This is the login name that you wish to use, it is also the name that is displayed on posts etc.
  • Password: The password you wish to use for your newly created user.
  • Repeat: Re-enter the password you chose.
  • Name: The real name of the user, this is handy if you have a multi-user site and can’t remember who is who.
  • E-Mail Address: A valid e-mail address is required.

Once you create your user, you are then presented with the Mail Server settings. This is used to send outbound mail, so only you SMTP settings are required:

Once you have entered your Mail settings you are presented with the Site Settings page:

The options presented here are -

  • Site Name: This is what you would like your site to be calle. e.g: The Jaws Project.
  • Description: A description of your site, this doesn’t neccisarly mean an exact description although it helps. e.g: The ultimate CMS product, or We chew minnows for fun.
  • Address: This is where you enter the URL address that people would enter into their browser to access your site.
  • Default Gadget: Here is where you select what gadget you would like to use as the main option for you site.
  • Language: Choose your site’s language.

After you select your site options, you are then asked to save your new configuration:

Providing your “include” directory is writable then all you have to do is click next, if it is not follow the instructions on screen.

Once the settings have been saved, you are then presented with the finish page which allows you to access your new website:

Here you are given the choice of either accessing your website or the admin section of your site -

  /var/www/wiki/htdocs/data/jaws/v06/installation.txt · Last modified: 2007/11/02 16:27