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.1 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 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, and click Rename.

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