Giscuit
Prev Next

Installation and Configuration

Introduction

This section will guide you through the general configuration and installation of Giscuit on various operating systems. Be sure to investigate any sections specific to your platform or web server before you begin the process.

You will need to create an account in order to activate the software with a trial or full license.

Preparing for installation on Linux

We currenty support the following linux distributions:

  • Ubuntu Server 12.04/14.04
  • CentOS 5/6
  • Red Hat Enterprise Linux 5/6
  • SUSE Linux Enterprise 11
  • openSUSE 12/13

PHP interpreter

Install the PHP interpreter by executing the following command in the terminal:

Red Hat Enterprise Linux 5/CentOS 5:

yum install -y php53-cli wget sudo

# If you get errors about php53-common conflicting with php-common
# delete the old php version with the following command: "yum erase php-common"

Red Hat Enterprise Linux 6/CentOS 6:

yum install -y php-cli wget sudo

Ubuntu Server:

sudo apt-get install -y php5-cli

SUSE Linux Enterprise 11:

sudo zypper mr -e SLES11-SP1-Pool
sudo zypper remove php53
sudo zypper install php5

openSUSE

sudo zypper install php5


Download the installation php script, and execute it from a terminal.

wget http://downloads.giscuit.com/giscuit-1.4.3-linux.install
sudo php giscuit-1.4.3-linux.install

After the installation of the required software is completed, proceed with Giscuit Installation.

Preparing for installation on Microsoft Windows

Giscuit runs on all Microsoft Windows platforms.

To install Giscuit on windows you will need to download the following components:

Extract giscuit-windows-1.4.3.zip package into the C: directory, you should have C:\ms4w directory after extracting.

PostgreSQL and PostGIS

Run the postgresql-*-windows.exe install file and follow the instructions of the installation process.

Set the PostgreSQL installation directory.

Provide a password for the database superuser "postgres". Database username is postgres and Database password is the one you specified.

Select the port number the server should listen on, Database port.

Select the locale to be used by the new database cluster.

Upon finishing the installation launch the Stack Builder.

Select your PostgreSQL installation.

On the Category select screen open the Spatial Extensions tab and select PostGIS 1.5. Choose a mirror close your server location.

Select all componenets.

Set the PostGIS installation directory, leave the value of this field as proposed in order to install shp2pgsql.exe into PostgreSQL bin directory.

In the database connection section specify "postgres" as the Database username and the Database password you specified during PostgreSQL installation process.

In the database name section specify the name for your spatial database, Database name.

Enable shp2pgsql graphical plugin.


Python

Run the python-2.6.6.msi and follow the installation instructions.

Check Install for all users option.

Do not change the destination directory, Leave it as is (C:\Python26\)


PIL

Run the PIL-1.1.7.win32-py2.6.exe and follow the installation instructions.


Giscuit

Open C:\ms4w\Apache\conf\extra\httpd-vhosts.conf with your favorite text editor and change the domain name and server administrator e-mail.

<VirtualHost *:80>
    ServerAdmin YOUR_EMAIL
    
    #Comment bellow line out If you don't have a domain name 
    #assigned to your network's card IP address
    ServerName YOUR_DOMAIN 

</VirtualHost>

Right click on C:\ms4w\apache-install.bat and "Run as Administrator" to start Apache as a service. If above did not work try the following:

  1. In Windows Explorer, goto the location of your cmd.exe file (C:/Windows/System32)
  2. Right-click the cmd.exe executable and choose Run as Administrator
  3. Navigate to ms4w folder by typing "cd C:\ms4w" and run the service by entering "apache-install.bat"

WARNING, the instalattion process will bind the LICENSE KEY to YOUR_DOMAIN and YOUR_IP_ADDRESS and YOUR_MAC_ADDRESS. For example, if you want Giscuit to be accesible from www.example.com you should run the installation process from example.com

After the installation of the required software is completed, proceed with Giscuit Installation.


Installation

After the installation of the required software is completed access http://YOUR_DOMAIN/install.php to start Giscuit installation process. If you don't have a domain name you can use one of your network's card IP address, note that you can not use localhost or 127.0.0.1.

WARNING, the installation process will bind the LICENSE KEY to YOUR_DOMAIN and YOUR_IP_ADDRESS and YOUR_MAC_ADDRESS. For example, if you want Giscuit to be accessible from www.example.com you should run the installation process from example.com

Note: If you get a "License not found error" after a successful install most likely the page got cached by your browser, press CTRL+R to fix this problem.

Database

Database name. Use the value you specified during PostGIS installation

Username. Use the value you specified during PostgreSQL installation

Password. Use the value you specified during PostgreSQL installation

Host. Database hostname or ip address, default value is "localhost"

Port. Use the value you specified during PostgreSQL installation

Schema. Schema name where all Giscuit related tables will be created


General

Date format.

Date formats: ISO 8601:

  • YYYY-MM-DD

Time zone. Your server time zone

HTTP Path. This should be left blank by default, only use this if you installed in a non root directory of your virtual host. For example if you installed in /var/www/test and your document root is /var/www then you can access your install by http://YOUR_DOMAIN/test but you need to set the http path to "/test"


Map

Spatial reference system identifier. Your map's projection EPSG ID, search for it at spatialreference.org. This projection will be used to display your data in the web browser.

Minimum horizontal coordinate. World bound in WGS 84 (EPSG:4326) is -180. World bound in Mercator (EPSG:3857) is -20037508

