test

Sun N1 Service Provisioning System 5.1 Plan and Component Developer's Guide

Creating Plans

You can create an generated plan, create a custom plan, or customize a generated plan.

The provisioning system can generate automatically a plan that consists of more than one direct-run component procedures. You can run this plan directly or save it for use as a template for more complex plans that you author in XML.

For deployments that involve the coordination of multiple components, multiple host sets, or both, write a plan and use the provisioning system XML schema to define operations. Such operations might include dependency checks and scripting that execute commands on an application console. Once the plan is written, you need to check it in to the plan repository.

ProcedureHow to Create Generated Plans

You create an generated plan from a component's Details page.

Before You Begin

To create a generated plan, you must belong to a user group that has Create, Edit, and Delete permission on the folder that contains the component for which you want to generate a plan.

Steps

  1. From the navigation menu, choose Components.

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

  2. If necessary, change folders so that you can view the component that you plan to deploy.

    1. Click Change Folder.

    2. Specify the name of the folder that contains the component, and click Change to Selected Folder.

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

  3. In the table listing components, find the row describing the component you would like to deploy, and click Details.

    The component's Details page displays.

  4. In the Component Procedures table, select each procedure to include in the plan.

  5. In the bottom row of the Component Procedures table, click Generate Plan With Checked Procedures.

    The generated plan's Advanced Edit page appears.

  6. In the Plan field, type the new plan's name.

  7. Click Check In.

    Note –

    You might see this message: Warning - plan names and/or paths differ. This message indicates that you specified a plan name that is different from the plan name specified in the XML model. The XML model is updated according to what you type in the plan name field.

  8. Confirm the component check-in.

    1. Verify that you specified the correct plan name.

    2. If necessary, select the component's new version number.

    3. Click Continue to Check In.

    The new plan's Details page appears.

ProcedureHow to Create a Custom Plan

You can create a plan by using a schema-validating editor, such as TurboXML, or on the Advanced Edit page of the browser interface.

This procedure describes how to import a plan that you have written by using an XML editor.

Steps

  1. Write a plan.

    See the XML schema elements described in Chapter 2, Shared Schema Used by Components and Simple Plans, in Sun N1 Service Provisioning System 5.1 XML Schema Reference Guide and Chapter 4, Plan Schema, in Sun N1 Service Provisioning System 5.1 XML Schema Reference Guide.

  2. Launch the browser interface and go to the Plans page.

  3. (Optional) Click Change Folder and specify the folder that will contain the new plan.

    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 Plans page displays the list of plans 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 Plans page displays showing the list of plans in the specified folder.

  4. Type the name and brief description for the plan that you want to create, and click Create.

    The Advanced Edit page for the plan appears.

    The provisioning system creates an XML skeleton for the plan.

  5. In the Plan Definition field, do the following:

    • Enter the XML for the plan.

    • To import a plan that is stored on your local system, type the full path name of the file or click the Browse button. Then, click Replace.

  6. Click Check In.

    A window appears that tells you that you are about to check in a plan. The plan is assigned Version 1.0.

  7. Click Continue To Check In.