Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WSO and version V1
Scroll ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue
#F0F0F0#F0F0F0

3

truetruetruetrue

Scripts are the set of commands which are written to accomplish a specific task. Scripts can be written in multiple languages like PowerShell, Perl Python etc. Published scripts will be available to create the Orchestration Workflow.

To configure a new Orchestration Script:

  1. Select Script Configurations. The Script Configurations list page is displayed.
  2. On the Script Configurations list page, click on + icon to configure a new script. For more information on the fields of Script Configurations list page, see, Field Description.
  3. Select the Script Language.
  4. Click Load Parameters, after specifying the script. Specify other required fields in Script Configurations details page. For more information on the fields of Script Configurations details page, see, Field Description.
  5. Click Submit. A new Orchestration Script  is configured.

To update an existing Orchestration Script:

  1. Select Script Configurations. The Script Configurations list page is displayed.
  2. On the Script Configurations list page, select the specific script to edit or view the script. For more information on the fields of Script Configurations list page, see, Field Description.
  3. Click Load Parameters, after specifying the required parameters of the script. For more information on the fields of Script Configurations details page, see, Field Description.
  4. Click Submit. The orchestration's script's configurations are updated.
Image Removed

Figure:  Script Configurations List Page

Field Description AnchorListPageListPageOrchestration Scripts need to be configured so that Analysts can execute the scripts on the Configuration Items (CIs). The configured scripts are used in Orchestration. As an Administrator, you need to configure the scripts, specify target platform, and add commands that need to be executed through the script. You need to run the ‘Incident Smart Action’ job in the Custom Scheduler. This option is useful for issuing operational commands as well (besides diagnostic ones), such as restarting processes, changing supervisor parameters, and so on.

To configure Orchestration Scripts:

  1. Select Orchestration > Script Configuration. The SCRIPT CONFIGURATION page is displayed.
  2. On the SCRIPT CONFIGURATION page, specify all the fields to configure a new script.
  3. Click LOAD PARAMETERS, after specifying the script. 
  4. Click SUBMIT. A new Orchestration Script  is configured.

    Image Added

    Figure:  SCRIPT CONFIGURATION page

Field Description

The following table describes the fields on the Script Configurations list SCRIPT CONFIGURATION page:

Fields

Description

General

Script Name

Displays

Type in the

script

Orchestration Script name.

Status
DetailsPage

The following table describes the fields on the Script Configurations list page:

Fields

Description

Script
Category 

Displays the status of the script.

Category

Displays the category of the script.

Right click on icon and the following options are displayed:

  • Sort (A to z)
  • Sort (Z to a)
  • Group by Column

Check the Group by Column check box to group the categories. Uncheck the Group by Column check box to un-group the categories.

Script Language

Displays the script language.

Created By

Displays the name of the user who has created the script.

Last Updated By

Displays the name of the user who has last updated the script.

Last Updated Date

Displays the date on which the script was last updated.

Created Date

Displays the date on which the script was last created.

Description

Displays the description of the script.

Image Removed

Click this icon to add a new script.

Image Removed

Click this icon and select one the of following options:

  • Export to Excel – To export the all the listed script configurations to Microsoft Excel sheet.
  • Export to JSON - To export the individual listed script configuration to the respective individual json file.

Image Removed

Click this option and Filter Pop-up page is displayed. You can apply, save, and update the filters to the script configuration.

Image Removed

Figure: Filter Pop-up

Image Removed

Click this option and Edit Column pop-up page is displayed. You can add a column, delete a column, or change the order of columns. Click Apply to save the changes and you can view the applied changes on Screen Configurations page.

Image Removed

Figure: Edit Columns Pop-up

Image Removed

Click on this icon, a search text box is displayed against each column to search the data against each column.

Image Removed

Figure: Script Configurations details page

Field Description AnchorDetailsPage
Select the Category for which you want to write a script.
Status

Select the status of the script as follows:

  • Design
  • Maintenance
  • Published
DescriptionSpecify the description for the script.
Execution
Max Runtime (In Mins)Specify the maximum run time for the script in terms of minutes.
Remote Execution ByAdministrators can configure the Orchestration Scripts to capture the account under which the Script should get executed through Remote Executor Tool by selecting System Account or CI Account.
Language

Select the language in which

you want to write

the script is written or writing. SummitAI Orchestration supports the following scripting languages:

  • DOS Command
  • Perl Script
PowerShell

Execution

Specify the following parameters under execution.

  • Max Run Time (In Mins) - Specify the maximum run time for the script in terms of minutes. By default, it is saved as 0, if maximum run time is not specified.
  • Remote Execution By - Administrators can configure the Orchestration Scripts to capture the account under which the Script should get executed through Remote Executor Tool by selecting System Account or CI Account.

Input

Once you click on Load Parameters, the parameters specified in the script are displayed under Input tab.

Output

Once you click on Load Parameters, the output variables specified in the script are displayed in Output Variable drop-down under Output tab. You can map the Output Name to the required Output Value.

By default, the following options are available in Output Value drop-down list:

  • Execution Output
  • Execution Error

Criteria

Specify the
  • Powershell Script
  • Python
  • Shell Script (Windows)
  • Shell Script (Non-Windows)
  • VB Script
Theme

You can select the theme while writing the script to get the better view of the script. The following themes are available:

  • Light
  • Dark
  • High Contrast Dark

Script Editor

Specify the commands in the script window.

Input Parameters should be declared as [*VariableName*]

The starting and ending of Output Parameters should be declared as [START##VariableName##] and [END##VariableName##].

Script Details

Specify the following parameters under script details.

  • Script Name – Specify the script name.
  • Category – Specify the category of automation script.
  • Status – By default, status will be in Design mode. Specify the status of the script as required. Available options are as follows:
  • Design
  • Maintenance
  • Published
    Note

    Except Status field, all other fields will be read-only. Only published scripts will be displayed in the Workflow Designer.

    • Description – Specify the description of the script.
    Criteria

    Success or Failure

    Specify the condition to define the success or failure of the Orchestration Script .

    • Slide the Active button to make the success criteria on.
    • Select the variable from the list.
    • Choose the condition from the list.
    • Specify the value for the condition.

    Output Parsing Criteria

    Specify the condition to remove the additional output text and obtain only the valid output.

    Specify the keywords in the Keyword text box and select the Criteria from the list box. The specified criteria will be removed from the output value and only the required output text is displayed.



    Scroll ignore
    scroll-pdftrue
    scroll-officetrue
    scroll-chmtrue
    scroll-docbooktrue
    scroll-eclipsehelptrue
    scroll-epubtrue
    scroll-htmltrue
    1

    | |