Installation Guide

The following is a guide to get Geonode and Cartoview up and running in most common operating systems (Windows, Linux/Ubuntu).

Windows Installation

Pre Installation

  1. Download and Install PostgreSQL and PostGIS.

Note

Cartoview requires PostgreSQL and PostGIS release 9.3 or later to be installed. If they are already installed on your system, please proceed to Java Installation.

Download the installer of PostgreSQL from EnterpriseDB. Recommended release is 9.3 or later 32 bits or 64 bits. Please choose the one that is compatible with your system.

download postgresql

Download PostgreSQL

The installation process is straight forward. Just run the downloaded installer, follow the wizard instructions and accept all the default parameters.

../_images/postgresql_setup1.png

Install PostgreSQL

Specify the installation folder

../_images/postgresql_setup2.png

Specify the installation data folder

../_images/postgresql_setup3.png

Specify the database administrator password

../_images/postgresql_setup4.png

Note

Keep this password safe because we will need it later during the installation of PostGIS.

Accept the default port (5432) and click the Next button.

../_images/postgresql_setup5.png

Accept the default locals and click the Next button

../_images/postgresql_setup6.png

Proceed with the installation, click the Next button

../_images/postgresql_setup7.png

When you reach this point the installation of PostgreSQL is completed. Please make sure that the Stack Builder check box is checked and click Finish to proceed with the installation of PostGIS.

../_images/postgresql_setup8.png

PostgreSQL installation completed

Select PostgreSQL 9.4(x64) on port 5432 from the combo box and click Next.

../_images/stack_builder1.png

Expand the category Spatial Extensions, select and check the PostGIS 2.2 item from the list, choose the one which is compatible with your system (32 bits or 64 bits).

../_images/stack_builder2.png

Review your selection and choose a download directory, then click the Next button to begin downloading PostGIS installer.

../_images/stack_builder3.png

The following dialog will indicate that the downloading of PostGIS installer finished successfully. Click Next to start installing PostGIS.

../_images/stack_builder4.png

Review the license terms and if you accept them, click on the I Agree button to continue with the installation of PostGIS.

../_images/postgis_setup1.png

Create spatial database is optional, however it is recommended.

../_images/postgis_setup2.png

Specify the PostgreSQL installation location in which PostGIS will be installed.

../_images/postgis_setup3.png

Provide the PostgreSQL connection information (The one you saved in previous step).

../_images/postgis_setup4.png

Specify the name of the spatial database to be created at the end of the installation process. Accept the default is recommended.

../_images/postgis_setup5.png

Just click on the Yes button.

../_images/postgis_setup6.png

Just click on the Yes button.

../_images/postgis_setup7.png

Just click on the Yes button.

../_images/postgis_setup8.png

PostGIS setup was competed successfully. Just click on the Close button to return to the Stack Builder.

../_images/postgis_setup9.png

Installation of PostgreSQL database and PostGIS spatial extension has been completed successfully. Just click on the Finish button to complete the installation process.

../_images/stack_builder5.png

Note

Verify that your Postgres and PostGIS is running using pgAdminIII.

  1. Download and install the latest release of Java Runtime 64-Bit from Oracle

Note

Cartoview requires Java runtime 64-Bit release 7 or later to be installed. If it is already installed on your system, please proceed to Cartoview Installation.

../_images/java_runtime1.png

Java Runtime installer download page

../_images/java_runtime2.png

Java Runtime installation wizard

A few brief dialogs confirm the last steps of the installation process. Click Close on the last dialog and this will complete Java installation process.
../_images/java_runtime3.png

Java Runtime installation completed

Important

Now you are ready to proceed with the installation of Geonode and Cartoview.

Geonode and Cartoview Installation

Note

This installer contains Geonode 2.4 and Cartoview 0.9.14. Cartoview has been tested with PostGIS 2.1 and Geonode 2.4

Download the latest release of Geonode_Cartoview Installer from Cartologic.

../_images/cartoview_setup1.png

The installation process is straight forward. Just run the downloaded installer and follow the wizard instructions. Accepting the defaults is strongly recommented.

../_images/cartoview_setup2.png

Specify the PostgreSQL installation folder.

../_images/cartoview_setup3.png

Provide PostgreSQL connection information.

../_images/cartoview_setup4.png

Provide the Geonode database name. This database will host information related to the Geonode website e.g. users, permissions etc.

../_images/cartoview_setup5.png

Provide the GIS database name. This database will host the GIS data.

../_images/cartoview_setup6.png

Specify installation folder for Geonode_Cartoview, however accepting the default is recommended.

../_images/cartoview_setup7.png

Provide start menu folder name, however accepting the default is again recommended.

../_images/cartoview_setup8.png

Setup is ready to install Geonode and Cartoview on your machine. Just click the Install button and be patient!

../_images/cartoview_setup9.png

Setup has finished installing Geonode and Cartoview on your computer. Just click the Finish button to launch the home page in your browser.

../_images/cartoview_setup10.png

Congratulations! You have successfully installed Geonode and Cartoview on your machine. This is the Admin Configuration page. Click the Start Geonode button to launch the Geonode and Cartoview home page.

