VMware vSphere Automation Perl SDK README

Introduction
-----------------------------------------------------------------------------

The VMware vSphere Automation SDK for Perl enables programmatic access to vSphere. The SDK includes perl libraries for accessing new features like Content Library and existing features like Tagging which did not support public API prior to vSphere 6.5.

The SDK contains samples for the features mentioned above as well as samples to demonstrate how to interoperate with vSphere APIs.

This README contains the following topics:

    * Intended Audience
    * Prerequisites
    * Supported Platforms
    * Supported Perl Versions
    * What's in the SDK Package?
    * Installation Instructions
    * How to run the samples?
    * Support and Documentation

Intended Audience
-----------------------------------------------------------------------------

The VMware vSphere Automation SDK for Perl is intended for the following audiences:

    * Developers who want to write new applications for vSphere 6.5.
    * Developers migrating an existing vSphere application to use new features.

Prerequisites
-----------------------------------------------------------------------------
1. Download the latest ActiveState Perl or Strawberry Perl
2. Need to install CPAN modules using below commands:
   a. ppm install XML::LibXML
   b. ppm install UUID::Random
   c. ppm install Crypt::OpenSSL:RSA
   d. ppm install Exception::Class
   e. ppm install Crypt::X509
3. VMware vSphere Automation SDK for Perl 6.5 requires vSphere SDK for Perl 6.5 to be installed first in the targeted client platform. The vSphere SDK for Perl 6.5 interactive installer will install all the required dependencies modules for vSphere Automation SDK for Perl 6.5 as well.
4. Need to copy python27.dll from <vCLI_install_directory>/bin to <vCLI_install_directory>/Perl/lib/VMware on Windows only.

For more info, please refer to https://www.vmware.com/support/developer/viperltoolkit/


Supported Platforms
-----------------------------------------------------------------------------

   Red Hat Enterprise Linux (RHEL) 7 (Server) 64 bit
   Red Hat Enterprise Linux (RHEL) 6.6 (Server) 64 bit
   SLES 12 64 bit
   SLES 11 SP3 64 bit
   Ubuntu 16.04 (LTS) 64bit
   Ubuntu 15.10 (LTS) 64bit
   Windows 10 64 bit

Supported Perl Versions
-----------------------------------------------------------------------------

   Linux: Perl 5.10+
   Windows: ActivePerl 5.14+

What's in the SDK Package?
-----------------------------------------------------------------------------

The VMware-vSphere-Automation-SDK-Perl-6.5.0--<buildno>.zip file contains the
following:

+VMware-vSphere-Automation-SDK-Perl-6.5.0
   +client
      +lib
         +runtime
         +sdk
      +samples
   +docs
   +README

Installation Instructions
-----------------------------------------------------------------------------

1. Please pick up one of the supported linux/windows platform from the
supported platform list.

2. Unzip the VMware-vSphere-Automation-SDK-Perl-6.5.0-<buildno>.zip bundle to
your preferred location in the file system.
   For example:
    unzip VMware-vSphere-Automation-SDK-Perl-6.5.0-<buildno>.zip

3. Set PERL5LIB env variable or perl include path
   export PERL5LIB=$PERL5LIB:<SDK-root-directory>/VMware-vSphere-Automation-SDK-Perl-6.5.0/client/lib/sdk:<SDK-root-directory>/VMware-vSphere-Automation-SDK-Perl-6.5.0/client/lib/runtime:<SDK-root-directory>/VMware-vSphere-Automation-SDK-Perl-6.5.0/client/samples

How to run the samples?
-----------------------------------------------------------------------------

The samples directory in this distribution has sample scripts, showing how
to call the VMware-vSphere-Automation-SDK-Perl API.

   #cd <SDK-root-directory>/VMware-vSphere-Automation-SDK-Perl-6.5.0/client/samples/

   #perl tag_life_cycle.pl --lsurl https://<ip>/lookupservice/sdk --server https://<server_ip> --username <user name> --password <password> --cleanup <true or false>

   #perl tagging_workflow.pl --lsurl https://<ip>/lookupservice/sdk --server https://<server_ip> --username <user name> --password <password> --cleanup <true or false>

   #cd <SDK-root-directory>/VMware-vSphere-Automation-SDK-Perl-6.5.0/client/samples/Vcenter/Vm/Create/DefaultVM

   #perl default_vm.pl --lsurl https://<ip>/lookupservice/sdk --server https://<server_ip> --username <user name> --password <password> --vmfolder <vm folder name> --datastore <datastore name> --clustername <cluster name> --datacenter <datacenter name> --cleanup <true or false>

   #cd <SDK-root-directory>/VMware-vSphere-Automation-SDK-Perl-6.5.0/client/samples/Vcenter/Vm/Create/BasicVM

   #perl basic_vm.pl --lsurl https://<ip>/lookupservice/sdk --server https://<server_ip> --username <user name> --password <password> --vmfolder <vm folder name> --datastore <datastore name> --clustername <cluster name> --datacenter <datacenter name> --standardportgroup <standard portgroup name> --cleanup <true or false>

   #cd <SDK-root-directory>/VMware-vSphere-Automation-SDK-Perl-6.5.0/client/samples/Vcenter/Vm/Create/ExhaustiveVM

   #perl exhaustive_vm.pl --lsurl https://<ip>/lookupservice/sdk --server https://<server_ip> --username <user name> --password <password> --vmfolder <vm folder name> --datastore <datastore name> --clustername <cluster name> --datacenter <datacenter name> --standardportgroup <standard portgroup name> --distributedportgroup  <distributed portgroup name> --isodatastorepath [datastore1] --cleanup <true or false>

Support and Documentation
-----------------------------------------------------------------------------

 After installing, you can find HTML based API documentation in the
 following location:

 <SDK-root-directory>/VMware-vSphere-Automation-SDK-Perl-6.5.0/docs/VMware-vSphere-Automation-SDK-Perl-Api-Reference-Guide.html

Copyright and Licence
-----------------------------------------------------------------------------

Copyright (c) 2014-2016 VMware, Inc.

-The End-
