Installation

From Sit
Revision as of 11:06, 13 March 2012 by Ericthefish (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Contents

Installation

If you are upgrading an existing installation please read the Upgrading page first.

SiT installation is very simple, see for yourself:

Requirements

You'll need at a server/host with the following software in order to run SiT.

See the installation requirements page for more detail.

Platform Preparation

SiT! is known to run on many flavours of GNU/Linux and of BSD, Windows, Mac and OpenSolaris and will likely work just as well on other operating systems.

These guides will take you through the process of preparing your platform for SiT! installation in detail

Extract the files

Basically, you need to:

  • Extract the SiT tar.gz file and copy the files to a directory (inside your web root) on your web server
  • and then in your browser visit setup.php (e.g. http://<servername>/sit/setup.php) which will take you through the installation steps

After preparing your system, continue with Step 1 below.

Step 1

When you start the setup process by visiting setup.php in your browser, configuring the database settings is the first step. Fill out the details for your database access, the example below might differ from your own setup. If you configure SiT as a host e.g. sit.domain.com take note, there should only be one / in the webpath

Step 1

Step 2

If file system permissions allow, SiT will write the Config file, if not this needs to be saved manually to config.inc.php or alternatively, /etc/sit.conf

Step 2.1

If SiT cannot write the config file automatically it will print a message "Could not write..." as shown in the image above. In this case you should copy the text of the configuration from within the box and paste it into a new text file called config.inc.php and then save this into your main SiT directory.

Otherwise SiT will tell you that the file has been saved

Step 2.2

Once your config file has been created, you should make the file read-only (you'll be notified later if you didn't do so).

Step 3

If no database from a previous installation could be found, or you mistyped some settings, you have the chance to reconfigure the database access (upgrading) by clicking the Reconfigure SiT! button.

Otherwise click the Create a database (remember to remove the checkmark with the sample data if you want to start your production environment)

For testing purposes, we have added some sample data for your convenience so you'll be able to test SiT without adding alot of different sites, contacts etc.

Step 3.1

If you see any errors, you might want to check your MySQL database server is running and that the username, password and other database configuration is correct before trying again.

If everything is in order, you'll be notified hereof.

Step 3.2

If you kept the checkmark with installing sample data from above, you'll get an additional informational screen.

Step 3.3

Step 4

If you didn't make the config.inc.php file read only you'll be notified of this and unable to continue the installation.

Step 4.1

If you have console access to the webserver you can use the command "chmod 400 config.inc.php". Some FTP clients like Filezilla for windows have support to set the permissions by right-cliking on the file, and choose permissions or file attributes, in which you can remove the write permissions.

After having done so, you can just refresh the webbrowser screen you see in the above picture (eg press the F5 key on your keyboard), now you are able to continue.

You now need to choose a password and email address for the admin user.

Step 4.2

Step 5

That's it! You're done. Go and enjoy SiT and read through some of the other help pages.

Step 5

Step 6

You need to manually create the attachments folder. If you have console access to the webserver, find your config.inc.php file and open it with your favorite text editor. Else you can download the file via FTP or even open it directly on the FTP server, depending on your FTP client. Find the line that starts with : $CONFIG['attachment_fspath'] = Copy the attachments text from there (it looks like this : attachments-9144ba39c891be11772eeb128442ed10) and create a folder with this name, make sure it is writeable by the webserver.

With console access "chmod ugo+w attachments-9144ba39c891be11772eeb128442ed10" Or use the FTP client by right-cliking on the folder, you should see something alike to "permissions" or "file rights", choose this, and make the folder writeable.

Configuring

You can now move on to configure your SiT install.

See Also


Personal tools
project