trunk/doc/install.txt

SiteBar 3 Install & Upgrade Guide
=================================

1) Download and unpack the package (X stands for current release version):

   tar xfj SiteBar-X.tar.bz2

   - or -

   unzip SiteBar-X.zip

Files will be unpacked into a new directory having the same base name as the
file "SiteBar-X".

2) Move the content of the installation package to a place  accessible  to  your
HTTP server (let's assume it will be accessible at http://localhost/sitebar/ ).
You can move the files on Linux with:

    mv SiteBar-X/* sitebar/

    - or -

    cp -R SiteBar-X/* sitebar/

3) Open page  http://localhost/sitebar/index.php  and  let  yourself  be  guided
through the rest of  the  installation/upgrade.  Please  note  that  on  the  DB
Configuration page you are asked for parameters of your  MySQL  connection  like
username/password and database host address.  The  installation  ends  with  the
message that you are welcome to SiteBar. Upgrade ends on your login screen or if
you were logged in before installation then you might still be logged (if  there
was no change in login mechanism).

Notes:
======

Installation assumes you either already have the database or have the  right  to
create it from a PHP script.

For MySQL beginners: If you have just installed your MySQL to run  SiteBar  then
the password of the root user is empty. It is not the root user of your  server.
You may want to read more on MySQL security topic:
    http://dev.mysql.com/doc/mysql/en/security-against-attack.html

The SiteBar 3.3 and higher use centralized integrator page. This allows latest
integration and usage tips be available to all SiteBar users without any need
to upgrade. The centralized page is located at SiteBar project webspace
http://my.sitebar.org/integrator.php . In case this address becomes slow
or in any other case you can switch in "SiteBar Settings" to use local
integrator page.
1	SiteBar 3 Install & Upgrade Guide
2	=================================
3
4	1) Download and unpack the package (X stands for current release version):
5
6	tar xfj SiteBar-X.tar.bz2
7
8	- or -
9
10	unzip SiteBar-X.zip
11
12	Files will be unpacked into a new directory having the same base name as the
13	file "SiteBar-X".
14
15	2) Move the content of the installation package to a place accessible to your
16	HTTP server (let's assume it will be accessible at http://localhost/sitebar/ ).
17	You can move the files on Linux with:
18
19	mv SiteBar-X/* sitebar/
20
21	- or -
22
23	cp -R SiteBar-X/* sitebar/
24
25	3) Open page http://localhost/sitebar/index.php and let yourself be guided
26	through the rest of the installation/upgrade. Please note that on the DB
27	Configuration page you are asked for parameters of your MySQL connection like
28	username/password and database host address. The installation ends with the
29	message that you are welcome to SiteBar. Upgrade ends on your login screen or if
30	you were logged in before installation then you might still be logged (if there
31	was no change in login mechanism).
32
33	Notes:
34	======
35
36	Installation assumes you either already have the database or have the right to
37	create it from a PHP script.
38
39	For MySQL beginners: If you have just installed your MySQL to run SiteBar then
40	the password of the root user is empty. It is not the root user of your server.
41	You may want to read more on MySQL security topic:
42	http://dev.mysql.com/doc/mysql/en/security-against-attack.html
43
44	The SiteBar 3.3 and higher use centralized integrator page. This allows latest
45	integration and usage tips be available to all SiteBar users without any need
46	to upgrade. The centralized page is located at SiteBar project webspace
47	http://my.sitebar.org/integrator.php . In case this address becomes slow
48	or in any other case you can switch in "SiteBar Settings" to use local
49	integrator page.