summaryrefslogtreecommitdiff
path: root/doc/INSTALL.txt
blob: c911740901361373be9c989a945908effafc1187 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
============================
SemanticScuttle installation
============================

.. contents::

Prerequisites
=============
To run SemanticScuttle, you need:

- PHP5 with filter functions enabled
- A web server, for example Apache


Standard installation instructions
==================================
If you've downloaded a ``SemanticScuttle-x.y.z.zip`` 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

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.


.. _configuration: configuration.html


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: ::

 /home/customer123/
   www/
     subdomain1/
     subdomain2/
     subdomain3/

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: ::

 /home/customer123/
   semanticscuttle/
     doc/
     data/
     src/
   www/
     subdomain1/
     subdomain2/ (this is the semanticscuttle subdomain)
       about.php
       admin.php
       ..
       www-header.php
     subdomain3/

Now open www-header.php and replace ::

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

with ::

  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.

0. The SemanticScuttle PEAR channel is available at
   http://semanticscuttle.sourceforge.net/pirum.html

1. 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

2. Discover the channel if you haven't done so yet::

     $ pear channel-discover semanticscuttle.sourceforge.net

   Verify that the channel has been added with::

     $ pear list-channels
     Registered Channels:
     ====================
     Channel                         Alias     Summary
     ...
     semanticscuttle.sourceforge.net sc        SemanticScuttle PEAR channel
     ...

3. Install SemanticScuttle::

     $ pear install sc/semanticscuttle-beta

4. Find out where it got installed to::

     $ pear list-files sc/semanticscuttle

5. 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
     /usr/share/php/htdocs

6. The configuration file is located in *PEAR's data directory*  + ``/SemanticScuttle/``::

     $ pear config-get data_dir
     /usr/share/php/data

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