How do I install an artifact bundle?

Purpose

Use this procedure to install a bundle of artifacts using the NSP Artifact Bundles view. The artifact bundle must be compatible with the Artifacts views; see Table 2-1, Artifacts supported for installation using the NSP Artifacts views. For installation of adaptors for model-driven NE management, see “How do I install adaptor artifacts that are not supported in the Artifacts view?” in the NSP System Administrator Guide.

Installing new versions of artifacts

It is not necessary to uninstall artifact bundles before installing new versions.

If you install a bundle containing a new version of an artifact that is already installed in Artifacts, the new version is handled according to the version control policy of the target application. In many cases, the old version of the artifact remains in Artifacts, its status is changed to Obsolete, and the status of the bundle is changed to Partially Installed.

If you are installing a bundle whose contents may supersede artifacts you are using, such as an NSP service pack, ensure that you have performed any required backups; see Version management best practices.

Selective installation

Selective installation and uninstallation is available for some artifact bundles. With selective installation you can choose which artifacts in a bundle to install or uninstall. For example, you can install only the intent types you currently need.

Choose a bundle in the Artifacts, Artifact Bundles view to see the availability in the Artifact Bundle Details panel.

If selective installation/uninstallation is not available for a bundle, installation and uninstallation can only be performed on the entire bundle.

Importing and installing

There are three stages to installing an artifact bundle:

  1. Obtain the artifact bundle from the Nokia NSP software download site and store it to your local system in .zip file format; see Obtaining artifacts.

  2. Import the artifact bundle in the Artifacts views.

    Importing an artifact bundle transfers it from your local system to the NSP.

  3. Install the artifacts in the artifact bundle.

    You can install the entire bundle at once, or, if selective artifact installation/uninstallation is available, choose one or more artifacts to install.

    When the bundle is installed, the contents of the zip file are extracted and made available to their target applications.

You can install a bundle at the time you import it, or later.

As the installation process completes for each artifact, the artifacts are added to the Artifacts, All Artifacts view. When the automatic reconcile operation occurs next, NSP checks the status of all artifacts, updates the artifact bundle status if possible, and retries any failed installations.

Before you begin

Before you begin, the artifact bundle must be downloaded from the Nokia NSP software download site and stored to your local system in .zip file format; see Obtaining artifacts.

Steps
 

Open Artifacts, Artifact Bundles.


Click Import & Install.


In the form that opens, drag and drop up to 10 zip files, or click Browse and navigate to the files on your system.


To install all artifacts in the artifact bundle immediately, click Import & Install. To import without installing, click Import.

The chosen operation is triggered immediately. The artifact bundle status is updated to Imported or Installed when NSP has confirmed the status of all artifacts in the artifact bundle.


To install the contents of a bundle in Imported status:

  1. To install all artifacts in the bundle, choose Install bundle from the png1.png (Table row actions) menu.

  2. If selective installation is available for the bundle, choose artifacts to install:

    1. Select a bundle and choose View artifacts from the png1.png (Table row actions) menu.

    2. In the Artifact List, select an artifact or Ctrl+click to select multiple artifacts.

    3. Choose Install from the png1.png (Table row actions) menu.

      Note: if the files list icon (png2.png) appears instead of png1.png (Table row actions), selective installation of artifacts is not available for the bundle.

The artifact bundle status is updated when NSP has confirmed the status of all artifacts in the artifact bundle.

End of steps