859
edits
Changes
From SME Server
Jump to navigationJump to searchno edit summary
[[File:Rocket-dot-chat-logo.png|200px]]
[[File:Rocket-dot-chat-logo.png|200px]]
</blockquote>
</blockquote>
{{Note box| Please note there is work in progress to create a contrib. Please see [[Rocket_Chat:Contrib|Rocket Chat Contrib]]}}
{{Warning box| Due to the changes in Rockets requirements noted below please see the [[Rocket_Chat:Contrib|Rocket Chat Contrib]] This will run Rocket in a docker container}}
{{Warning box| Most of the following is obsolete but here for posterity and reference}}
===Maintainer===
===Maintainer===
'''Maintainer:''' [mailto:RequestedDeletion@gmail.com[[User:RequestedDeletion|RequestedDeletion]]]
'''Maintainer:''' [mailto:RequestedDeletion@gmail.com[[User:RequestedDeletion|RequestedDeletion]]]
In short, a [https://slack.com/ Slack], [https://www.hipchat.com/ HipChat], Jabber (XMMP), IRC or even a [https://skype.com Skype] alternative, completely and '''securely self hosted and controlled'''. Great for closed (company/family/friends/community) teams.
In short, a [https://slack.com/ Slack], [https://www.hipchat.com/ HipChat], Jabber (XMMP), IRC or even a [https://skype.com Skype] alternative, completely and '''securely self hosted and controlled'''. Great for closed (company/family/friends/community) teams.
{{Note box|Rocket.Chat is a young project and therefore under very active development. Very regularly they release new (minor) versions. Your milage may vary! Please see their [https://github.com/RocketChat/Rocket.Chat development] on [https://github.com/RocketChat/Rocket.Chat GitHub] for the activities and Rocket.Chat developments.}}
{{Note box|Rocket.Chat is a young project and therefore under very active development. Very regularly they release new (minor) versions. Your mileage may vary! Please see their [https://github.com/RocketChat/Rocket.Chat development] on [https://github.com/RocketChat/Rocket.Chat GitHub] for the activities and Rocket.Chat developments.}}
==Obsolete Notes==
This how-to can be discussed on the forums [https://forums.contribs.org/index.php/topic,52405.0.html '''here''']
This how-to can be discussed on the forums [https://forums.contribs.org/index.php/topic,52405.0.html '''here''']
Latest Rocket.Chat version tested: '''0.39''' (please see the change log [https://github.com/RocketChat/Rocket.Chat/releases here]).
==Requirements==
==Requirements==
{{Warning box|Please be aware that for now only Rocket.Chat up to version '''0.39''' can be installed due to dependencies on the Nodejs version available via software collections.}}
Rocket.Chat requires several higher versions of applications and frameworks than provided by Koozali SME Server by default. Therefore we need to install some '''[[Software Collections]]''' Packages and enable some addition repo's.
Rocket.Chat requires several higher versions of applications and frameworks than provided by Koozali SME Server by default. Therefore we need to install some '''[[Software Collections]]''' Packages and enable some addition repo's.
# You must have '''SME Server 9.x 64-bit'''
# You must install the '''[[epel]]''' repository
# You must install the '''[[epel]]''' repository
# You must install the '''[[centos-sclo-rh]]''' repository
# You must install the '''[[centos-sclo-rh]]''' repository
After having installed the above repo's and installing Software Collections, you can install the required collections by:
After having installed the above repo's and installing Software Collections, you can install the required collections by:
yum install rh-python34-python rh-mongodb26-mongodb rh-mongodb26-mongodb-server \
yum install rh-python34-python rh-mongodb32-mongodb rh-mongodb32-mongodb-server nodejs010 GraphicsMagick --enablerepo=centos-sclo-rh,epel
After installing the Software Collections we need to update some packages using NodeJS package manager NPM:
After installing the Software Collections we need to update some packages using NodeJS package manager NPM:
scl enable nodejs010 bash
scl enable nodejs010 'npm install -g npm ws inherits n forever forever-service'
scl enable nodejs010 'n 0.10.40'
n 0.10.40
== Installation of Rocket.Chat==
== Installation of Rocket.Chat==
ln -s /etc/rc.d/init.d/e-smith-service /etc/rc.d/rc7.d/S99rocketchat
ln -s /etc/rc.d/init.d/e-smith-service /etc/rc.d/rc7.d/S99rocketchat
config set rocketchat service status enabled TCPPort 3000 access public
config set rocketchat service status enabled TCPPort 3000 access public
For MongoDB (please note the usage of mongod and NOT mongod'''b'''):
For MongoDB (please note the usage of mongod and NOT mongod'''b'''):
ln -s /etc/rc.d/init.d/e-smith-service /etc/rc.d/rc7.d/S99rh-mongodb26-mongod
ln -s /etc/rc.d/init.d/e-smith-service /etc/rc.d/rc7.d/S99rh-mongodb32-mongod
config set rh-mongodb26-mongod service status enabled access private TCPPort 27017
config set rh-mongodb32-mongod service status enabled access private TCPPort 27017
And to update the ports:
signal-event remoteaccess-update
signal-event remoteaccess-update
Now we can download and install the latest Rocket.Chat version from their [https://rocket.chat/releases/ downloads] repository:
Now we can download and install the latest Rocket.Chat version from their [https://rocket.chat/releases/ downloads] repository:
cd /root
cd /root
curl -L https://rocket.chat/releases/latest/download -o rocket.chat.tgz
curl -L https://rocket.chat/releases/0.39.0/download -o rocket.chat.tgz
tar zxvf rocket.chat.tgz
tar zxvf rocket.chat.tgz
mv bundle /opt/Rocket.Chat
mv bundle /opt/Rocket.Chat
Once Rocket.Chat has been downloaded and unpacked, we need to 'register' Rocket.Chat with NodeJS with NPM:
Once Rocket.Chat has been downloaded and unpacked, we need to 'register' Rocket.Chat with NodeJS with NPM:
cd /opt/Rocket.Chat/programs/server
cd /opt/Rocket.Chat/programs/server
npm install
scl enable nodejs010 'npm install'
Rocket.Chat has now been installed and you can test-drive you installation.
Rocket.Chat has now been installed and you can test-drive you installation.
db domains setprop chat.yourserver.com TemplatePath WebAppVirtualHost RequireSSL enabled ProxyPassTarget http://localhost:3000/ ProxyPreserveHost yes
db domains setprop chat.yourserver.com TemplatePath WebAppVirtualHost RequireSSL enabled ProxyPassTarget http://localhost:3000/ ProxyPreserveHost yes
To disable the default access on port 3000, for we now access our chat platform via the subdomain, and for security we close the default access method.
To disable the default access on port 3000, for we now access our chat platform via the subdomain, and for security we change the default access method from public to private.
config setprop rocketchat access private
config setprop rocketchat access private
signal-event remoteaccess-update
signal-event remoteaccess-update
Sync data: True
Sync data: True
Default domain: chat.yourserver.com (as per the subdomain)
Default domain: chat.yourserver.com (as per the subdomain)
Save the settings and use the test button to test the connection to the LDAP directory. Then 'Sync users'. For more specific details on Rocket.Chat and LDAP user authentication please see [https://rocket.chat/docs/master/admin-guides/ldap/ '''their documentation'''].
Save the settings and use the test button to test the connection to the LDAP directory. Then 'Sync users'. For more specific details on Rocket.Chat and LDAP user authentication please see [https://rocket.chat/docs/administrator-guides/authentication/ldap '''their documentation'''].
==Maintenance==
==Maintenance==
==TO DO==
==TO DO==
* Backup and how to manage Rocket.Chat data (e.g. mongodb and FS options)
* Backup and how to manage Rocket.Chat data (e.g. mongodb and FS options)
* Include the push server config for both Android and iOS
* Include the push server config for both Android and iOS
* Remove Rocket.Chat
* Remove Rocket.Chat
* Watch developments such as using PostgreSQL/MariaDB opposed to MongoDB
* Watch developments such as using PostgreSQL/MariaDB opposed to MongoDB
* Test, test, test
* Test, test, test
* Showcase SME Server, contribs and software collections.
* Showcase SME Server, contribs and software collections.
