Creating and viewing package or repository instances

This topic provides information about creating instances for a package or a repository.

Before you begin
To create a package or repository instance
To view an instance
To view a list of package or repository instances
To modify or delete instances
Where to go from here

Before you begin

Before you can create or deploy a package (or repository) instance, you must have already created a package (or repository) definition. For more information about creating a package or a repository, see:

To create a package or repository instance

Click the Deploy tab.
From the left menu, select Packages or Repositories as appropriate.
Click New Instance next to the package (or repository) for which you want to create an instance.
Enter a name in the Instance Label box to identify the instance (a default name is automatically suggested).
Specify whether the instance is locked by selecting the appropriate option from the Locked box.
If you want to modify the set of contents for this instance, change the state associated with each package reference under the Content tab.
Click Create.
If the deployment is queued prior to the instance being ready, you can immediately deploy the new instance.
Note
No deployment activity occurs until the instance has completed construction and is ready to be deployed. If a deployment is queued and the instance creation fails, the deployment also fails.

To view an instance

To view detailed information for an instance, navigate to the Deploy > Package page or the Deploy > Repositories page as appropriate and use one of the following options:

Click the instance name that is displayed as a link under the package or repository.
For an instance, in the associated Actions menu at the right side of your screen, click View.

The instance detail view has these sections:

Instance detail view section	Description
Summary	Details the high-level information about the instance, the package to which it belongs, when it was created, the deployment route, the instance status, whether the instance is locked or not, and the role to which this instance is assigned.
Content	Identifies each piece of content that is stored by the instance, as well as high-level details for each piece of content, including its URI, archived size, and table of contents. If the archived content is less than 8 KB in size, you can view an extract of the content.
Properties	Identifies the set of properties associated with the instance, which represent a snapshot of the package properties when the instance was created
Config	Displays any configuration data associated with the instance.
Log	Contains a record of the activity of the instance, including its content population, as well as authorization and restart events
Processes	Provides information about the processes associated with that repository instance. This information is only available in case of a repository instance.

To view a list of package or repository instances

Click the Deploy tab.
From the left menu, select Packages or Repositories as appropriate.
Click the name of a package or repository to view all the instances added for that package or repository.
You can see summary information about the package and each instance. Click the instance name to view the instance details.

The following table describes the potential actions that are available for each instance:

Action	Description
Deploy	Initiates a deployment of the instance. The Deploy pane has a menu of all available deployment environments.
View	Displays the instance detail pane
Lock	Locks the instance to prevent deletion by the automatic cleanup mechanism
Unlock	Unlocks the instance to enable deletion on the expiration date (default is 30 days)
Role	Edits the role(s) that are allowed to access the instance. For more information, see Enabling-role-based-access-permissions-for-an-instance.
Recreate	Recreates the instance content. All existing content associated with the instance and all deployment records associated with the instance are destroyed. The instance is recreated from the package content references.
History	Generates a report showing the deployment history for an instance
Delete	Deletes the instance and purges all its deployment records from the system

To modify or delete instances

Click the Define tab.
On the left menu, click Instancesto see a list of instances created. Perform one of the following actions as appropriate:
1. To modify an instance, click an instance name that appears as a link under the Instance column to open it and then modify the settings available.
2. To delete an instance, click the Delete link on the Actions menu available at the right side of your screen (in line with the instance that you want to delete).
  Note
  You can modify or delete an instance only in the following situations:
  - The instance is not yet deployed.
  - The instance is not locked.

Where to go from here

Deploying-an-instance