web-server/doc/en/user/source/community/remote-wps/install_geoserver.rst

.. _extensions_wps_remote_install_geoserver:

Deployment And Setup Of GeoServer With WPS Remote Plugin
========================================================

The following commands will prepare a CentOS 7 Minimal ISO machine for the deployment of:

* GeoServer with the following plugins:
    
    * GeoServer WPS
    * GeoServer Remote WPS Orchestrator
    * GeoServer Importer
    
The OS iso has been downloaded from:::

    http://isoredirect.centos.org/centos/7/isos/x86_64/CentOS-7-x86_64-Minimal-1503-01.iso

Preparation of the system: standard and basic OS packages
---------------------------------------------------------

Hostname and other useful packages
++++++++++++++++++++++++++++++++++

Update the file ``/etc/hosts`` making sure that the ip addresses matches the name of the machine.

.. code-block:: bash

  # as root

  $> yum -y install man vim openssh-clients mc zip unzip wget net-tools
    
Configure the Java Virtual Environment
++++++++++++++++++++++++++++++++++++++

.. code-block:: bash

  # as root
  
  $> wget --no-check-certificate --no-cookies --header "Cookie: oraclelicense=accept-securebackupcookie" http://download.oracle.com/otn-pub/java/jdk/8u65-b17/jdk-8u74-linux-x64.tar.gz
  
  $> tar xzvf jdk-8u65-linux-x64.tar.gz
  $> mkdir /usr/java
  $> mv jdk1.8.0_65/ /usr/java/
  
  $> alternatives --install /usr/bin/java java /usr/java/jdk1.8.0_65/bin/java 20000
  
  $> alternatives --install /usr/bin/javac javac /usr/java/jdk1.8.0_65/bin/javac 20000
  
  $> alternatives --install /usr/bin/jar jar /usr/java/jdk1.8.0_65/bin/jar 20000
  
  $> alternatives --install /usr/bin/javaws javaws /usr/java/jdk1.8.0_65/bin/javaws 20000
  
  $> alternatives --set java /usr/java/jdk1.8.0_65/bin/java
  $> alternatives --set javac /usr/java/jdk1.8.0_65/bin/javac
  $> alternatives --set jar /usr/java/jdk1.8.0_65/bin/jar
  $> alternatives --set javaws /usr/java/jdk1.8.0_65/bin/javaws
  
  # Verify the proper installation on the JDK
  
  $> java -version
    java version "1.8.0_65"
    Java(TM) SE Runtime Environment (build 1.8.0_65-b17)
    Java HotSpot(TM) 64-Bit Server VM (build 25.65-b01, mixed mode)
  
  $> javac -version
    javac 1.8.0_65
    
Installing Apache Tomcat
++++++++++++++++++++++++

.. code-block:: bash

  # as root
  
  $> yum -y install tomcat-webapps
  $> systemctl disable tomcat.service

  $> cp /etc/sysconfig/tomcat /etc/sysconfig/geoserver
  $> ln -s /usr/share/tomcat/ /opt/tomcat

**Creating apache tomcat HOME context**

Creating base template directory

