ServiceNow Installation Instructions

This guide will walk you through all the steps to install the ServiceNow addon.

To install the add-on:

1. First get the addon from the portal. You can view all the available addons for your plan here: https://portal.securityroots.com/addons.
2. Then, unpack the zip file. It should contain some .gem files and a Gemfile.plugins file that you'll need for the installation.
3. SSH into the box as dradispro
4. Copy the .gem files to /opt/dradispro/dradispro/shared/addons/cache/ (create the directory if it doesn’t exist)
5. Copy the .yml files (if any) to /opt/dradispro/dradispro/shared/addons/config/
6. Copy the .rb files (if any) to /opt/dradispro/dradispro/shared/addons/initializers/
7. Append the contents of the Gemfile.plugins file to the Gemfile.plugins under /opt/dradispro/dradispro/current
8. Symlink files:

   $ cd /opt/dradispro/dradispro/current/vendor/cache/
   $ ln -s /opt/dradispro/dradispro/shared/addons/cache/*.gem ./

9. If you copied over .yml files to /opt/dradispro/dradispro/shared/addons/config/, run the following:

   $ cd /opt/dradispro/dradispro/current/config/
   $ ln -s /opt/dradispro/dradispro/shared/addons/config/*.yml ./

10. If you copied over .rb files to /opt/dradispro/dradispro/shared/addons/initializers/, run the following:

    $ cd /opt/dradispro/dradispro/current/config/initializers/
    $ ln -s /opt/dradispro/dradispro/shared/addons/initializers/*.rb ./

11. Install the plugins and compile:

    $ cd /opt/dradispro/dradispro/current/
    $ RAILS_ENV=production bundle install --local --without development test
    $ RAILS_ENV=production ./bin/rails assets:precompile

12. Configure the add-on and follow the instructions:

    $ RAILS_ENV=production ./bin/rails generate dradis:plugins:servicenow:install

13. Re-start the app process:

    $ god restart

Confirm that the installation has completed by visiting the Add-ons > Ticketing - ServiceNow link and allowing the ServiceNow permissions.

That should get you up and running with the ServiceNow addon. If you're running into issues, please contact our support team and let us know!