Difference between revisions of "Basic Installation"
Andydufton (talk | contribs) (→Update the DB Settings) |
Andydufton (talk | contribs) (→Update the DB Settings) |
||
| Line 65: | Line 65: | ||
===Update the DB Settings=== | ===Update the DB Settings=== | ||
| − | You will now need to update the server-specific DB settings in [[settings.php#Server Specific | + | You will now need to update the server-specific DB settings in [[settings.php#Server Specific Information|settings.php]]. '''THE DATABASE WILL NOT WORK UNTIL THESE SETTINGS HAVE BEEN UPDATED'''. |
===Browse to ARK directory=== | ===Browse to ARK directory=== | ||
Revision as of 16:08, 14 November 2008
Preconfigured ARK setups are available from the ARK team. If you are unfamiliar with the setup and adminisration of webservers along with the security risks to your system and data this entails, please consider contacting us to aquire a fully running ARK. For those of you who have already got a server and want to go though the installation proceedure, we have provided the following notes:
Contents
Dependencies
ARK requires the following open source software packages to be installed on your server:
- Apache 2
- PHP 5
- MySQL 5
- PEAR Liveuser
In order to benefit from the spatial integration offered by ARK, you will also need the following packages:
- PHP Mapscript
Apache PHP MySQL
On most Linux distributions these packages will be installed by default. ARK is not particularly fussy about the version numbers of these packages and should run ok on PHP4 and MySQL4, although this may require some minor modifications. It is important to ensure that you have the gd and dbase php extensions enabled.
You will need to make sure that you set the short_open_tag option to On in your php.ini.
For Mac OSX and Windows, these packages are available as binary distributions. ARK is known to run on MAMP, the binary distribution for Mac and WAMP or MS4W, the binary distributions for Windows.
The MS4W distribution also contains Mapserver and if this is installed only MySQL needs to be added.
ARK runs on top of these packages and does not provide any set up of them or additional securuty to them. If you are using your server exposed to the internet, it is essential that you follow good standard security practice for the configuration of your packages. This setup is outside of the scope of this documentation and you are advised to undertake your research carefully.
PEAR LiveUser
The PEAR Liveuser is used to ensure effective security for the ARK system. For details on how to install and configure live user, and the associated database tables required, please see the PEAR website.
MS4W
MS4W [1] is a no fuss installer for setting up MapServer on Microsoft Windows platforms. It includes a Apache HTTP version, PHP, Mapserver and loads of nice tools.
MS4W is super simple to install on a server. Either download [2] the base package which consists of a folder which unpacks to the C-drive of the server or try out the new installer.
If you are using the base package you need to start the Apache server by running C:\ms4w\apache-install.bat. If the installation is succesful you should get the main page by pointing you browser to http://localhost/ or http://127.0.0.1/.
If this does not work it is very likely that your port 80 is already in use. Go to C:\ms4w\Apache\conf\httpd.conf and on line 120 change LISTEN 80 to LISTEN 8080 or another port which is not in use.
Mapscript
Mapscript runs on all three major operating systems. The installation instructions vary depending on many factors. Detailed installation instructions are available on the Mapserver website.
Installing ARK
Ark is installed by unpacking the source code into the document root of the webserver where you intend to host it. The second phase of installation is then the initial setup and creation of the empty database.
Download source
Download the latest source code from http://ark.lparchaeology.com/downloads and unpack it into the document root of your server. If you are unsure of the correct location of the document root, you could try reading the manual of your apache distribution.
Install a database
In order for ark to work, you need to install an ARK database on your MySQL server. Preconfigured sample databases are available for download from the download area of the ARK site. At present you must install the sql dump on the server manually using your tool of choice. We think that phpMyAdmin is a good way to do this.
- Download your chosen database dump file
- Point your browser at the phpMyAdmin installation on your web-server
- Make an empty database, by going to the Databases screen and filling in the Create new database box. Make the Collation utf8_unicode_ci and that should deal with most character sets.
- Once the database is created, switch to it and choose Import
- Using the Browse button, point it at the file that you have downloaded (it should be a tar.gz) - make the character set utf8
- Click Go and wait a little while, and the database structure should be loaded up fine.
- You will need to set up a user and give it at least SELECT, INSERT, UPDATE andDELETE privileges to the new db.
Update the DB Settings
You will now need to update the server-specific DB settings in settings.php. THE DATABASE WILL NOT WORK UNTIL THESE SETTINGS HAVE BEEN UPDATED.
Browse to ARK directory
In browsing to the ARK directory you should now be able to see the login pages for the database. If there are any problems, please check your settings.php and env_settings.php files to ensure you are using the correct settings.
