vSphere SDK for Perl Programming Guide - Documentation - VMware

Chapter 3 Refining vSphere SDK for Perl Scripts
Alternatively, you can use save_session() with the object‐oriented syntax (see “Using Multiple Sessions” on
page 37):
...
# object-oriented login
my $service_url = "https://$server/sdk/vimService";
my $vim = Vim->new(service_url => $service_url);
$vim->login(user_name => $username, password => $password); ...
# save session $vim in file .mysession
$vim->save_session(session_file => '.mysession');
The session remains active until the program runs a log out or disconnect operation, or until the program times
out. Time out is 30 minutes after the last operation was performed.
Loading Sessions
You can use load_session() to load a saved session into the global session as follows:
Vim::load_session(session_file => '.visession');
Alternatively, you can load a session using the object‐oriented syntax as follows:
my $service_url = "https://$server/sdk/vimService";
my $vim = Vim->new(service_url => $service_url);
$vim = $vim->load_session(session_file => '.visession');
Using Multiple Sessions
In some cases, you might want to create sessions on several vSphere servers at once, or create more than one
session on the same server.
Each time an application connects to a server in the vSphere environment, a session between the application
and the server is created. The vSphere SDK for Perl represents the session as a vSphere SDK for Perl object.
When you use single sessions, one global object is implicit for the sessions.
For multiple objects, you cannot use the implicit global vSphere object. Instead, you must create and use
vSphere objects explicitly, and use the object‐oriented syntax for calling vSphere SDK for Perl methods.
You create an open session in two stages.
1 Create a vSphere object using the new() constructor.
2 Log in by calling the object‐oriented login() method. The arguments to the object‐oriented login()
method are the same as for the procedural Vim::login() subroutine.
Most procedural Vim:: methods have an object‐oriented counterpart. The procedural methods operate on an
implicitly specified global vSphere object. Object‐oriented methods operate on the explicitly supplied vSphere
object.
The following code fragment from /samples/sessions/multisession.pl illustrates how to use multiple
sessions, using the object‐oriented programming style in vSphere SDK for Perl.
Example 3-3. Using Multiple Sessions
use VMware::VIRuntime;
...
# create object for each host
my @vim_objs;
my $url;
$url = Opts::get_option('url');;
push @vim_objs, Vim->new(service_url => $url);
$url = Opts::get_option('url2');
push @vim_objs, Vim->new(service_url => $url);
# login to all hosts
my $username = Opts::get_option('username');
my $password = Opts::get_option('password');
$vim_objs[0]->login(user_name => $username, password => $password);
VMware, Inc. 37