SemanticScuttle installation



To run SemanticScuttle, you need:

Standard installation instructions

If you've downloaded a file from SourceForge, then this instructions are for you.

  1. Create a new MySQL/PostgreSQL database

  2. Import data/tables.sql into that database, i.e. run

    $ mysql -umyusername -p mydatabasename < data/tables.sql

    on the shell.

    If you run PostgreSQL, use tables-postgresql.sql:

    $ psql mydatabasename myusername < data/tables-postgresql.sql

    You can also use a web interface like phpMyAdmin to import the file.

  3. Copy data/config.php.dist to data/config.php and modify it as necessary. See configuration for more information.

  4. Make the cache directory writable by your web server. For example, run

    $ chmod 0777 cache

    on the shell.

  5. Set the www/ directory as document root in your web server, restart the web server.

  6. That's all! Visit your SemanticScuttle installation web site now with your browser.

  7. Register a user and add bookmarks.

Ugly www directory in URLs

In case point 5 of the installation instructions cannot be put into practice by you because you are not able to change the web server configuration, you are not lost! There is a way to get rid of www/ in your URL!

Imagine following directory layout:


Create a SemanticScuttle directory somewhere outside www if possible and put all directories except www/ in there. Move all files and directories from www/ into your subdomain directory. Then modify subdomain/www-header.php to include the correct file path.

The new directory layout should look that way:

    subdomain2/ (this is the semanticscuttle subdomain)

Now open www-header.php and replace

require_once '../src/SemanticScuttle/header.php';


require_once '../../semanticscuttle/src/SemanticScuttle/header.php';

PEAR package installation

Apart from the normal installation, you may install the SemanticScuttle PEAR package - it gives you the ability to upgrade to the next version with a single command, without manually unzipping files.

  1. The SemanticScuttle PEAR channel is available at

  2. Make sure you have the PEAR installer (or Pyrus) available and working. You can check that by running

    $ pear version
    PEAR Version: 1.9.2
    PHP Version: 5.3.6-13ubuntu3.2
    Zend Engine Version: 2.3.0
    Running on: Linux bogo 3.0.0-12-generic #20-Ubuntu SMP Fri Oct 7 14:56:25 UTC 2011 x86_64
  3. Discover the channel if you haven't done so yet:

    $ pear channel-discover

    Verify that the channel has been added with:

    $ pear list-channels
    Registered Channels:
    Channel                         Alias     Summary
    ... sc        SemanticScuttle PEAR channel
  4. Install SemanticScuttle:

    $ pear install sc/semanticscuttle-beta
  5. Find out where it got installed to:

    $ pear list-files sc/semanticscuttle
  6. Generally, the directory you need to point your web server's DocumentRoot to is the PEAR www directory + /SemanticScuttle/. Find the www directory with:

    $ pear config-get www_dir
  7. The configuration file is located in PEAR's data directory + /SemanticScuttle/:

    $ pear config-get data_dir

    In $data_dir/SemanticScuttle/, copy config.php.dist to config.php and continue with configuration.