Manually Installing a Pre-Built
  • 18 Oct 2024
  • Dark
    Light
  • PDF

Manually Installing a Pre-Built

  • Dark
    Light
  • PDF

Article summary

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
    Figure 1


  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
    Figure 2


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


    Figure 3: Download Artifact JSON File
    Figure 3


  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
    Figure 4


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


    Figure 5: Import Dialog
    Figure 5


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


    Figure 6: Browse File System
    Figure 6


  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
    Figure 7

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
Figure 8

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.


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.