


User Contributed Perl Documentation	perl::NetApp::NaServer(3)



NAME
       NaServer	- class	for managing Network Appliance(r)
		  filers using ONTAPI(tm) APIs.

DESCRIPTION
       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.

     new($filer, $majorversion,	$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().

     set_style($style)

       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).

     get_style()

       Get the authentication style

     set_admin_user($user, $password)

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

     set_server_type($type)

       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".




perl v5.8.8	     Last change: 2009-10-06			1






User Contributed Perl Documentation	perl::NetApp::NaServer(3)



     get_server_type()

       Get the type of server this server connection applies to.

     set_transport_type($scheme)

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

     get_transport_type()

       Retrieve	the transport used for this connection.

     set_debug_style($style)

	     Set the style of debug.

     set_port($port)

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

     get_port()

       Retrieve	the port used for the remote server.

     is_debugging()

	     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 is_debugging()	{      my $self	= shift;	 my
     $style = $self->{debug_style};	 if ($style ne
     "NA_NO_DEBUG") {		return 1;      }      else {
	       return 0;      }	}
     #============================================================#

     get_raw_xml_output()

	     Return the	raw XML	output.

     set_raw_xml_output($$)

	     Save the raw XML output.







perl v5.8.8	     Last change: 2009-10-06			2






User Contributed Perl Documentation	perl::NetApp::NaServer(3)



     use_https()

	Determines whether https is enabled.

     invoke_elem($elt)

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

     invoke($api, [$argname, $argval] ...)

	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");

COPYRIGHT
       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.

     set_vfiler($vfiler)

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




















perl v5.8.8	     Last change: 2009-10-06			3



