Using the multibos NSH scripts on multiple AIX servers


TrueSight Server Automation provides NSH scripts to set up and manage an additional BOS instance on the same root volume group on an AIX server (multibos). For setting up and managing an additional BOS instances on multiple AIX servers, you can create a Network Shell script job and run it on the AIX servers.

Downloading the scripts


You can find the AIX_Multibos_Scripts.zip package inside the BSA<version>-Optional.zip package, on the Electronic Product Download (EPD) site. For information about accessing the packages in the EPD, see Downloading-the-installation-files.

Creating the NSH script job

  1. Download and extract the AIX_Multibos_Scripts.zip package from the Electronic Product Download (EPD) site and place the script files on the Application Server:
  2. Right-click a depot folder and select New > NSH Script from the pop-up menu. A wizard opens to help you define the script.
  3. The Script Options panel of the wizard lets you provide identifying information for the Network Shell script, as follows:

    Depot.png 

    Field

    Description

    Name

    Identifying name

    Description

    Optional descriptive text

    Save in

    Folder where you want to store this object.

    File location

    Full path to the script (including host name for remote locations)

    File encoding

    Type of character encoding that is used for the script, such as UTF8 or UTF16

    Script type

    Select the Copy and execute the script against each host separately (for non-NSH scripts) option. The script is repeatedly copied to different servers and then executed on each of those servers. The script uses environment variables local to the server where the script is executed. After execution, the script is deleted.

  4. The Parameters panel lets you define parameters that are replaced with server property values when the NSH script runs. Click Add Parameter g_V95_AddIcon.png, to add the required parameter for the script.
    parameter.png
     

    Field

    Description

    Name

    Name of the parameter.

    Description

    Optional descriptive text.

    Flag

    Enter a flag if the parameter requires one. 
    For example, you could enter a flag like -d to indicate that a script runs in debug mode. Or, you might enter a flag, such as -b, that requires a build number for the script to execute. In the latter case, check the Accepts value option to ensure that a value is specified for the flag.

    Parameter flag required at runtime

    Check if the flag is used when the Network Shell Script Job runs. If you do not check this option, the person who runs the Network Shell Script Job can choose whether the job should use the flag. By default this option is not checked.

    Accepts value

    Check if the flag can accept a value.

    Default value

    Enter a value. 
    If you want the default value to include a reference to a property value that is resolved when the script runs, enter a variable for that property in the Value column, bracketed with double question marks (such as ??WINDIR??/rsc). Alternatively, you can click Select PropertySelectPropertyIcon.gif to find and enter the appropriate property. For more information about this tool, see Inserting-a-parameter

    Value required at runtime

    Ensure that this option is selected.

    Editable

    Ensure that this option is selected. The value must be edited when you run the script.

  5. Skip through the Properties and Permissions panel, and click Finish to close the wizard. Note that while creating an job to run the NSH script, you must provide the required values for the parameters that are passed through the script, as follows:

    Script file

    Operation Perfomred

    Parameters

    aix_multibos_script.sh

    Create a multibos instance on an AIX Server

    Either A or R

    Use the parameter A to install the stand by BOS or R to uninstall the stand by BOS

    server_reboot.sh

    Reboot the AIX Server and change the BOS instance

    Either R or C

    Use the parameter R to reboot the target using the active BOS or C to reboot the target using the stand by BOS

    check_server_reboot.sh

    Check if the AIX server has rebooted successfully 

    Host name of the AIX target server

    Note

    For detailed information about creating a job that runs NSH scripts, see Creating-Network-Shell-Script-Jobs.

  6. Run the Network Shell script job on your AIX targets.
     

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*