Infoblox::Grid::Member::License - License object.
Licenses are pre-installed on an Infoblox device according to the software packages ordered at the time of purchase. You can upgrade an Infoblox device with the Keystone license. Contact Infoblox Technical Support to get the Keystone license and install it on the device.
my $license = Infoblox::Grid::Member::License->new( key => $string, #Required );
This section describes all the methods in the Infoblox::Session module that you can apply to a License object.
Use this method to add a License object to the Infoblox device. See Infoblox::Session->add() for parameters and return values.
#Construct an object my $license = Infoblox::Grid::Member::License->new( key => "EQAAAIMhrdkGjSnnmBlgQSA14b16" );
# Submit for addition my $response = $session->add( $license );
Use this method to retrieve the existing objects from an Infoblox appliance. See Infoblox::Session->get() for parameters and return values.
Apply the following attributes to search the License object(s):
"type" - Optional. The license type.
"limit" - Optional. The limitation of license.
"key" - Optional. The license string.
my $retrieved_objs = $session->get(object => "Infoblox::Grid::Member::License");
Use this method to retrieve the existing objects from an Infoblox appliance. See Infoblox::Session->search() for parameters and return values.
Apply the following attributes to search the License object(s):
"type" - Optional. The license type.
"limit" - Optional. The limitation of license.
"key" - Optional. The license string.
my @retrieved_objs = $session->search( object => "Infoblox::Grid::Member::License", type => "DNS" );
Use this method to remove a License object from the Infoblox device. See Infoblox::Session->remove() for parameters and return values.
# Remove the object my $response = $session->remove( $license );
Use this function to retrieve the licenses of a specific Infoblox grid member.
#Retrieve the licenses from a grid member my $licenses = $grid_member->node1_licenses();
This section describes all the methods that you can use to set or retrieve the attribute values of a License object.
Use this method to retrieve the license expiration timestamp. This is a read-only attribute.
None
The method returns the number of seconds elapsed since January 1, 1970, in UTC format.
#Get expiration value my $expiration = $object->expiration();
Use this method to retrieve the license expiration status. This is a read-only attribute.
None
The method returns the attribute value.
#Get expiration_status value my $expiration_status = $object->expiration_status();
Use this method to set or retrieve the license key.
Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.
Specify the string with the license key of the device.
If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.
If you did not specify a parameter, the method returns the attribute value.
#Get key my $key = $license->key();
#Modify key $license->key("EQAAAKsmItQcEWiFb6csgab2VeQ7");
Use this method to retrieve the overall type of license. This is a read-only attribute.
None.
The method returns the attribute value. Valid values are:
"Static" - The overall license type is static license.
"Dynamic" - The overall license type is dynamic license.
#Get the overall type of license my $kind = $license->kind();
Use this method to retrieve the hardware ID of the physical node on which the license is installed. This is a read-only attribute.
None
The method returns the attribute value.
#Get the hardware ID my $hwid = $license->hwid();
Use this method to retrieve the license limit value. This is a read-only attribute.
None
The method returns the attribute value.
#Get limit value my $limit = $object->limit();
Use this method to retrieve the context of the license limit. This is a read-only attribute.
None
The method returns the attribute value.
#Get limit_context value my $limit_context = $object->limit_context();
Use this method to retrieve the type of license.
The method returns the attribute value. Valid values are:
"AnyCast" - Enables the AnyCast services.
"Cloud Network Automation" - Enable cloud functionality for the GUI.
"Cloud Platform" - Enable cloud API service on the Cloud Platform Appliance.
"DNSCacheAcceleration" - Enables the DNS Cache Acceleration service.
"DDI Trial" - Enables the DDI Trial mode.
"DHCP" - Enables the Dynamic Host Configuration Protocol (DHCP) service.
"Discovery" - Enables the Discovery service.
"DNS" - Enables the Domain Name System (DNS) service.
"DNS Query Rewrite" - Enables support for DNS Query Rewrite.
"FireEye" - Enables support for FireEye zones.
"KeystoneDVS" - Enables Grid-based global management and reporting for Domain Name System (DNS), Dynamic Host Configuration Protocol (DHCP), and IP address management (IPAM) appliance solutions.
"KeystoneSup" - Enables the Grid maintenance service.
"IF-MAP Service" - Enables the IF-MAP service.
"IF-MAP Federation" - Enables support for IF-MAP Federation connectors.
"IF-MAP Evaluation" - Enables support for IF-MAP Evaluation.
"IPAM Freeware" - Enables IPAM Express.
"LDAP" - Enables the Lightweight Directory Access Protocol (LDAP) service.
"Load Balancer" - Enables support for Load Balancer.
"Multi-Grid Management" - Enables Multi-Grid Management.
"MS Management" - Enables Microsoft Management.
"NIOSMaintenance" - Enables nonstop core network services such as Domain Name System (DNS), Dynamic Host Configuration Protocol (DHCP), and IP address management (IPAM).
"OEM" - Enables OEM mode.
"Query Redirection" - Enables the Query Redirection service.
"RADIUS" - Enables the RADIUS service.
"Reporting" - Enables the Reporting service.
"Response Policy Zones" - Enables support for Response Policy zones.
"Security Ecosystem" - Enables support for Security Ecosystem services, such as the TAXII server.
"Trinzic Automation Engine" - Enables the Network Automation Engine.
"Threat Protection" - Enables the Threat Protection service.
"Threat Protection Update" - Enables the Threat Protection Update service.
"Threat Protection Software Add-On" - Enables the Threat Protection Software Add-On.
"vNIOS" - Enables support for a specific vNIOS virtual appliance model.
"Threat Analytics" - Enables the Threat Analytics service.
"Security Ecosystem" - Enables the Security Ecosystem feature.
"Flex Grid Activation" - Allows all features to be enabled unless there is a conflict with hardware or existing enabled services.
#Get type my $type = $license->type();
The following sample code demonstrates different operations that can be applied to a License object, such as create and remove an object. This sample code also includes error handling for the operations.
#Preparation prior to a license insertion
#PROGRAM STARTS: Include all the modules that will be used use strict; use Infoblox;
#Create a session to the Infoblox device my $session = Infoblox::Session->new( master => "192.168.1.2", username => "admin", password => "infoblox" );
unless ($session) { die("Construct session failed: ", Infoblox::status_code() . ":" . Infoblox::status_detail()); } print "Session created successfully\n";
#Add License object to Infoblox device
#Construct a License object
my $license = Infoblox::Grid::Member::License->new( key => "EQAAAIMhrdkGjSnnmBlgQSA14b16" );
unless ($license) { die("Construct License object failed: ", Infoblox::status_code() . ":" . Infoblox::status_detail()); } print "License object created successfully\n";
#Adding the license object to Infoblox Appliance through session. $session->add($license) or die("Add License failed: ", $session->status_code() . ":" . $session->status_detail() . "\nPlease contact Infoblox Technical Support to get the license key and add them to the device\n");
print "Added License to Infoblox Appliance successfully.\n";
####PROGRAM ENDS####
Infoblox Inc. http://www.infoblox.com/
Copyright (c) 2017 Infoblox Inc.