.. Reminder for header structure:				
	Parts (H1)			    : #################### with overline
	Chapters (H2)		    : ******************** with overline
	Sections (H3)		    : ====================
	Subsections (H4)	  : --------------------
	Subsubsections (H5) : ^^^^^^^^^^^^^^^^^^^^
	Paragraphs (H6)		  : """""""""""""""""""""

.. meta::
  :description: Installing WAPT Server on CentOS7
  :keywords: WAPT, installing, CentOS7

.. |date| date::

.. role:: raw-html(raw)
  :format: html

#################################
Installing WAPT Server on CentOS7
#################################

.. _base_centos_server_install:

*************************************
Setting up the CentOS / RedHat server
*************************************

In order to install a fresh :raw-html:`<font color="red"><b>CentOS7</b></font>`
machine (virtual or physical) please refer to official
`CentOS documentation <https://docs.centos.org/>`_.
This documentation is also valid for Redhat7.

.. warning::

  * Install **64bit** version.

  * Install the server without the graphical user interface.

.. danger::

  From WAPT Server :program:`Nginx` is the **ONLY** supported web server.
  **Apache on Linux is no longer supported in WAPT**.

Configuring network parameters
==============================

.. include:: wapt-resources/linux-server-naming.txt

Configuring the name of WAPT Server
===================================

.. hint::

  The short name of the WAPT Server must not be longer than 15 characters
  (the limit is due to *sAMAccountName* restriction in Active Directory).

The name of the WAPT Server must be a :abbr:`FQDN (Fully Qualified Domain Name)`,
that is to say it has both the server name and the DNS suffix.

* Modify the :file:`/etc/hostname` file and write the :term:`FQDN` of the server.

.. code-block:: bash

  # /etc/hostname of the waptserver
  srvwapt.mydomain.lan

* Configure the :file:`/etc/hosts` file, be sure to put both
  the :term:`FQDN` and the short name of the server.

.. code-block:: bash

  # /etc/hosts of the waptserver
  127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
  ::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
  10.0.0.10   srvwapt.mydomain.lan srvwapt

.. hint::

  * On the line defining the DNS server IP address, be sure to have the IP
    of the server (not 127.0.0.1), then the :term:`FQDN`, then the short name.

  * Do not change the line with :code:`localhost`.

Configuring the IP address of the WAPT Server
=============================================

* Modify the :file:`/etc/sysconfig/network-scripts/ifcfg-eth0` file
  and define a static IP address. The name of the file can be different,
  like :file:`ifcfg-ens0` for example.

.. code-block:: bash

  # /etc/sysconfig/network-scripts/ifcfg-eth0 of the WAPT server
  TYPE="Ethernet"
  BOOTPROTO="static"
  NAME="eth0"
  ONBOOT="yes"
  IPADDR=10.0.0.10
  NETMASK=255.255.255.0
  GATEWAY=10.0.0.254
  DNS1=10.0.0.1
  DNS2=10.0.0.2

* Apply the network configuration by rebooting the machine
  with a :code:`reboot`.

.. code-block:: bash

  reboot

* If it has not already been done, :ref:`create the DNS entries
  for the WAPT Server <srv_dns>` in the :term:`Organization` Active Directory
  or on your DNS server.

* After reboot, configure the system language in English in order to have
  non-localized logs for easier searching of common errors.

.. code-block:: bash

  localectl set-locale LANG=en_US.utf8
  localectl status

* Check that the machine clock is on time (with NTP installed),
  and that SELinux and the firewall are enabled.

.. code-block:: bash

  yum list installed | grep ntp
  service ntpd status
  date
  sestatus
  systemctl status firewalld

.. hint::

  If the NTP package is not installed.

  .. code-block:: bash

    yum install ntp -y
    systemctl enable ntpd.service
    systemctl start ntpd

* Update CentOS and set up the :abbr:`EPEL (Extra Packages
  for Enterprise Linux)` repository.

.. code-block:: bash

  yum update
  yum install epel-release wget sudo -y

The server is now ready. You may now go on to the next step
and :ref:`install WAPT on your CentOS/ RedHat <install_wapt_centos>`.

.. attention::

  The upgrade procedure is different from installation. For upgrade, please
  refer to :ref:`Upgrading the WAPT Server <upgrade-wapt>`.

.. _install_wapt_centos:

Installing the WAPT Server runs a few steps:

* Configuring the repositories.

* Installing additional Linux packages.

* Installing and provisioning the PostgreSQL database.

* Post-configuring the WAPT server.

**************************
Configuring RPM repository
**************************

The configuration of repositories for **WAPT Enterprise**
and **WAPT Discovery** Edition differs. **Make sure to choose the right one!**

Discovery
=========

.. important::

  Follow this procedure for getting the right packages
  for the WAPT **Discovery** Edition.
  For WAPT **Enterprise** Edition please refer to the next block.

.. note::

  Not Available as of |date|.

  WAPT Discovery will be released later. For the free version,
  refer to wapt-1.8 documentation https://www.wapt.fr/en/doc-1.8/

Enterprise
==========

.. important::

  **Follow this procedure for getting the right packages
  for the WAPT Enterprise** Edition.
  For WAPT **Discovery** Edition please refer to the previous block.

  To access WAPT **Enterprise** resources, you must use the username
  and password provided by our sales department.

* Adding Tranquil IT's repository.

  .. hint:: 
            
    Replace **user** and **password** to access WAPT Enterprise repository, with those provided by our sales department.

  .. code-block:: bash

    cat > /etc/yum.repos.d/wapt.repo <<EOF
    [wapt]
    name=WAPT Server Repo
    baseurl=https://srvwapt-pro.tranquil.it/entreprise/centos7/wapt-2.0/
    username=user
    password=password
    enabled=1
    gpgcheck=1
    EOF

***********************************
Installing the WAPT Server packages
***********************************

* Retrieving the key :file:`.gpg`.

.. code-block:: bash

  wget -q -O /tmp/tranquil_it.gpg "https://wapt.tranquil.it/centos7/RPM-GPG-KEY-TISWAPT-7"; rpm --import /tmp/tranquil_it.gpg

* Install all necessary packages.

.. code-block:: bash

  yum install epel-release -y
  yum install postgresql96-server postgresql96-contrib tis-waptserver tis-waptsetup cabextract -y
  
* Initialize the PostgreSQL database and activate the services.
  
.. code-block:: bash
  
  sudo /usr/pgsql-9.6/bin/postgresql96-setup initdb
  sudo systemctl enable postgresql-9.6 waptserver nginx
  sudo systemctl start postgresql-9.6 nginx
  
****************
Post-configuring
****************

.. include:: wapt-postconf.rst

Your WAPT server is now ready. You may go to the documentation
on :ref:`installing the WAPT console <installing_the_WAPT_console>`!!