* `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!
/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
-----------------------
+
(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:
-----------------------
+
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
/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
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]
---------------------------------------------------------------------------
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.