Local installation for development

Most of this page is copied from the README.md file

Installation on fresh CentOS 8, CentOS 7 or Ubuntu 18.04 LTS (local installation)

This will setup a locally accessible IVIS instance (primarily for development and testing). All endpoints (trusted, sandbox, public) will provide only HTTP as follows:

• http://localhost:8080 - trusted endpoint
• http://localhost:8081 - sandbox endpoint
• http://localhost:8082 - api endpoint

1. Login as root. (We had some problems running npm as root on CentOS 7 on AWS. This seems to be fixed by the seemingly extraneous su within sudo.)

   sudo su -
   

2. Install GIT

   For CentOS 8 type:

   dnf install -y git
   

   For CentOS 7 type:

   yum install -y git
   

   For Ubuntu 18.04 LTS type

   apt-get install -y git
   

3. Download IVIS using git to the /opt/ivis-core directory

   cd /opt
   git clone https://github.com/smartarch/ivis-core.git
   cd ivis-core
   

4. Run the installation script.

   For CentOS 8 type:

   bash setup/install-centos8-local.sh
   

   For CentOS 7 type:

   bash setup/install-centos7-local.sh
   

   For Ubuntu 18.04 LTS type:

   bash setup/install-ubuntu1804-local.sh
   

5. Create file server/config/development.yaml and copy www and mysql configuration from server/config/production.yaml to server/config/development.yaml.

6. Start the server for development (or run start.sh).

   cd server
   NODE_ENV=development node index.js
   

7. Compile the client.

   cd client
   npm run build
   

   Or use incremental compilation (recompiles when files update).

   cd client
   npm run watch
   

8. Open the trusted endpoint (like http://localhost:8080)

9. Authenticate as admin:test