update READMe user/csharp/centos-support
authorChris Sharp <csharp@georgialibraries.org>
Mon, 28 Jan 2019 01:25:47 +0000 (20:25 -0500)
committerChris Sharp <csharp@georgialibraries.org>
Mon, 28 Jan 2019 01:25:47 +0000 (20:25 -0500)
README

diff --git a/README b/README
index 2b74eed..402d7ad 100644 (file)
--- a/README
+++ b/README
@@ -69,6 +69,7 @@ Well-tested values for <osname> include:
   * `ubuntu-trusty` for Ubuntu 14.04
   * `ubuntu-xenial` for Ubuntu 16.04
   * `ubuntu-bionic` for Ubuntu 18.04
+  * `centos` for CentOS 7 (experimental)
 
 Patches and suggestions for improvement from users of these distributions,
 or others, are welcome!
@@ -213,7 +214,7 @@ work for OpenSRF.
 /etc/init.d/ejabberd stop
 ---------------------------------------------------------------------------
 +
-.(Debian / Ubuntu Xenial / Ubuntu Bionic) Stopping ejabberd
+.(Debian / Ubuntu Xenial / Ubuntu Bionic / CentOS 7) Stopping ejabberd
 [source, bash]
 ---------------------------------------------------------------------------
 systemctl stop ejabberd.service
@@ -284,7 +285,7 @@ hosts:
 -----------------------
 +
 (Ubuntu Bionic) Ejabberd 18.x::
-Open `/etc/ejabberd/ejabberd.yml` and make the following
+Open `/etc/ejabberd/ejabberd.yml` and make the following 
 changes:
   a. Define your public and private domains in the `hosts` directive. For
    example:
@@ -309,6 +310,49 @@ hosts:
 -----------------------
 +
   g. Uncomment the `mod_legacy_auth` directive
+
+(CentOS 7) Ejabberd 18.x::
+Open `/opt/ejabberd/conf/ejabberd.yml` and make the following 
+changes:
+  a. Define your public and private domains in the `hosts` directive. For
+   example:
++
+[source, bash]
+---------------------------------------------------------------------------
+hosts:
+  - "localhost"
+  - "private.localhost"
+  - "public.localhost"
+---------------------------------------------------------------------------
++
+  b. Change `starttls_required` to false
+  c. Change `shaper:` `normal` and `fast` values to 500000
+  d. Increase the `max_user_sessions:` `all:` value to 10000
+  e. Comment out the `mod_offline` directive
++
+-----------------------
+##mod_offline:
+    ##access_max_user_messages: max_user_offline_messages
+-----------------------
++
+  f. Add the `mod_legacy_auth` directive under the `modules` section 
+(indent 2 spaces):
++
+-----------------------
+modules:
+  ....
+  mod_version:
+    show_os: false
+  mod_legacy_auth: {}
+-----------------------
++
+   g. Add the following lines under the `## Local Variables`:
++
+-----------------------
+auth_method: internal
+auth_password_format: plain
+-----------------------
++
 3. Restart the ejabberd server to make the changes take effect:
 +
 .(Ubuntu Trusty) Starting ejabberd
@@ -317,7 +361,7 @@ hosts:
 /etc/init.d/ejabberd start
 ---------------------------------------------------------------------------
 +
-.(Debian / Ubuntu Xenial / Ubuntu Bionic) Starting ejabberd
+.(Debian / Ubuntu Xenial / Ubuntu Bionic / CentOS 7) Starting ejabberd
 [source, bash]
 ---------------------------------------------------------------------------
 systemctl start ejabberd.service
@@ -615,13 +659,21 @@ for installing WebSockets support.
    and 443, then restart Apache.
 +
 2. Install NGINX if not already present:
+Debian/Ubuntu:
 +
 [source, bash]
 ---------------------------------------------------------------------------
 apt-get install nginx
 ---------------------------------------------------------------------------
 +
++
+[source, bash]
+-----------------------
+yum install nginx
+-----------------------
++
 3. Copy the example NGINX configuration file into place and remove default.
+Debian/Ubuntu:
 +
 [source, bash]
 ---------------------------------------------------------------------------
@@ -631,6 +683,15 @@ ln -s /etc/nginx/sites-available/osrf-ws-http-proxy /etc/nginx/sites-enabled/osr
 rm /etc/nginx/sites-enabled/default
 ---------------------------------------------------------------------------
 +
++
+[source, bash]
+---------------------------------------------------------------------------
+for i in enabled available; do mkdir /etc/nginx/sites-$i; done
+cd /path/to/opensrf-OSRFVERSION
+cp examples/nginx/osrf-ws-http-proxy /etc/nginx/sites-available/
+ln -s /etc/nginx/sites-available/osrf-ws-http-proxy /etc/nginx/sites-enabled/osrf-ws-http-proxy
+---------------------------------------------------------------------------
++
 4. Edit `/etc/nginx/sites-available/osrf-ws-http-proxy` to set the location
    of the SSL certificate and private key.
 5. Generate a dhparam file in the directory specified in the nginx config.