Installing Adapters
  • Dark
    Light
  • PDF

Installing Adapters

  • Dark
    Light
  • PDF

Installing Adapters in IAP (Optional)

IAP uses network and OSS adapters to facilitate the integration of IAP with various systems and applications. To add a new adapter to IAP, the adapter must be installed under node_modules within the IAP installation directory.

From the npm registry

The following steps demonstrate installing the adapter, from the npm registry and in its package form.

cd /opt/pronghorn/current

# Install "latest".
npm install @itentialopensource/adapter-db_mongo

# Install, or upgrade, a specific version.
npm install @itentialopensource/adapter-db_mongo@1.2.3

From source

Alternatively, an adapter may be installed from source.

cd /opt/pronghorn/current/node_modules/@itential
git clone git@gitlab.com:itentialopensource/adapters/persistence/adapter-db_mongo
cd adapter-db_mongo
npm ci

When you must upgrade, or change versions of an adapter, perform the following steps.

cd /opt/pronghorn/current/node_modules/@itential/adapter-db_mongo
git checkout master
git pull

# If you need to see a list of all the tags/version numbers: `git tag`.

git checkout <your desired version number>
git pull
rm -rf node_modules
npm ci

Instantiate the adapter

Once the adapter is installed, restart IAP and the adapter will be auto-discovered during IAP startup and become available when adding an adapter via the IAP UI.

To add an available adapter to IAP:

  1. Login to IAP and select Admin Essentials in the left navbar.

Figure 1: Admin Essentials

03-IAP-Home

  1. Click the plus (+) sign in the top toolbar of the Admin Essentials application to open the Create dialog.
  2. Select Adapter from the dropdown menu, enter the desired name of the adapter and select the type, and then click Save.

Figure 2: Create Adapter
04-createAdapter

  1. A skeleton JSON object of the Service Configuration for the adapter will be created and can be edited to match your environment by enabling the Service Config editor using the toggle switch (top-right).

Figure 3: Adapter Configuration

05-adapterProperties

  1. Click the Save button to retain your config changes for the adapter.

Figure 4: Save Config

06-adapterConfig

  1. The adapter will display under the Adapters menu in the left navbar, and from the Adapters collection view when you click the search icon (magnifying glass) in the top toolbar and select the Adapters tab.

Figure 5: Adapters Collection
07-adaptersCollectionView

  1. Adapter connectivity can be confirmed from the Admin Essentials home page in the Alerts dashboard.

Figure 6: Alerts

04_Alerts

Import the service config for an adapter

Itential enables you to build your own custom adapters to integrate specific network applications with IAP. Use the following steps to import the service config for your custom adapter.

From the Admin Essentials home page:

  1. Click the Import icon in the top toolbar to display the Import dialog.
  2. Select Adapter from the dropdown.
  3. You can import (upload) your Adapter file by drag-and-drop, or click Browse Files to find and select the Adapter you want to import.

Figure 7: Adapter Import
05_adapterImport

  1. Once the Adapter is imported, the name of the Adapter will pre-populate from the file, along with a description, in the Import modal. You can change the description, as needed, to provide specific information for your import and to better communicate what the adapter is used for within your platform.
  2. Once you click the Import button, and upon successful import, the Adapter will be added to the collection list in the left sidebar.

Figure 8: Adapters Collection
06_adaptersCollectionList

Additional information on adapters