Installing the OpenGeo Suite for Linux ************************************** This document describes how to install the OpenGeo Suite for Linux. Prerequisites ============= The OpenGeo Suite has the following system requirements: * Operating System: Ubuntu 10.04 and 10.10, CentOS 5 * Memory: 512MB minimum (1GB recommended) * Disk space: 500MB minimum (plus extra space for any loaded data) * Browser: Any modern web browser is supported (Internet Explorer 6+, Firefox 3+, Chrome 2+, Safari 3+) * Permissions: Super user privileges are required for installation Installation ============ Packages for the OpenGeo Suite are currently available in both *RPM* (CentOS/Red Hat/Fedora) and *APT* (Ubuntu/Debian) format. Note: The commands contained in the following installation instructions must be run as a user with root privileges, or prefixed with ``sudo``. RPM Installation ---------------- Note: If you are upgrading from a previous version, jump to the section entitled *RPM Upgrade*. Warning: The RPM packages are only compatible with CentOS 5 and above. 1. Begin by adding the OpenGeo YUM repository: For 32 bit systems: cd /etc/yum.repos.d wget http://yum.opengeo.org/centos/5/i386/OpenGeo.repo For 64 bit systems: cd /etc/yum.repos.d wget http://yum.opengeo.org/centos/5/x86_64/OpenGeo.repo 2. Search for packages: yum search opengeo Note: If the search command does not return any results, the repository was not added properly. Examine the output of the ``yum`` command for any errors or warnings. 3. Install the OpenGeo Suite package (``opengeo-suite``): yum install opengeo-suite 4. You can launch the OpenGeo Suite Dashboard (and verify the installation was successful) by navigating to the following URL: http://localhost:8080/dashboard/ Continue reading at the *After installation* section. RPM Upgrade ----------- Warning: If upgrading from 2.3.3 you must first uninstall the ``opengeo-suite`` and ``opengeo-geoserver`` packages before the upgrade. See the section entitled *RPM Upgrade from 2.3.3*. 1. Begin by updating YUM: yum update 2. The relevant OpenGeo packages should be included in the upgrade list. If you do not wish to do a full update, cancel the upgrade and install the ``opengeo-suite`` package manually: yum install opengeo-suite RPM Upgrade from 2.3.3 ~~~~~~~~~~~~~~~~~~~~~~ The process for upgrading from version 2.3.3 is slightly different from other upgrades. 1. Begin by removing both the ``opengeo-suite`` and ``opengeo-geoserver`` packages: yum remove opengeo-geoserver opengeo-suite 2. Update YUM: yum update 3. Reinstall the OpenGeo Suite package (``opengeo-suite``): yum install opengeo-suite APT Installation ---------------- Note: If you are upgrading from a previous version, jump to the section entitled *APT Upgrade*. Warning: The APT packages are only available for Ubuntu 10.04 and above. 1. Begin by importing the OpenGeo GPG key: wget -qO- http://apt.opengeo.org/gpg.key | apt-key add - 2. Add the OpenGeo APT repository: echo "deb http://apt.opengeo.org/ubuntu lucid main" >> /etc/apt/sources.list 3. Update APT: apt-get update 4. Search for packages: apt-cache search opengeo Note: If the search command does not return any results, the repository was not added properly. Examine the output of the ``apt`` commands for any errors or warnings. 5. Install the OpenGeo Suite package (``opengeo-suite``): apt-get install opengeo-suite 6. You can launch the OpenGeo Suite Dashboard (and verify the installation was successful) by navigating to the following URL: http://localhost:8080/dashboard/ Continue reading at the *After installation* section. APT Upgrade ----------- 1. Begin by updating APT: apt-get update 2. Update the ``opengeo-suite`` package: apt-get install opengeo-suite After installation ================== List of packages ---------------- Once installed, you will have the following packages installed on your system: +----------------------+----------------------+--------------------------------------------------------------+ | Package | Name | Description | +======================+======================+==============================================================+ | opengeo-suite | OpenGeo Suite | The full OpenGeo Suite and all its contents. All packages | | | | listed below are installed as dependencies with this | | | | package. Contains GeoExplorer, Styler, GeoEditor, | | | | Dashboard, Recipe Book, and more. | +----------------------+----------------------+--------------------------------------------------------------+ | opengeo-docs | OpenGeo Suite | Full documentation for the OpenGeo Suite. | | | Documentation | | +----------------------+----------------------+--------------------------------------------------------------+ | opengeo-geoserver | GeoServer | High performance, standards-compliant map and geospatial | | | | data server. | +----------------------+----------------------+--------------------------------------------------------------+ | opengeo-jai | Java Advanced | Set of Java toolkits to provide enhanced image rendering | | | Imaging (JAI) | abilities. | +----------------------+----------------------+--------------------------------------------------------------+ | opengeo-postgis | PostGIS | Robust, spatially-enabled object-relational database built | | | | on PostgreSQL. | +----------------------+----------------------+--------------------------------------------------------------+ | opengeo-suite-data | OpenGeo Suite Data | Sample data for use with the OpenGeo Suite. | +----------------------+----------------------+--------------------------------------------------------------+ | pgadmin3 | pgAdmin III | Graphical client for interacting with PostgreSQL/PostGIS. | +----------------------+----------------------+--------------------------------------------------------------+ Starting/Stopping the OpenGeo Suite ----------------------------------- GeoServer, GeoExplorer, and all other web-based containers including the documentation are installed into the existing Tomcat instance on the machine. Starting and stopping these applications are therefore accomplished by managing them through the standard Tomcat instance. Tomcat is installed as a service under the name of **tomcat5**, and can be managed accordingly: /etc/init.d/tomcat5 start /etc/init.d/tomcat5 stop PostGIS is also installed as a service, under the name of **postgresql**, and can be managed in the same way as Tomcat: /etc/init.d/postgresql start /etc/init.d/postgresql stop Both services are started and set to run automatically when the OpenGeo Suite is installed. Accessing web applications -------------------------- The easiest way to launch the web-based applications contained in the OpenGeo Suite is via the Dashboard. All web applications are linked from this application. The Dashboard is accessible via the following URL: http://localhost:8080/dashboard/ Note: You will need to change the port number if your Tomcat installation is serving on a different port. +--------------------------------+------------------------------------------------------------------------+ | Application | URL | +================================+========================================================================+ | OpenGeo Suite Dashboard | http://localhost:8080/dashboard/ | +--------------------------------+------------------------------------------------------------------------+ | GeoServer | http://localhost:8080/geoserver/ | +--------------------------------+------------------------------------------------------------------------+ | OpenGeo Suite Documentation | http://localhost:8080/docs/ | +--------------------------------+------------------------------------------------------------------------+ | GeoExplorer | http://localhost:8080/geoexplorer/ | +--------------------------------+------------------------------------------------------------------------+ | Styler | http://localhost:8080/styler/ | +--------------------------------+------------------------------------------------------------------------+ | GeoEditor | http://localhost:8080/geoeditor/ | +--------------------------------+------------------------------------------------------------------------+ | OpenGeo Recipe Book | http://localhost:8080/recipes/ | +--------------------------------+------------------------------------------------------------------------+ Accessing PostGIS ----------------- You can access PostGIS in one of two ways: via the command line will the **psql** application, or via a graphical interface with the **pgadmin3** application. Both commands should be on the path and can be invoked from any Terminal window. If unfamiliar with PostGIS, start with **pgadmin3**. This version of PostGIS is running on port 5432, with administrator username and password **opengeo** / **opengeo**. Installing the OpenGeo Suite Enterprise Edition =============================================== If you have installed the OpenGeo Suite Community Edition, you're done! If you have registered for the OpenGeo Suite Enterprise Edition, the next step is to install the package with the extra features contained only in the OpenGeo Suite Enterprise Edition. RPM Installation ---------------- 1. If you haven't already done so, begin by following the instructions above in the *base installation*. 2. You will have received a username and password when you registered for the Enterprise Edition. Add the following YUM repository using the commands below, making sure to substitute in your username for ```` and password for ````. For 32 bit systems: cd /etc/yum.repos.d wget --user='' --password='' http://yum-ee.opengeo.org/centos/5/i386/OpenGeoEE.repo For 64 bit systems: cd /etc/yum.repos.d wget --user='' --password='' http://yum-ee.opengeo.org/centos/5/x86_64/OpenGeoEE.repo 3. Edit the OpenGeoEE.repo file filling in your username and password. 4. Update YUM: yum update 5. Install the ``opengeo-suite-ee`` package: yum install opengeo-suite-ee The ``opengeo-suite-ee`` package contains all of the additional features contained in the OpenGeo Suite Enterprise Edition. APT Installation ---------------- 1. If you haven't already done so, begin by following the instructions above in the *base installation*. 2. You will have received a username and password when you registered for the Enterprise Edition. Add the following APT repository using the commands below, making sure to substitute in your username for ```` and password for ````. echo "deb http://:@apt-ee.opengeo.org/ubuntu lucid main" >> /etc/apt/sources.list 3. Update APT: apt-get update 4. Install the ``opengeo-suite-ee`` package: apt-get install opengeo-suite-ee The ``opengeo-suite-ee`` package contains all of the additional features contained in the OpenGeo Suite Enterprise Edition. For More Information ==================== Please visit http://opengeo.org/ or see the documentation included with this software.