3.2.2 EMCD

EMCD

The RCS API responsible for serving the clients. Its configuration files are stored in the config files located at /var/www/emcd/ directory. The RCS functions related settings are in the AppSettings.config file. The database connections are defined in the DataBase.config file.

Changes made in these files require the Apache restart. To do it use the following command:

service apache2 restart

Database access

EMCD requires access to the following database schemas:

• api
• storage
• voipswitch

Connection strings for each schema have to be added to the DataBase.config. Below is an example.

<connectionStrings>

  <clear/>

  <add name="vps" connectionString="Server=192.168.1.2;

                         Database=voipswitch;

                         User ID=root;

                         Password=p455wrty;

                         Connection Timeout=60;

                         Pooling=true;

                         Min Pool Size=0;

                         Max Pool Size=100;

                         Connection Lifetime=0;

                         Connection Reset=true;

                         Old Guids=true"

  />

  <add name="api" connectionString="Server=localhost;

                         Database=api;

                         User ID=root;

                         Password=p455w0rD;

                         Connection Timeout=60;

                         Pooling=true;

                         Min Pool Size=0;

                         Max Pool Size=100;

                         Connection Lifetime=0;

                         Connection Reset=true;

                         Old Guids=true"

  />

  <add name="storage" connectionString="Server=localhost;

                         Database=storage;

                         User ID=root;

                         Password=p455w0rD;

                         Connection Timeout=60;

                         Pooling=true;

                         Min Pool Size=0;

                         Max Pool Size=50;

                         Connection Lifetime=0;

                         Connection Reset=true;

                         Old Guids=true"

  />

</connectionStrings>

Apache configuration

The web server used by the RCS platform is by default Apache2. Its configuration files are located at /etc/apache2/ directory.

The web server should be listening on port 81. The port is set in the /etc/apache2/ports.conf
Listen 81.

In the main configuration file apache2.conf the following section has to be present:

<Directory /var/www/>

 <------>Options Indexes FollowSymLinks

 <------>AllowOverride All

 <------>Require all granted

 </Directory>

SSL

Communication from the RCS clients to the EMCD API is encrypted using SSL. The SSL certificate files are located at /etc/apache2/ssl directory. Their names are based on the domain name used for the project:

domain.ca-bundle.crt
domain.key
domain.crt

The certificate can be provided by you but by default for new installation we use a wild card certificate for the domain *.hstsrv.net 

Communication with clients (system commands)

The EMCD API uses SIP MESSAGE requests to convey various commands to the RCS clients. Therefore the EMCD has to have an access to both VSServices API over https and voipswitch’s SIP listener. In order to check the SIP connectivity you can use telnet command from the EMCD linux server and try to connect to the IP address and port of the voipswitch SIP UDP listener. Please note that even though the clients use TLS for the internal communication we use SIP over UDP on the default port 5060. If connection fails you need to check your network settings (firewall) and voipswitch logs if it shows the UDP listener as started on the required IP and port.

The format of the body of the messages containing commands are the same regardless of the protocol used. In the case of http the EMCD sends http request with the body and recipient’s URI to the VSServices which in turn converts the message to SIP MESSAGE request. In the case when EMCD sends the message over SIP it is already in the SIP MESSAGE format.

At the moment EMCD uses VSServices for sending some types of system messages. This however will be deprecated in future and replaced fully by the SIP protocol.

The entry for the VSServices has to contain the valid URL and the username and password of the account used for system communication. 

Below is the entry for the SIP communication.

The account used by EMCD has to be created in voipswitch.clientsshared table. You should use the VSM and add new account in the Retail clients menu. Make sure that the assigned tariff contains allowed prefixes with zero rates so the account will not run out of money.