perl::NetApp::NaServerUser Contributed Perl Documentaperl::NetApp::NaServer(3)



1mNAME0m
	 NaServer ‐ class for managing Network Appliance(r)
		    filers using ONTAPI(tm) APIs.

1mDESCRIPTION0m
	 An NaServer encapsulates an administrative connection to
	 a NetApp filer running ONTAP 6.4 or later.  You construct
	 NaElement objects that represent queries or commands, and
	 use invoke_elem() to send them to the filer (a convenience
	 routine called invoke() can be used to bypass the element
	 construction step.  The return from the call is another
	 NaElement which either has children containing the command
	 results, or an error indication.

	 The following routines are available for setting up
	 administrative connections to a filer.

       1mnew($filer, $majorversion22m, $minorversion)

	 Create a new connection to filer $filer.  Before
	 use, you either need to set the style to "hosts.equiv"
	 or set the username (always "root" at present) and
	 password with set_admin_user().

       1mset_style($style)0m

	 Pass in "LOGIN" to cause the server to use HTTP
	 simple authentication with a username and
	 password.  Pass in "HOSTS" to use the hosts.equiv
	 file on the filer to determine access rights (the
	 username must be root in that case).

       4mget_style()0m

	 Get the authentication style

       1mset_admin_user($user, $password)0m

	 Set the admin username and password.  At present
	 $user must always be "root".

       1mset_server_type($type)0m

	 Pass in one of these keywords: "FILER" or "NETCACHE"
	 to indicate whether the server is a filer or a NetCache
	 appliance.

	 If you also use set_port(), call set_port() AFTER calling
	 this routine.

	 The default is "FILER".

       4mget_server_type()0m

	 Get the type of server this server connection applies to.

       1mset_transport_type($scheme)0m

	 Override the default transport type.  The valid transport
	 type are currently "HTTP", "HTTPS".

       4mget_transport_type()0m

	 Retrieve the transport used for this connection.

       1mset_debug_style($style)0m

	       Set the style of debug.

       1mset_port($port)0m

	 Override the default port for this server.  If you
	 also call set_server_type(), you must call it before
	 calling set_port().

       4mget_port()0m

	 Retrieve the port used for the remote server.

       4mis_debugging()0m

	       Check the type of debug style and return the
	       value for different needs.
	       Return 1 if debug style is NA_PRINT_DONT_PARSE
	       else return 0.
       =cut

       sub 4mis_debugging()24m {      my $self = shift;		my $style =
       $self−>{debug_style};	  if ($style ne "NA_NO_DEBUG") {
		 return 1;	}      else {		return 0;      } }
       #============================================================#

       4mget_raw_xml_output()0m

	       Return the raw XML output.

       1mset_raw_xml_output($$)0m

	       Save the raw XML output.

       4muse_https()0m

	  Determines whether https is enabled.

       1minvoke_elem($elt)0m

	 Submit an XML request already encapsulated as
	 an NaElement and return the result in another
	 NaElement.

       1minvoke($api, [$argname, $argval] ...)0m

	  A convenience routine which wraps invoke_elem().
	  It constructs an NaElement with name $api, and
	  for each argument name/value pair, adds a child
	  element to it.  It’s an error to have an even
	  number of arguments to this function.

	  Example: $myserver‐>invoke("snapshot‐create",
				     "snapshot", "mysnapshot",
				     "volume", "vol0");

1mCOPYRIGHT0m
	 Copyright 2002‐2003 Network Appliance, Inc. All rights
	 reserved. Specifications subject to change without notice.

	 This SDK sample code is provided AS IS, with no support or
	 warranties of any kind, including but not limited to
	 warranties of merchantability or fitness of any kind,
	 expressed or implied.	This code is subject to the license
	 agreement that accompanies the SDK.

       1mset_vfiler($vfiler)0m

	 sets the vfiler name. This function is added for vfiler‐tunneling.



perl v5.8.8			  2009‐03‐23	     perl::NetApp::NaServer(3)
