linagora.esn.chat

Chat component for OpenPaaS ESN.

WARNING: THIS FEATURE IS DEPRECATED

It will not receive any future updates or bug fixes. It will be removed from OpenPaaS in version 1.9.0.

Install

Note: The following instructions assumes that you have already installed OpenPaaS ESN in the path referenced by $ESN below.

While waiting for a npm-based dependency injection handler, you have to install the Chat and Emoticon components in OpenPaaS ESN like this:

1. Clone linagora.esn.chat and linagora.esn.emoticon

Clone the linagora.esn.chat and linagora.esn.emoticon repositories.

git clone https://ci.linagora.com/linagora/lgs/openpaas/linagora.esn.emoticon.git
git clone https://ci.linagora.com/linagora/lgs/openpaas/linagora.esn.chat

Go inside OpenPaaS ESN repository:

cd $ESN
npm install
npm link

Go inside linagora.esn.emotion folder and run:

npm install

Go inside linagora.esn.chat folder and run:

npm link linagora-rse
npm install

2. Add the modules in the OpenPaaS ESN configuration file

You must add "linagora.esn.emoticon" and "linagora.esn.chat" in the modules section in $ESN/config/default.NODE_ENV.json. NODE_ENV is the environment variable used to define if the node application is running in 'production' or in 'dev' (the default environment is 'dev'). Copy the 'modules' array from $ESN/config/default.json into $ESN/config/default.NODE_ENV.json ($ESN/config/default.dev.json or $ESN/config/default.production.json) and add the "linagora.esn.emoticon" and "linagora.esn.chat" items:

"modules": [
  "linagora.esn.core.webserver",
  "linagora.esn.core.wsserver",
  "linagora.esn.emoticon",
  "linagora.esn.chat"
],

3. Create symbolic links

The modules must be available in the $ESN/modules folder:

cd $ESN
ln -s path_to_emoticon modules/linagora.esn.emoticon
ln -s path_to_chat modules/linagora.esn.chat

Run

Once installed, you can start OpenPaaS ESN as usual. The Chat module is available in the application grid menu.

Run in Docker

1. Run OpenPaaS

Pull docker containers and start them using docker-compose as described in the OpenPaaS documentation.

cd $ESN
docker-compose -f ./docker/dockerfiles/platform/docker-compose-images.yml pull
ESN_PATH=$PWD PROVISION=true ESN_HOST=192.168.1.17 DOCKER_IP=127.0.0.1 docker-compose -f ./docker/dockerfiles/platform/docker-compose-images.yml up

2. Add emoticon and chat dependencies to OpenPaaS

• Connect to the esn container

docker exec -it esn bash

• Clone emoticon repository, then install dependencies

cd /var/www/modules
git clone https://ci.open-paas.org/stash/scm/om/linagora.esn.emoticon.git
cd linagora.esn.emoticon
npm install --production
bower install --production --allow-root

• Clone chat repository, then install dependencies

cd /var/www/modules
git clone https://ci.open-paas.org/stash/scm/om/linagora.esn.chat.git
cd linagora.esn.chat
npm install --production
bower install --production --allow-root

• Add the modules in the configuration

apt-get update
apt-get install vim
vi /var/www/config/default.json

Then add chat and emoticon modules in the modules list

"modules": [
  "linagora.esn.core.webserver",
  "linagora.esn.core.wsserver",
  ...
  "linagora.esn.emoticon",
  "linagora.esn.chat"
],

3. Restart the ESN container

The ESN must be restarted to take new modules into account, from your terminal:

docker restart esn