Added RHEL 6.6 install, and added MySQL database install

JeffSchering · JeffSchering · commit b4b2840a9e5e · 2016-12-13T16:30:49.000-08:00
diff --git a/source/guides/administrator.rst b/source/guides/administrator.rst
@@ -12,6 +12,7 @@ Installing Mattermost
 
    /install/requirements.rst
    Installing on Ubuntu 14.04 LTS </install/install-ubuntu-1404.rst>
+   Installing on RHEL 6.6 </install/install-rhel-66.rst>
    /install/docker-local*
    /install/docker-ebs*
    /install/ee-install*
diff --git a/source/install/config-ssl-http2-nginx.rst b/source/install/config-ssl-http2-nginx.rst
@@ -12,7 +12,8 @@ You can use any certificate that you want, but these instructions show you how t
 1. Log into the server that hosts NGINX and open a terminal window.
 2. Install git.
 
-  ``sudo apt-get install git``
+  - If you are using Ubuntu or Debian:  ``sudo apt-get install git``
+  - If you are using RHEL: ``sudo yum install git``
 
 3. Clone the Let's Encrypt repository on GitHub.
 
diff --git a/source/install/install-rhel-66-mattermost.rst b/source/install/install-rhel-66-mattermost.rst
@@ -0,0 +1,82 @@
+..  _install-rhel-66-mattermost:
+
+Installing Mattermost Server
+============================
+
+Install Mattermost Server on a 64-bit machine.
+
+Assume that the IP address of this server is 10.10.10.2
+
+**To install Mattermost Server on RHEL**
+
+1. Log into the server that will host Mattermost Server and open a terminal window.
+
+2. Download `the latest version of the Mattermost Server <https://docs.mattermost.com/administration/upgrade.html#version-archive>`_. In the following command, replace ``X.X.X`` with the version that you want to download:
+
+``wget https://releases.mattermost.com/X.X.X/mattermost-X.X.X-linux-amd64.tar.gz``
+
+5. Extract the Mattermost Server files.
+
+  ``tar -xvzf *.gz``
+
+3. Move the extracted file to the ``/opt`` directory.
+
+  ``sudo mv mattermost /opt``
+
+4. Create the storage directory for files.
+
+  ``sudo mkdir /opt/mattermost/data``
+
+  .. note::
+    The storage directory will contain all the files and images that your users post to Mattermost, so you need to make sure that the drive is large enough to hold the anticipated number of uploaded files and images.
+
+5. Set up a system user and group called ``mattermost`` that will run this service, and set the ownership and permissions.
+
+  a. ``sudo useradd --system --user-group mattermost``
+  b. ``sudo chown -R mattermost:mattermost /opt/mattermost``
+  c. ``sudo chmod -R g+w /opt/mattermost``
+
+6. Set up the database driver in the file ``/opt/mattermost/config/config.json``. Open the file in your favorite text editor and make the following changes:
+
+  -  If you are using PostgreSQL:    
+    1.  Set ``"DriverName"`` to ``"postgres"``
+    2.  Set ``"DataSource"`` to the following value, replacing ``<mmuser-password>``  and ``<host-name-or-IP>`` with the appropriate values:
+     ``"postgres://mmuser:<mmuser-password>@<host-name-or-IP>:5432/mattermost?sslmode=disable&connect_timeout=10"``.
+  -  If you are using MySQL:    
+    1.  Set ``DriverName"`` to ``"mysql"``
+    2.  Set ``"DataSource"`` to the following value, replacing ``<mmuser-password>``  and ``<host-name-or-IP>`` with the appropriate values:
+      ``"mmuser:<mmuser-password>@tcp(<host-name-or-IP>:3306)/mattermost?charset=utf8"``
+
+7. Test the Mattermost server to make sure everything works.
+
+   a. Switch to the mattermost user: ``sudo su mattermost``
+   b. Change to the ``bin`` directory: ``cd /opt/mattermost/bin``
+   c. Start the Mattermost server: ``./platform``
+   
+  When the server starts, it shows some log information and the text ``Server is listening on :8065``. You can stop the server by typing ``CTRL-C`` in the terminal window.
+
+8. Setup Mattermost to use the Upstart daemon which handles supervision of the Mattermost process.
+
+  a. Create the Mattermost configuration file:  ``sudo touch /etc/init/mattermost.conf``
+  b. Open the configuration file in your favorite text editor, and copy the following lines into the file:
+  
+  .. code-block:: none
+  
+    start on runlevel [2345]
+    stop on runlevel [016]
+    respawn
+    limit nofile 50000 50000
+    chdir /opt/mattermost
+    exec bin/platform
+
+9. Start the Mattermost server.
+
+  ``sudo start mattermost``
+
+10. Verify that Mattermost is running.
+
+  ``curl http://localhost:8065``
+  
+  You should see the HTML that's returned by the Mattermost server.
+
+Now that Mattermost is installed and running, it's time to create the admin user and configure Mattermost for use.
diff --git a/source/install/install-rhel-66-mysql.rst b/source/install/install-rhel-66-mysql.rst
@@ -0,0 +1,66 @@
+..  _install-rhel-66-mysql:
+
+Installing MySQL Database Server
+================================
+
+You can install either MySQL or PostgreSQL. To install PostgreSQL, see :ref:`install-rhel-66-postgresql`
+
+**To install MySQL 5.7 on RHEL 6.6:**
+
+1. Log into the server that will host the database, and open a terminal window.
+
+2. Download the MySQL Yum repository from dev.mysql.com.
+
+  ``wget http://dev.mysql.com/get/mysql57-community-release-el6-9.noarch.rpm``
+
+3. Install the Yum repository from the file that you downloaded.
+
+  ``sudo yum localinstall mysql-community-release-el6-9.noarch.rpm``
+
+4. Install MySQL.
+
+  ``sudo yum install mysql-community-server``
+
+5. Start the MySQL server.
+
+  ``sudo service mysqld start``
+  
+  .. note::
+    1. The first time that you start MySQL, the superuser account ``'root'@'localhost'`` is created and a temporary password is generated for it.
+    2. Also the first time that you start MySQL, the ``validate_password`` plugin is installed. The plugin forces passwords to contain at least one upper case letter, one lower case letter, one digit, and one special character, and that the total password length is at least 8 characters.
+
+6. Obtain the root password that was generated when you started MySQL for the first time.
+
+  ``sudo grep 'temporary password' /var/log/mysqld.log``
+
+7. Change the root password. Login with the password that you obtained from the previous step.
+
+  ``mysql -u root -p``
+
+8. Change the password. At the mysql prompt, type the following command. Be sure to replace ``Password42!`` with the password that you want to use.
+
+  ``mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY 'Password42!';``
+
+9. Set MySQL to start automatically when the machine starts.
+
+  ``sudo chkconfig mysqld on``
+
+10. Create the Mattermost user 'mmuser'.
+
+  ``mysql> create user 'mmuser'@'%' identified by 'mmuser-password';``
+
+  .. note::
+    1. Use a password that is more secure than 'mmuser-password'
+    2. The '%' means that mmuser can connect from any machine on the network. However, it's more secure to use the IP address of the machine that hosts Mattermost. For example, if you install Mattermost on the machine with IP address 10.10.10.2, then use the following command:
+
+  ``mysql> create user 'mmuser'@'10.10.10.2' identified by 'mmuser-password';``
+
+11. Create the Mattermost database.
+
+  ``mysql> create database mattermost;``
+
+12. Grant access privileges to the user 'mmuser'
+
+  ``mysql> grant all privileges on mattermost.* to 'mmuser'@'%';``
+
+After the database is set up, you can install Mattermost server.
diff --git a/source/install/install-rhel-66-nginx.rst b/source/install/install-rhel-66-nginx.rst
@@ -0,0 +1,44 @@
+.. _install-rhel-66-nginx:
+
+Installing NGINX Server
+=======================
+
+In a production setting, use a proxy server for greater security and performance of Mattermost.
+
+The main benefits of using a proxy are as follows:
+
+  -  SSL termination
+  -  HTTP to HTTPS redirect
+  -  Port mapping ``:80`` to ``:8065``
+  -  Standard request logs
+
+**To install NGINX on RHEL 6.6:**
+
+1. Log into the server that will host the proxy, and open a terminal window.
+
+3. Install NGINX on RHEL with
+
+   -  ``sudo vi /etc/yum.repos.d/nginx.repo``
+   -  Copy the below into the file
+
+   ::
+
+       [nginx]
+       name=nginx repo
+       baseurl=http://nginx.org/packages/rhel/6/$basearch/
+       gpgcheck=0
+       enabled=1
+
+   -  ``sudo yum install nginx.x86_64``
+   -  ``sudo service nginx start``
+   -  ``sudo chkconfig nginx on``
+
+4. Verify NGINX is running
+
+   -  ``curl http://10.10.10.3``
+   -  You should see a *Welcome to NGINX!* page
+
+**What to do next**
+
+1. Map a fully qualified domain name (FQDN) such as ``mattermost.example.com`` to point to the NGINX server.
+2. Configure NGINX to proxy connections from the internet to the Mattermost Server.
diff --git a/source/install/install-rhel-66-postgresql.rst b/source/install/install-rhel-66-postgresql.rst
@@ -0,0 +1,69 @@
+..  _install-rhel-66-postgresql:
+
+Installing PostgreSQL Database
+==============================
+
+1.  For the purposes of this guide we will assume this server has an IP
+    address of ``10.10.10.1``
+
+    -  **Optional:** if installing on the same machine substitute
+       ``10.10.10.1`` with ``127.0.0.1``
+
+2.  Install PostgreSQL 9.4+ (or MySQL 5.6+)
+
+    -  ``sudo yum install http://yum.postgresql.org/9.4/redhat/rhel-6-x86_64/pgdg-redhat94-9.4-1.noarch.rpm``
+    -  ``sudo yum install postgresql94-server postgresql94-contrib``
+    -  ``sudo service postgresql-9.4 initdb``
+    -  ``sudo chkconfig postgresql-9.4 on``
+    -  ``sudo service postgresql-9.4 start``
+
+3.  PostgreSQL created a user account called ``postgres``. You will need
+    to log into that account with:
+
+    -  ``sudo -i -u postgres``
+
+4.  You can get a PostgreSQL prompt by typing:
+
+    -  ``psql``
+
+5.  Create the Mattermost database by typing:
+
+    -  ``postgres=# CREATE DATABASE mattermost;``
+
+6.  Create the Mattermost user by typing:
+
+    -  ``postgres=# CREATE USER mmuser WITH PASSWORD 'mmuser_password';``
+
+7.  Grant the user access to the Mattermost database by typing:
+
+    -  ``postgres=# GRANT ALL PRIVILEGES ON DATABASE mattermost to mmuser;``
+
+8.  You can exit out of PostgreSQL by typing:
+
+    -  ``postgres=# \q``
+
+9.  You can exit the Postgres account by typing:
+
+    -  ``exit``
+
+10. Allow Postgres to listen on all assigned IP Addresses:
+
+    -  ``sudo vi /var/lib/pgsql/9.4/data/postgresql.conf``
+    -  Uncomment ``listen_addresses`` and change ``localhost`` to ``\*``
+
+11. Alter ``pg_hba.conf`` to allow the Mattermost Server to talk to the
+    Postgres database:
+
+    -  ``sudo vi /var/lib/pgsql/9.4/data/pg_hba.conf``
+    -  Add the following line to the ``IPv4 local connections``:
+    -  ``host all all 10.10.10.2/32 md5``
+
+12. Reload Postgres database:
+
+    -  ``sudo service postgresql-9.4 restart``
+
+13. Attempt to connect with the new created user to verify everything
+    looks good:
+
+    -  ``psql --host=10.10.10.1 --dbname=mattermost --username=mmuser --password``
+    -  ``mattermost=> \q``
diff --git a/source/install/install-rhel-66-server.rst b/source/install/install-rhel-66-server.rst
@@ -0,0 +1,21 @@
+..  _install-rhel-6-server:
+
+Installing Red Hat Enterprise Linux 6.6
+=====================================================
+
+Install RHEL 6.6 on each machine that hosts one or more of the components. In most cases you need the 64-bit version.
+
+You can use the 32-bit version on a machine that hosts the database and proxy server, but the Mattermost server requires 64-bit.
+
+**To install RHEL 6 Server:**
+
+1. Download the appropriate ISO image from RedHat and burn it to a CD-ROM.
+
+2. Boot the system from the CD-ROM drive and follow the on-screen prompts.
+
+3. After the system is installed, make sure that it's up to date with the most recent security patches. Open a terminal window and issue the following commands:
+
+   -  ``sudo yum update``
+   -  ``sudo yum upgrade``
+
+Now that the system is up to date, you can install the database.
diff --git a/source/install/install-rhel-66.rst b/source/install/install-rhel-66.rst
@@ -0,0 +1,23 @@
+.. _install-rhel-66:
+
+=================================
+Installing Mattermost on RHEL 6.6
+=================================
+
+Install a production-ready Mattermost system on 1 to 3 machines.
+
+.. include:: install-common-intro.rst
+
+.. contents:: Install and configure the components in the following order. Note that you need only one database, either MySQL or PostgreSQL.
+  :backlinks: top
+  :local:
+  
+.. include:: install-rhel-66-server.rst
+.. include:: install-rhel-66-mysql.rst
+.. include:: install-rhel-66-postgresql.rst
+.. include:: install-rhel-66-mattermost.rst
+.. include:: config-mattermost-server.rst
+.. include:: config-tls-mattermost.rst
+.. include:: install-rhel-66-nginx.rst
+.. include:: config-proxy-nginx.rst
+.. include:: config-ssl-http2-nginx.rst
