Setting up an mSign server

From Scriptel Wiki
Revision as of 08:45, 2 June 2017 by John Powers (talk | contribs)
Jump to navigation Jump to search

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. Place the package in /var/cache/apt/archives

   sudo mv scriptel-msign-*-all.deb /var/cache/apt/archives
sudo chown root:root /var/cache/apt/archives/scriptel-msign-*-all.deb

3. Install PostgreSQL

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

4. Configure PostgreSQL for TCP login by editing /etc/postgresql/X.X/main/pg_hba.conf

5. Find the line that says

   host    all             all             127.0.0.1/32            peer

6. Replace 'peer' with 'md5'. Save and exit the file.

7. Restart PostgreSQL

   sudo service PostgreSQL restart

8. Start commandline PostgreSQL

   sudo -u postgres psql

9. type

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

10. Start the install of mSign server

   sudo apt-get install -f scriptel-msign-1.0.37-all.deb

11. Create the schema

   sudo -u scriptel-msign node /usr/lib/scriptel-msign/msign-util.js -i

12. Create the user

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

13. Create an organization

   sudo node /usr/lib/scriptel-msign/msign-util.js -o organization

14. Assign the user to the organization

   sudo node /usr/lib/scriptel-msign/msign-util.js -a guy@email.com:organization