-
Notifications
You must be signed in to change notification settings - Fork 14
Project installation
There is no end-user install for the project because it is currently under development.
To install the development environment you need to clone the GitHub repository. These links may help:
- [How do you clone a git repository into a specific folder?] (http://stackoverflow.com/questions/651038/how-do-you-clone-a-git-repository-into-a-specific-folder)
- [Git Clone] (http://gitref.org/creating/)
- [Git for Windows] (http://msysgit.github.com/)
In the '/install' directory you will find the following MySQL dump file:
- /install/nextsis.sql
Import this into MySQL to create the nextSIS database, or REMOVE AND REPLACE (i.e. DELETE) your existing nextSIS database with the new one.
You will note in the project's root directory /.gitignore defines a series of files which are ignored when updating git. These are local files like .ini and .project, but also the following project files:
- /application/config/config.php
- /application/config/database.php
These are important but locally specific files within the CodeIgniter framework which define your database connection and environment. To assist you in creating these if necessary the following two files were provided within the nextSIS repository on GitHub:
- /application/config/config.template.php
- /application/config/database.template.php
As the names suggest these are template files, and they include comments to assist you in configuring them. First of all these files should be renamed with the '.template' portions of the name removed, so that they become:
- /application/config/config.php
- /application/config/database.php
Make the following changes to config.php:
- Set the base_url of your server (Line 17).
- Set your nextSIS interface language (Line 72).
- Set an encryption key (Line 227) (Use [this link] (http://jeffreybarke.net/tools/codeigniter-encryption-key-generator/) if you are stuck).
- Set the session cookie name (don't use underscores here as problems with them have been reported on Windows servers) (Line 247).
- Change anything else you need to within the file (probably optional and down to your server configuration).
Make the following changes to database.php:
- Set your database hostname - leaving it as localhost might be OK (Line 51)
- Set your database username (Line 52)
- Set your database password (Line 53)
- Change anything else you need to within the file
That's it. You should only have to configure these files once (unless we direct you otherwise) and of course even if you contribute to the repository the .gitignore ensures your server's private details are not made public(!)
If you end up with a server error (probably HTTP Error 500) after going through the steps above then it might be connected with directory permissions. All web directories on a Linux server should generally be 755 (Owner:Read-Write-Execute, Group:Read-Execute, Public:Read-Execute) and files should be 644 (Owner:Read-Write, Group:Read, Public: Read). Windows permissions should be similarly configured.
You can also check your server log files, for example at /var/log/apache2/error.log
If this doesn't solve your problem, contact us.
A default user account has been provided as part of the MySQL database:
- Username: admin
- Password: admin
This should give you access to the home screen.