Scribd Logo
Upload

Welcome to Scribd!

  • 2K views

    SVCTools Setup

    Uploaded by

    anon-528475
    This document provides instructions for setting up the SVC Master Console to use Perl scripts from IBM's SVCTools package. It describes downloading and installing ActivePerl and SVCTools, copying required files to the proper directories, and modifying the system PATH variable to allow scripts to connect to the SVC cluster using PuTTY. Example commands are given to get help and run the balance.pl script to rebalance extents across media disks.

    Copyright:

    Attribution Non-Commercial (BY-NC)
    Download as DOC, PDF, TXT or read online from Scribd

    SVCTools Setup

    Uploaded by

    anon-528475
    2K views8 pages
    This document provides instructions for setting up the SVC Master Console to use Perl scripts from IBM's SVCTools package. It describes downloading and installing ActivePerl and SVCTools, copying required files to the proper directories, and modifying the system PATH variable to allow scripts to connect to the SVC cluster using PuTTY. Example commands are given to get help and run the balance.pl script to rebalance extents across media disks.

    Original Title

    SVCToolsSetup

    Copyright

    © Attribution Non-Commercial (BY-NC)

    Available Formats

    DOC, PDF, TXT or read online from Scribd

    Did you find this document useful?

    Is this content inappropriate?

    This document provides instructions for setting up the SVC Master Console to use Perl scripts from IBM's SVCTools package. It describes downloading and installing ActivePerl and SVCTools, copying required files to the proper directories, and modifying the system PATH variable to allow scripts to connect to the SVC cluster using PuTTY. Example commands are given to get help and run the balance.pl script to rebalance extents across media disks.

    Copyright:

    Attribution Non-Commercial (BY-NC)
    Download as DOC, PDF, TXT or read online from Scribd
    Download as doc, pdf, or txt
    2K views8 pages

    SVCTools Setup

    Uploaded by

    anon-528475
    This document provides instructions for setting up the SVC Master Console to use Perl scripts from IBM's SVCTools package. It describes downloading and installing ActivePerl and SVCTools, copying required files to the proper directories, and modifying the system PATH variable to allow scripts to connect to the SVC cluster using PuTTY. Example commands are given to get help and run the balance.pl script to rebalance extents across media disks.

    Copyright:

    Attribution Non-Commercial (BY-NC)
    Download as DOC, PDF, TXT or read online from Scribd
    Download as doc, pdf, or txt
    of 8

    Steps to setup the SVC Master Console for using the SVC perl

    scripts from www.alphaworks.ibm.com/tech/svctools


    Assumptions:
    1. The SVC Master Console already has PuTTY installed, so C:\Program
    Files\PuTTY\plink.exe is available for use by perl scripts.
    2. The SVC Master Console contains the admin SSH key file to login to the SVC cluster
    at c:\program files\putty\icat.ppk, this file will be used by the perl scripts.
    3. The login userid has administrator authority.

    Setup Steps:
    1. Download the free perl script package from
    http://www.activestate.com/Products/activeperl/
    2. Install the perl script package on SVC Master Console
    3. Download the SVCTools package from
    http://www.alphaworks.ibm.com/tech/svctools/download
    4. Unzip/Extract the SVCTools.zip file (for example extract to C:\SVCTools)
    5. Create a IBM directory in C:\perl\lib
    6. Copy the C:\SVCTools\lib\IBM\SVC.pm file to the C:\perl\lib\IBM directory
    7. To temporarily add the C:\Program Files\PuTTY path to the windows PATH
    environment variable. This can be accomplished by entering in “PATH=C:\Program
    Files\PuTTY;%PATH%” at a command prompt which will be used for the script. To
    permanently add the PuTTY path see Appendix A.

    If the user needs to update files from more recent SVCTools package, the SVC.pm file
    needs to be updated with the same name and location with the more current file. The
    individual scripts can run as they are named.

    At this point, the SVC Master Console can run the example scripts or user created scripts
    that utilize the SVC.pm perl module.

    The user can change to the directory where the scripts are and run them locally.

    For example … get the online help for the balance.pl script in a command prompt:
    C:\SVCTools\examples\balance>perl balance.pl -h
    balance.pl Usage:
    balance.pl MDiskGrp [-t VDisk,VDisk,...] [-m MDisk,MDisk,...]
    [-n number] [-e] [-f] [-r [delay]] -c cluster | -i ip
    [-k keyfile] [-u username] [-s application] [-v] [-z [retry delay]] [-h]

    balance.pl MDiskGrp
    [-t|--target VDisk01,Vdisk02,...]
    [-m|--media MDisk01,MDisk02,...]
    [-n|--number migrate_limit]
    [-e|--execute]
    [-f|--force]
    [-r|--recursive [delay]]
    [-c|--cluster hostname | -i|--ip address]
    [-k|--key file]
    [-s|--ssh application]
    [-u|--username name]
    [-v|--verbose]
    [-z|--zRetryDelay [retry delay]]
    [-h|--help]

    Invoke this script with the name of the MDiskGrp you wish to
    rebalance. Additional options can be specified to alter behaviour:

    -t, --target Specify which VDisks to balance. Default behaviour is to


    balance all VDisks in the MDiskGrp.

    -m, --media Specify which MDisks extents can be moved to and


    from. Default behaviour is to use all MDisks.

    -n, --number Constrain the total number of migrates. If the total


    number of migrates running on the SVC is equal to or
    greater than this figure, the script will not spawn
    any more migrates. Only applicable when used with -e.

    -e, --execute If this flag is set the script will execute the migrate
    commands instead of just printing them to screen.

    -f, --force The script will attempt to improve the distribution of


    extents even if there is no possible optimal solution.

    -r, --recursive Repeated passes are made by the script until an optimal
    solution is reached. The script will wait for migrates
    to finish and then run more. Optionally specify the.
    delay between checks, applicable with -e.

    -c, --cluster Specify the hostname of the cluster to connect to.

    -i, --ip Specify the IP address of the cluster to connect to.


    If -c is also specified both values are sent to IBM::SVC.

    -k, --key Specify the key file for use in making SSH connections.

    -s, --ssh Specify the application used for making SSH connections.

    -u, --username Specify the username for use in making SSH connections.

    -v, --verbose If this flag is set the script will provide more detail
    and depth in the output.

    -z, --zRetryDelay Specify the delay in seconds between retries in case of


    SVC cluster connection failures.

    -h, --help Prints this usage statement.

    For more information, please consult the perldoc for this script.

    For example … run the balance.pl script in a command prompt:


    C:\SVCTools\examples\balance>perl balance.pl DS6K_4_old_Fast
    -k "c:\program files\putty\icat.ppk" -i 9.82.39.193 -v -d -r 5 –z 10
    Starting Extent Balance script.
    Parameters:
    MDiskGrp: DS6K_4_old_Fast
    --recursive: 5
    --ip: 9.82.39.193
    --key: c:\program files\putty\icat.ppk
    --verbose: enabled
    --debug: enabled
    --zRetryDelay: 10

    [14:43:26 01/16/08] [balance.pl]


    Created IBM::SVC instance.
    Connected to SVC Cluster. MDiskGrp ID: 7.

    [14:43:38 01/16/08] [balance.pl]


    Creating $mdisk_ref data structure.
    -->| SVC_LUN8 is a quorum disk.
    >| Added MDisk: ID 6, SVC_LUN8, Free Extents 0, Capacity 5100273664.
    >| Added MDisk: ID 7, SVC_LUN9, Free Extents 0, Capacity 5368709120.

    Appendix A – How to permanently add the C:\Program Files\PuTTY path to the system

    Click on Properties for My Computer (Win XP here).

    Here is the Properties panel for Windows 2003 Server.


    The process is the same for both Win XP and Windows 2003 Server.
    Click on the Advanced tab, then select the Environment Variables button.
    Click on the Edit button after highlighting the Path system variable.

    Click on the Variable value field and move to the beginning of the field.

    Add “C:\Program Files\PuTTY;” before the first entry and click OK.
    Click OK
    Click OK.

    Verify via the windows command prompt … Done!

    You might also like