new file

Author: JeffSchering

source/install/install-rhel-71-mattermost.rst

@@ -0,0 +1,110 @@
+..  _install-rhel-71-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 7.1**
+
+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. Set up Mattermost to use the systemd init daemon which handles
+   supervision of the Mattermost process.
+
+  a. Create the Mattermost configuration file:
+  
+    ``sudo touch /etc/systemd/system/mattermost.service``
+    
+  b. Open the configuration file in your favorite text editor, and copy the following lines into the file:
+  
+    .. code-block:: none
+    
+      [Unit]
+      Description=Mattermost
+      After=syslog.target network.target postgresql-9.4.service
+
+      [Service]
+      Type=simple
+      WorkingDirectory=/opt/mattermost/bin
+      User=mattermost
+      ExecStart=/opt/mattermost/bin/platform
+      PIDFile=/var/spool/mattermost/pid/master.pid
+      LimitNOFILE=49152
+
+      [Install]
+      WantedBy=multi-user.target
+  
+  c. Make the service executable.
+  
+    ``sudo chmod 664 /etc/systemd/system/mattermost.service``
+  
+  d. Reload the systemd services.
+  
+    ``sudo systemctl daemon-reload``
+  
+  f. Enable the Mattermost service.
+  
+    ``sudo chkconfig mattermost on``
+  
+  g. Set Mattermost to start on boot.
+  
+    ``sudo systemctl enable mattermost``
+
+9. Start the Mattermost server.
+
+  ``sudo systemctl 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.