../_images/cartoview_setup11.png

Sign in as admin/admin and start enjoying the experience of Geonode and Cartoview on Windows platform. Upload and style layers, create metadata, compose maps, share layers and maps with others, create and install Apps using Cartoview etc.

../_images/cartoview_setup12.png

Deployment for Production

Danger

Make sure that you have changed the default admin passwords for Django, Apache, Tomcat and Geoserver before you expose your site to the web. All default passwords are listed at the admin page installed with Cartoview.

Windows Firewall Configuration

Note

Cartoview is installed by default on localhost. In order to deploy Cartoview on your production server and make it accessible to other users, you will need to change the hostname and configure all necessary ports.

Configure Windows Firewall

Create a new Inbound Rule to group the configuration of the necessary ports needed for the installed software. Initially, search and launch the Windows Firewall with Advanced Security tool and click on the New Rule button.

../_images/firewall_1.png

Select Port as the type of Firewall Rule to be applied and click Next.

../_images/firewall_2.png

Specify the protocol and ports to which the rule applies and click Next.

../_images/firewall_3.png

Tip

Software Port
Geonode 4040
GeoServer 4041
PostgreSQL 5432
SSL 555

Specify the action to be taken when a connection matches the conditions specified in the rule and click Next. (Allow the connection)

../_images/firewall_4.png

Specify the profiles for which this rule applies. Accepting the defaults is recommended. Finally click Next to proceed to the next step. (All the options checked).

../_images/firewall_5.png

Specify the name and description of this rule and click Finish to complete the process.

../_images/firewall_6.png

Replace localhost with IP Address or Domain Name

  1. Apache 2.4

Open the Apache configuration file ..\Goenode\Apache24\conf\httpd.conf.

Replace localhost with IP Address or Domain Name only for the highlighted lines.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
WSGIPassAuthorization On
WSGIPythonHome "C:/Program Files (x86)/Geonode/Python"

<Proxy *>
    Order allow,deny
    Allow from all
</Proxy>

  ProxyRequests     Off
  ProxyPreserveHost On

  ProxyPass /geoserver http://localhost:4041/geoserver max=200 ttl=120 retry=300

  ProxyPassReverse /geoserver http://localhost:4041/geoserver
  1. Geonode 2.4

Open the Geonode configuration file ..\Geonode\geonode\geonode\local_settings.py

Replace localhost with IP Address or Domain Name only for the highlighted lines.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
SITEURL = "http://localhost:4040/"

OGC_SERVER = {
    'default' : {
        'BACKEND' : 'geonode.geoserver',
        'LOCATION' : 'http://localhost:4041/geoserver/',
        'PUBLIC_LOCATION' : 'http://localhost:4041/geoserver/',
        'USER' : 'admin',
        'PASSWORD' : 'geoserver',
        'MAPFISH_PRINT_ENABLED' : True,
        'PRINT_NG_ENABLED' : True,
        'GEONODE_SECURITY_ENABLED' : True,
        'GEOGIG_ENABLED' : False,
        'WMST_ENABLED' : False,
        'BACKEND_WRITE_ENABLED': True,
        'WPS_ENABLED' : False,
        'LOG_FILE': '%s/geoserver/data/logs/geoserver.log' % os.path.abspath(os.path.join(PROJECT_ROOT, os.pardir)),
        # Set to name of database in DATABASES dictionary to enable
        'DATASTORE': 'datastore',
    }
}
  1. Tomcat 8.0

Open the Tomcat Geoserver configuration file ..\Geonode\Tomcat 8.0\webapps\geoserver\WEB-INF\web.xml

Replace localhost with IP Address or Domain Name for the highlighted line.

1
2
3
4
<context-param>
  <param-name>GEONODE_BASE_URL</param-name>
  <param-value>http://localhost/</param-value>
</context-param>

Open the Tomcat Geoserver configuration file ..\Geonode\Tomcat 8.0\webapps\geoserver\data\security\auth\geonodeAuthProvider\config.xml

Replace localhost with IP Address or Domain Name for the highlighted line.

1
2
3
4
5
6
<org.geonode.security.GeoNodeAuthProviderConfig>
  <id>-54fbcd7b:1402c24f6bc:-7fe9</id>
  <name>geonodeAuthProvider</name>
  <className>org.geonode.security.GeoNodeAuthenticationProvider</className>
  <baseUrl>http://localhost:4040/</baseUrl>
</org.geonode.security.GeoNodeAuthProviderConfig>
  1. Restart Services

Restart the Windows services

  • GEONODE_APACHE_4040
  • GEONODE_TOMCAT_4041
  1. Geoserver 2.7.4
  • Launch Geoserver’s home page at http://localhost:4040/geoserver/web
  • Login as admin/geoserver
../_images/geoserver_config0.png
  • Click on Global button
  • Define the Proxy Base URL parameter as: http://xx.xx.xx.xx:4040/geoserver
../_images/geoserver_config1.png

Linux/Ubuntu Installation

Follow Geonode instructions for installing Geonode on your Ubuntu machine.

Get Cartoview code from GitHub and install it as Django App in the Geonode project.

Installation of multiple instances

Documentation not available yet!