Minimum vertical coordinate. World bound in WGS 84 (EPSG:4326) is -90. World bound in Mercator (EPSG:3857) is -20037508

Maximum horizontal coordinate. World bound in WGS 84 (EPSG:4326) is 180. World bound in Mercator (EPSG:3857) is 20037508

Maximum vertical coordinate. World bound in WGS 84 (EPSG:4326) is 90. World bound in Mercator (EPSG:3857) is 20037508

Resolutions. The system is designed to display each of its layers at different levels of resolution.

Defaults resolutions values:

  • WGS 84 (EPSG:4326)

    1.40625, 0.703125, 0.3515625, 0.17578125, 0.087890625, 0.0439453125, 0.02197265625, 0.010986328125, 0.0054931640625, 0.00274658203125, 0.001373291015625, 0.0006866455078125, 0.00034332275390625, 0.000171661376953125, 0.0000858306884765625, 0.00004291534423828125, 0.00002145767211914062, 0.00001072883605957031, 0.00000536441802978515, 0.00000268220901489257

  • Mercator (EPSG:3857)

    156543.03390625, 78271.516953125, 39135.7584765625, 19567.87923828125, 9783.939619140625, 4891.9698095703125, 2445.9849047851562, 1222.9924523925781, 611.4962261962891, 305.74811309814453, 152.87405654907226, 76.43702827453613, 38.218514137268066, 19.109257068634033, 9.554628534317017, 4.777314267158508, 2.388657133579254, 1.194328566789627, 0.5971642833948135, 0.29858214169740677

This article will help you understand map resolutions: http://msdn.microsoft.com/en-us/library/aa940990.aspx

Geodata units. Set your projection's map units.

  • Meters
  • Degrees
  • Inches
  • Feet
  • Miles
  • Kilometers

Measurement units. Set measurement units used by measure distance tools.

  • Metric - meters, kilometers
  • English - feet, miles inches
  • Geographic - degrees

Watermark. Activating this will watermark the map of a logged user and private WMS with his first name, last name and current date


Administrator account

Using this information a new administrator will be created. Use this account to further configure Giscuit.

Account (E-mail).

Password.

Confirm password.

First name.

Last name.


Sign up options

Default group. Indicate which user role (group) will be assigned by default to the new user

Activate on sign up. Select False to make user deactivated or True to make user activated after submitting sign-up request for registering in the system


External paths

This section is available only on Microsoft Windows platform.

MS4W path. MS4W installation directory, default value is "C:\ms4w"

PostgreSQL bin path. PostgreSQL bin directory (installation directory plus bin folder), default value is "C:\Program Files\PostgreSQL\8.4\bin"


Uninstallation

Linux

Note: Default Install path "/var/www" and Install name "giscuit" are used in the examples.

Remove Giscuit files

sudo rm -dr /var/www/giscuit

Remove Apache virtual host

Ubuntu:

sudo a2dissite giscuit
sudo rm /etc/apache2/sites-available/giscuit

Others:

rm /etc/httpd/conf.d/giscuit.conf

Remove PostgreSQL user and database (using default Database username "giscuit" and Database name "giscuit").

sudo su postgres
dropdb giscuit
dropuser giscuit
exit


Microsoft Windows

Remove Giscuit files. Right click on C:\ms4w\apache-uninstall.bat and "Run as Administrator" to stop Apache service. Delete the C:\ms4w folder.

Remove Giscuit data located in a PostgreSQL database. Lauch PgAdmin III (Start -> All Programs -> PostgreSQL 8.4 -> PgAdmin III) and login using your Database username ("postgres" by default). Drop cascaded all schemas starting with Database schema ("giscuit" by default) in the Database name ("postgis" by default).

You can remove PostgreSQL, PostGIS, Python, PIL from the Add or Remove Programs in the Control panel.


Patching

Linux

Note: Default Install path "/var/www" and Install name "giscuit" are used in the examples.

Note: Before patching it is recommended to backup /var/www/giscuit directory (raster and public/tiles folder can be skipped because they are usually very large) and backup the PostgreSQL database.

cd /var/www/giscuit # Change directory
wget http://downloads.giscuit.com/patches/giscuit-X.X.X-to-X.X.X-patch-linux.zip # (http://downloads.giscuit.com/patches/)
unzip giscuit-X.X.X-to-X.X.X-patch-linux.zip # Unzip
cp -r giscuit-X.X.X-to-X.X.X-patch-linux/* giscuit/ # Copy, /bin/cp to avoid interactive mode

Go to http://YOUR_DOMAIN/patch.php to complete the patching process.


Microsoft Windows

Note: Before patching it is recommended to backup C:\ms4w directory (Apache\htdocs\giscuit\raster and Apache\htdocs\giscuit\public\tiles folder can be skipped because they are usually very large) and backup the PostgreSQL database.

Download the patch and extract it. Copy the ms4w folder from the arhive directory into the C: directory, at the "Copy File" prompt select "Copy and Replace"

Go to http://YOUR_DOMAIN/patch.php to complete the patching process.


Change license

  • Open configs/configs.xml in your favorite text editor and change (line 13) <installed>t</installed> to <installed>f</installed>.
  • In your browser open http://YOUR_DOMAIN/install.php and proceed with entering your credentials for the Giscuit license system and adding your license. At the Database, Map, Admin installation section just close the page (Do not proceed with installation).
  • Open configs/configs.xml in your favorite text editor and change (line 13) <installed>f</installed> to <installed>t</installed>.

Prev Up Next
Giscuit Giscuit Reference guide

COPYRIGHT ® 2012, VEC