test

Sun N1 Service Provisioning System 5.2 Operation and Provisioning Guide

Managing Component Deployment

Deploying components with the help of plans can often take a significant amount of time. To provide visibility into the process of deploying components, you can monitor plans and view information about running or completed plans. You can also stop a plan in the middle of a deployment.

ProcedureHow to Run a Plan

This procedure describes how to run a plan by using the browser interface. You can also run plans by using the following command.

For a detailed description of this command, see Chapter 11, pe: CLI Commands for Running Plans, in Sun N1 Service Provisioning System 5.2 Command-Line Interface Reference Manual.

Before You Begin

Ensure that you have the installation information that will allow you to set the plan's variable settings.

To run a plan, you must belong to a user group that has Allow on Host Set permissions in the folder that contains the plan you need to run.

Steps

  1. Go to the plan's Details page.

  2. Click Run.

    The plan's Run page displays.

  3. In the Plan Parameters area, select the variable settings for the component you plan to deploy.

    • If the variable settings have been established for this component, select the appropriate settings from the menu.

      To view the current variable settings for this component, click Select From List. The current variable settings are displayed in the Select Variable Settings From List window.

    • If the settings are not available from the menu, click Select From List.

      The Select Variable Settings From List window displays.

      • If you want to use another component's variable settings, click Import Set From Component.

        The Import Variable Settings window displays.

        1. If necessary, navigate to the Folder that contains the component with the variable settings you want to import.

        2. Select the component version.

          Note –

          Variable settings can vary between component versions. Ensure that the current components and the component from which you want to import variable settings share common variables. If the component from which you want to import variable settings does not share common variables with the component you want to use in your plan, the variable settings are not imported.

        3. Click Import Variable Settings.

          The variables settings are imported, and are displayed in the table.

        4. On the Plan Details Run page, select the variable settings that you imported from the Variable Settings drop-down list, then click Select.

      • If you want to use component variable settings that are stored in a file, follow these steps.

        1. In the Import Sets from File text field, enter the path to the variable settings file that you want to use.

          To browse through the file system to find the appropriate file, click the Browse button.

        2. Click Import.

          The variables settings are imported, and are displayed in the table.

          Note –

          If the file from which you want to import variable settings does not share common variables with the component you want to use in your plan, the variable set is not imported.

        3. On the Plan Details Run page, select the variable settings that you imported from the Variable Settings drop-down list, then click Select.

      • If you want to create new variable settings, select Create Set.

        The Select Variable Settings From List window displays.

        1. In the text field at the top of the table, enter the name of the new variable settings set.

        2. Select the component variable you want to change.

          The table cell is highlighted and a text field appears.

        3. Type the new component variable value.

          Note –

          The value for the installPath variable is treated as a relative path to the default Remote Agent directory, unless you specify an absolute path, such as /opt or c:\mydir. For example, for a Windows Remote Agent, if you set the installPath variable to c\mydir and deploy the file to an Agent with a default home directory of c:\Program Files\N1 Service Provisioning System\agent, the file is deployed to c:\Program Files\N1 Service Provisioning System\agent\c\mydir.

        4. After updating the variable settings values, click Save.

          The new variable settings display in the table.

        5. Click Select.

  4. Select where you plan to deploy the component.

    • To select a host, use the Target Host text field to type a host's name or click Select from List.

    • To select a target host set, use the Target Host Set menu.

  5. In the Plan Variables area, configure the variables you want to set.

    Whether there are variables to configure depends on the contents of the plan.

  6. In the Options area, select whether you want to perform a detailed preflight.

    The detailed preflight attempts to simulate every step of the plan that will run on the remote agent. The detailed preflight tests the following functions.

    Running a detailed preflight increases the amount of time preflight takes.

  7. (Optional) To limit the number of hosts running at the same time, type the number of hosts in the field provided.

    When a plan is run against several hosts simultaneously, all hosts must complete a step before any host can progress to the next step. If the number of hosts is too high, the network connection can time out between steps. For example, the time between Host A finishing step 1 and being pinged for step 2 might be too long and cause the network connection to time out.

  8. (Optional) To limit the overall running time of a plan or limit the running time of native calls, type a number in the fields provided, and then select the time unit, such as minutes, from the menu.

    By limiting the run time of a plan or native call, you prevent a non-responsive host from tying up the progress of a running a plan.

    If you set up a notification rule to alert you to plan failures, when the plan times out you will be notified that the plan was unsuccessful.

    For information on setting up notification rules, see Configuring Email Notification in Sun N1 Service Provisioning System 5.2 System Administration Guide.

  9. Select whether you want to deploy the component.

    • To run just the preflight test of the procedure, click Run Preflight Only.

    • To run the preflight test and then (assuming the preflight test finds no errors) to run the procedure itself, click Run Plan (Includes Preflight).

ProcedureHow to View the Progress of a Plan

This procedure describes how to view the progress of a plan by using the browser interface. You can also view a plan's history by using the following commands.

For a detailed description of these commands, see Chapter 11, pe: CLI Commands for Running Plans, in Sun N1 Service Provisioning System 5.2 Command-Line Interface Reference Manual.

Steps

  1. In the navigation menu, expand the Application Deployment category and click Run History.

    All running and completed plans and preflight checks are listed. A running plan is indicated by a timestamp in the Completed column. The timestamp is the time at which the plan run was initiated.

  2. To view the details about a particular plan, click Results.

    By selecting the Details, Preflight, or Deployment icons, you can toggle between the plan details, the results of the preflight, and the results of the deployment.

    The Details page shows the following information.

    • Target host

    • Variable settings used for the plan's parameters

    • Limits imposed on the plan

    • User who ran the plan

ProcedureHow to Stop a Running Plan

This procedure describes how to stop a plan by using the browser interface. You can also stop plans by using the following command.

For a detailed description of this command, see Chapter 11, pe: CLI Commands for Running Plans, in Sun N1 Service Provisioning System 5.2 Command-Line Interface Reference Manual.

Before You Begin

To stop a plan, you must be either the user that started the plan or a member of the admin user group.

Step

    Cancel the running plan.

    • From the Run Deployment page, click Cancel Plan.

      The Run History page displays a message stating that the plan was cancelled by a user.

    • From the Run History page, determine the plan you want to stop.

      1. In the Action column, click Progress.

        The Run Deployment page displays.

      2. Click Cancel Plan.

ProcedureHow to Delete a Plan

This procedure describes how to delete a plan that was not generated from a component by using the browser interface.

Note –

There is no need to delete the plans generated from direct-run component procedures. These plans are automatically removed from the system when the component from which they were generated is deleted. For more information, see How to Delete a Component in Sun N1 Service Provisioning System 5.2 Plan and Component Developer’s Guide.

You can also delete plans by using the following command.

For a detailed description of this command, see Chapter 11, pe: CLI Commands for Running Plans, in Sun N1 Service Provisioning System 5.2 Command-Line Interface Reference Manual.

Before You Begin

To delete a plan, you must either be the user that created the plan or a member of the admin user group.

Steps

  1. Go to the plan's Details page.

  2. Click Delete.

    You are asked to verify that you want to delete the plan.

  3. Click Continue to Delete.

    After the plan has been deleted, the Plan table no longer displays the plan.