Managing Components

You can use the Sun N1 Service Provisioning System software browser interface to manage components.

You can also use the command-line interface (CLI) to manage components. See Summary of Component CLI Commands. For detailed information about CLI commands, see the Sun N1 Service Provisioning System 5.2 Command-Line Interface Reference Manual.

The following pages in the browser interface include information about how to view and manage components:

• Components page. List components and add new components to the list. You can also access other component pages to view component details.

  • To see which components are already checked in to the repository, choose Components from the navigation menu.

  • To see details about a component, go to the Components page, click the name of the component you want, and view details on the Details page.

  • To create a component, see How to Create a Component.

  • To see where a component is installed, go to the component's Details page and click Where Installed.

• Details page. View detailed information about the component, such as its attributes and values. This page also provides information and buttons that enable you to manage the component.

  The information shown on the Details page depends on the component type of the component.

  • To edit a component, go to the component's Details page, click Edit, modify the component configuration on the Edit page, and click Check In. You can choose which version number to use, then click Continue To Check In.

  • To delete a component, see How to Delete a Component.

  • To rename a component, go to the component's Details page and click Rename. Specify the new name of the component and click Rename, or click Cancel if you do not want to rename the component.

  • To move a component to another folder, go to the component's Details page and click Move. Specify the name of the folder in which to move the component and click Move, or click Cancel if you do not want to move the component.

    ---

    Note –

    If you plan to move a component into a folder that does not yet exist, click New Folder in the Move Component window. This new folder inherits the permissions from its parent folder. After you click Create, the folder tree displays with the new folder selected. Click Move.

    ---

  • To edit the component's XML, go to the component's Details page and click Advanced Edit. Make the changes you want to the XML. To overwrite the current XML, click Check In. To create a new component based on the changes to the XML, click Check In As. Or, click Cancel if you do not want to change the component's XML.

  • To download the component's XML to your system, go to the component's Details page and click Download. Click OK to continue the download, or click Cancel to cancel. Specify the directory in which to download the component's XML and click Save, or click Cancel if you do not want to download the component's XML.

  • To modify the component's variable settings, go to the component's Details page and click Variable Settings. Click Create Set to create new variable settings, or click Import Set from Component to import variable settings from your system.

  • To see where the component is installed, go to the component's Details page and click Where Installed.

• Edit page. Change component attribute values. Note that all of the fields cannot be changed.

  The information shown on this page depends on the component type of the component.

How to Create a Component

Use this procedure to create simple and composite components.

Steps

1. From the navigation menu, choose Components.

   The Components page appears and lists the components that are already checked in.

2. (Optional) Click Change Folder and specify the folder that will contain the new component.

   A window appears where you specify the name of the folder in which to create the component.

   • If the folder exists, select the name of the folder, and click Change to Selected Folder.

     The Components page displays the list of components in the specified folder.

   • If the folder does not exist, create the folder.

     1. Specify the parent folder, and click New Folder.

        The Create New Folder window appears.

     2. Type the name of the new folder, and click Create.

        The new folder inherits its permissions from its parent folder. After you click Create, the folder tree displays with the new folder selected.

        ---

        Note –

        You cannot create multiple folder levels at one time. To create several nested folders, you must return to the Change Folder window and repeat steps A and B.

        ---

     3. After the folder is created, select the name of the folder, and click Change to Selected Folder.

        The Components page displays the list of components in the specified folder.

3. Type a name for the new component in the Component field, and click Create.

   The new component's Edit page appears.

4. Define the component.

   1. (Optional) Change the component's name in the Component field if necessary.

   2. Choose the component type from the Component Type drop-down menu.

      Some of the resulting fields might change to match those that are used by the component type that you selected.

   3. From the Platform Type drop-down menu, choose the platform type to which this component can be deployed.

   4. (Optional) Specify a label in the Label field.

   5. (Optional) Specify a description in the Description field.

   6. Supply other required information.

      The information that is required is based on the component type that you selected.

      If your component references other components, local names are created for each of the components that this component references.

   7. Click Check In.

      A window appears that reports that the provisioning system is checking in the component as Version 1.0.

5. Click Continue To Check In.

How to Clone a Variable Set

Variable set cloning allows for the creation of new variable sets based on existing variable sets, instead of from the default set.

The variable settings from previously checked in components can be downloaded to files and then imported. Select the Create Set link from the Create and Edit Variable Settings table of the components>details>variable settings page. The following selections are available from the page:

• Create Set link is used to create a new variable set. If selected, a new column will be added only if there were no previously created variable sets. The column is headed by a Set Name field that is awaiting input of a unique variable set name in which to store the component variable settings. The edit links are Save, Cancel, and Delete

• Import Set From Component link will import variable sets from other components

• Download All Sets link will download all variable sets

• Import Sets From File field, Browse, and Import links allow for the selected file to be uploaded and imported. New variables sets are created for the imported variables sets. No variable sets will be created on errors. On success, a message is sent in the session about the list of variable sets created. On error, an error message is sent in the session.

Steps

1. From the navigation menu under Application Deployment, choose Components.

   The components>[top] page appears and lists the components that are already checked in.

2. Select an already checked in component.

   The components>details page should appear.

3. Scroll down to the bottom of the page and select Variable Settings.

   The components>details>variable settings page should appear.

4. Click on the Download All Sets link..

   Export variable sets to a file (assuming that variable sets have been created already)..

5. Save the exported data.

   A window will pop up to ask for the file path to save the exported data. On some browers, if the exported data displays, the user has to use the browser menu to save the exported data (Choose File->SaveAs).

6. Click on Done when you finish exporting variable settings.

7. To use a cloned variable set, select Create from the components>[top] page.

   Create a new component and perform a check in.

8. Select the newly created component and click on Variable Settings.

9. Import Variable Sets

   • To import variable sets from another component, click on Import Set From Component. A popup window will be displayed to allow the user to select a component to import. Once selected, the variable sets in the import component will be imported if both have variables in common.

   • To import variable sets from a file, click on the Browse button at the bottom of the variable settings page to specify an import file. An example of an import file would be previously exported data, such as in Steps 4 and 5, then click on the Import link. The file content is uploaded, parsed and new variable sets are imported and created.

10. Click Done, and the newly created component has used cloned variable settings.

How to Delete a Component

Note the following restrictions before deleting a component:

• A component that is referred to by another component cannot be deleted.

• An installed component cannot be deleted until it has been uninstalled.

• A component that has been created by a plug-in cannot be deleted except by deleting the plug-in.

• The root component of a family cannot be deleted if non-root members of the family exist.

• A component cannot be deleted during a plan run because all delete operations and plan runs acquire a system lock that keeps those operations from running concurrently.

When a component is deleted, the installation records are also deleted. This applies only to a component that has been installed and uninstalled, so no user-visible change is noticeable. A resource that is associated with a component, if any, is deleted with the component. Any plans that were created by running a direct-run component procedure are also deleted. The plan history that installed the component is edited to indicate that the component the plan installed was deleted. Plan history itself is not removed.

Steps

1. From the navigation menu, choose Components.

   The Components page appears and lists the components that are already checked in.

2. Click Change Folder.

   A window appears where you specify the name of the folder from which to delete the component.

3. Specify the name of the folder, and click Change to Selected Folder.

   The Components page now lists the components in the specified folder.

4. Click the name of the component that you want.

   The Details page for that component appears.

5. Click Delete.

   A window appears that reports that the provisioning system is about to delete the component you selected.

6. Click Continue To Delete.

   Click Cancel if you do not want to delete the component.