Setting up an mSign server

This guide is for administrators in organizations who have purchased an mSign server license. Scriptel provides a public server for public use free of charge at msign.scriptel.com. However, this requires internet connectivity and is shared. Organizations may wish to use their own server behind their firewall.

mSign Sever is designed to run on an Ubuntu 16.04 server. It is written node.js, so technically it is possible to make it run on any platform that supports node. However, all of the scripts for installing are written for Ubuntu and that is all we are currently supporting.

mSign Server requires connection to a PostgreSQL database. This can live on the local machine or elsewhere. These instructions will assume it lives on the local system.

Steps:

1. Obtain the scriptel-msign-x.x.xx-all.deb package and license file from Scriptel

2. Obtain a server with Ubuntu 14.04 on it.

3. Install PostgreSQL

   sudo apt-get update
   sudo apt-get install postgresql postgresql-contrib

4. Start command line PostgreSQL

   sudo -u postgres psql

5. type, changing the password 'secret' to a reasonable password.

   CREATE USER "scriptel-msign" WITH PASSWORD 'secret';
   CREATE DATABASE "scriptel-msign" WITH OWNER 'scriptel-msign';
   \q

6. Start the install of mSign server

   sudo apt-get install -f ./scriptel-msign-*-all.deb

7. Take the default answers, except password. Make the password the same as in step 5.

8. Create the user

   cd /usr/lib/scriptel-msign
   sudo -u scriptel-msign node msign-util.js --create-user=guy@email.com:guysPassword

9. Create an organization

   sudo -u scriptel-msign node msign-util.js -o organization

10. Assign the user to the organization

   sudo -u scriptel-msign node msign-util.js -a guy@email.com:organization

11. If the directory /usr/lib/scriptel-msign/licenses does not exist, create it.

   sudo -u scriptel-msign mkdir licenses

12. License the server. This assumes that Scriptel has granted you a license. If not, this step will fail. This is the portal username and password, which may be different than one created earlier.

   sudo -u scriptel-msign node msign-util.js --download-licenses guy@email.com:guysPassword

13. Start the service

   sudo service scriptel-msign start

14. Make the service start on reboot

   sudo systemctl enable scriptel-msign.service