Manually Installing a Pre-Built

Manual Install Process

This article explains how to install Itential Pre-builts manually when your Internet connection is down and not available from IAP.

1. Navigate to the Itential Pre-builts web page at https://www.itential.com/pre-built-collection/ and click the GitLab icon to be redirected to where the pre-built is located.

   
   

   Figure 1: Itential Pre-built Collection
   

   
   

2. From the pre-built (e.g., https://gitlab.com/itentialopensource/pre-built-automations/ansible-port-turn-up), click artifact.json to open the file.

   
   

   Figure 2: Select Artifact JSON File
   

   
   

3. Click the Download icon to save the file to your local drive.

   
   

   Figure 3: Download Artifact JSON File
   

   
   

4. Navigate to Admin Essentials within IAP and click the import icon in the top toolbar to open the Import dialog.

   
   

   Figure 4: Admin Essentials
   

   
   

5. Select "Pre-built" in the dropdown list to open the Import modal.

   
   

   Figure 5: Import Dialog
   

   
   

6. Select "click to browse" and navigate to the artifact.json file saved to your local drive.

   
   

   Figure 6: Browse File System
   

   
   

7. Select the artifact.json file you downloaded. A preview of the pre-built ReadMe will display.

    Note: There may be additional dependencies that are required. The Readme file for the pre-built will explain if there are additional prerequisites or requirements for the install.

8. Click the Import button to install the pre-built and its associated artifacts. Once the pre-built is installed, it will be loaded into IAP.

   
   

   Figure 7: Pre-Built ReadMe
   

Troubleshooting

If IAP determines that a dependency is not installed you will see a warning banner and most likely will not be allowed to install the pre-built until the prerequisite is satisfied.

Figure 8: Warning Banner

If you experience any issues with an Itential Pre-built, please contact the Pre-builts Team by opening a service desk ticket via the Customer Portal.