.. code-block:: bash

  # as root

  $> mkdir -p /var/lib/tomcat/geoserver/{bin,conf,logs,temp,webapps,work}

  $> cp -Rf /opt/tomcat/conf/* /var/lib/tomcat/geoserver/conf/
  
**Creating geoserver apache tomcat BASE context**

Make sure you already:

* installed tomcat (Installing apache tomcat)

* created the base catalina template (Creating apache tomcat HOME context)

Edit ``server.xml`` file

GeoServer is the first tomcat instance we are installing in this VM, so we can keep the default ports:

  - 8005 for commands to catalina instance

  - 8009 for the AJP connection port

  - 8080 for the HTTP connection port
  
Remember that you may change these ports in the file ``/var/lib/tomcat/geoserver/conf/server.xml``

**Final configurations**

Set the ownership of the ``geoserver/`` related directories to user tomcat

.. code-block:: bash

  # as root
  
  $> chown tomcat: -R /var/lib/tomcat/geoserver
  $> cp /etc/tomcat/tomcat.conf /etc/tomcat/geoserver.conf
  
  $> vi /etc/tomcat/geoserver.conf
  
    # This variable is used to figure out if config is loaded or not.
    TOMCAT_CFG_LOADED="1"

    # In new-style instances, if CATALINA_BASE isn't specified, it will
    # be constructed by joining TOMCATS_BASE and NAME.
    TOMCATS_BASE="/var/lib/tomcats/"

    # Where your java installation lives
    #JAVA_HOME="/usr/lib/jvm/jre"
    JAVA_HOME="/usr/java/jdk1.7.0_71"

    # Where your tomcat installation lives
    CATALINA_HOME="/usr/share/tomcat"
    CATALINA_BASE="/var/lib/tomcat/geoserver"
    CATALINA_PID=$CATALINA_BASE/work/pidfile.pid

    # System-wide tmp
    CATALINA_TMPDIR="/var/cache/tomcat/temp"

    # You can pass some parameters to java here if you wish to
    #JAVA_OPTS="-Xminf0.1 -Xmaxf0.3"
    # Use JAVA_OPTS to set java.library.path for libtcnative.so
    #JAVA_OPTS="-Djava.library.path=/usr/lib"
    JAVA_OPTS="-server -XX:SoftRefLRUPolicyMSPerMB=36000 -Xms1024m -Xmx2048m
    -XX:PermSize=64m -XX:+UseConcMarkSweepGC -XX:NewSize=48m -DGEOSERVER_DATA_DIR=/storage/data/
    -DENABLE_ADVANCED_PROJECTION=false -Dorg.geotools.shapefile.datetime=true -Duser.timezone=GMT
    -Dorg.geotools.filter.function.simplify=true -DGEOMETRY_COLLECT_MAX_COORDINATES=50000"

    # You can change your tomcat locale here
    #LANG="en_US"
    # Run tomcat under the Java Security Manager
    SECURITY_MANAGER="false"
    
  $> cp /usr/lib/systemd/system/tomcat.service /usr/lib/systemd/system/geoserver.service
  
  $> vi /usr/lib/systemd/system/geoserver.service
  
    EnvironmentFile=/etc/tomcat/geoserver.conf
  
  $> systemctl enable geoserver.service
  $> systemctl restart geoserver.service
  
  # Follow the server startup procedure and make sure everything goes smoothly through the following command
  
  $> tail -F /var/lib/tomcat/geoserver/logs/catalina.YYYY-MM-DD.log

Deploy And Configure GeoServer
++++++++++++++++++++++++++++++

**First deployment**

.. code-block:: bash

  # as root
  
  # Git and Maven must be installed on the system
  $> yum -y install git
  $> yum -y install maven
  
  # Verify the Maven installation and double check that the JDK recognized is the Java Sun 1.7+
  $> mvn -version
  
    Apache Maven 3.0.5 (Red Hat 3.0.5-16)
    Maven home: /usr/share/maven
    Java version: 1.8.0_65, vendor: Oracle Corporation
    Java home: /usr/java/jdk1.8.0_65/jre
    Default locale: en_US, platform encoding: UTF-8
    OS name: "linux", version: "3.10.0-229.el7.x86_64", arch: "amd64", family: "unix"
    
  # The following procedures allow to collect and compile the source code from the GIT repository.
  $> cd
  
  $> git clone https://github.com/geosolutions-it/geoserver.git geoserver.src
  
  $> cd geoserver.src/src
  
  $> git checkout wps-remote
  $> git pull
  
  $> mvn clean install -Pwps,wps-remote,importer,security,rest-ext -DskipTests
  
  $> mv web/app/target/geoserver.war /var/lib/tomcat/geoserver/webapps/
  
  $> chown -Rf tomcat: /var/lib/tomcat/geoserver
  
  $> mv /var/lib/tomcat/geoserver/webapps/geoserver/data/ /storage/
  
  $> chown -Rf tomcat: /storage
  
  $> vim /storage/data/remoteProcess.properties
  
	# Default Properties
	remoteProcessStubCycleSleepTime = 100

	# Base path where uploaded files are stored
	# . This is used only when a remote uploader is enabled on the Python
	# . WPS Agent. This property represents the local base path (on the filesystem
	# . of GeoServer) where to search for uploaded files.
	# . If not file has been found here (or this option is not enabled), GeoServer
	# . looks for absolute path and/or paths relative to the GEOSERVER DATA DIR.
	#uploadedFilesBasePath = /tmp

	# Full path to the template used to generate the OWS WMC Json output
	# . This property is used only when a "application/owc" output type on
	# . the Python WPS Agent.
	#owc_wms_json_template = absolute_path/to/wmc_template.json

	# Specific kvps for {@link RemoteProcessClient) implementations
	xmpp_server = localhost
	xmpp_server_embedded = false
	xmpp_server_embedded_secure = true
	xmpp_server_embedded_certificate_file = bogus_mina_tls.cert
	xmpp_server_embedded_certificate_password = boguspw
	xmpp_port = 5222

	xmpp_manager_username = admin
	xmpp_manager_password = R3m0T3wP5

	# domain and MUC service name of the XMPP Server
	xmpp_domain = geoserver.org
	xmpp_bus = conference

	# name, user and password of the management room
	xmpp_management_channel = management
	xmpp_management_channel_user = admin
	xmpp_management_channel_pwd = R3m0T3wP5

	# comma separated list of available rooms for services. Those rooms'names will be equal to the service and WPS Process namespace
	# Avoid spaces
	xmpp_service_channels = default,geosolutions

	# millis
	xmpp_packet_reply_timeout = 500

	# connection keep alive
	xmpp_connection_ping_interval = 30000
	xmpp_connection_ping_timeout = 10000
	xmpp_connection_ping_initial_delay = 20000

	# Thresholds indicating overloaded resources
	xmpp_cpu_perc_threshold = 82.5
	xmpp_mem_perc_threshold = 84.6
    
  # Restart GeoServer
  
  $> service geoserver restart
  
.. warning:: GeoServer won't connect to XMPP Server until it has been correctly configured and started as explained in the next section :ref:`extensions_wps_remote_install_xmpp`.