Infoblox::Grid - Manages the Grid settings.


NAME

Infoblox::Grid - Manages the Grid settings.


DESCRIPTION

This class manages the database that is distributed among all grid members. The grid object is not intended to be instantiated, it should only be used to modify information.

A grid is a group of two or more Infoblox appliances that share sections of a common, distributed, built-in database and also, are connected together to provide a single point of administration and service configuration in a secure, highly available environment.


CONSTRUCTOR

The Infoblox::Grid object is automatically generated upon the successful installation of the Infoblox appliance. It does not require manual construction.


SESSION METHODS

This section describes all the methods in Infoblox::Session that you can apply to a grid object.

Infoblox::Session->get( )

Use this method to retrieve the existing objects from the Infoblox appliance. See Infoblox::Session->get() for parameters and return values.

Example
 my $grid = $session->get(
     object => "Infoblox::Grid");

Infoblox::Session->search( )

Use this method to search for the existing objects from the Infoblox appliance. See Infoblox::Session->search() for parameters and return values.

Example
 my $grid = $session->search(
     object => "Infoblox::Grid");

Infoblox::Session->modify( )

Use this method to modify objects in the Infoblox appliance. See Infoblox::Session->modify() for parameters and return values.

If you have applied an access control list to an object, you must restart services after you update the access control list for the changes to take effect. See Infoblox::Session->restart() method.

Example
 # Use method to modify the name
 $grid->name("Infoblox2");
 # Submit modification
 my $response = $session->modify( $grid );


METHODS

This section describes all the methods that you can use to configure and retrieve the attribute values of a grid.

admin_access_items( )

Use this method to set or retrieve the security access items.

Parameter

Valid value is an Infoblox::Grid::NamedACL object or an array reference that contains IPv4/IPv6 addresses or networks.

Returns

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.

Example
 #Get admin_access_items
 my $admin_access_items = $grid->admin_access_items();
 #Modify admin_access_items
 $grid->admin_access_items(["10.10.10.1", "10.10.2.0/24", "2001::1"]);
 #Use Infoblox::Grid::NamedACL
 $grid->admin_access_items($nacl);

allow_recursive_deletion( )

Use this method to set or retrieve the allow_recursive_deletion property.

Parameter

Valid values are "NOBODY", "SUPERUSERS" and "ALL". Default value is "ALL".

Returns

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.

Example
 #Get allow_recursive_deletion
 my $allow_recursive_deletion = $grid->allow_recursive_deletion();
 #Modify allow_recursive_deletion
 $grid->allow_recursive_deletion("SUPERUSERS");

admin_access_remote_console( )

Use this method to set or retrieve the flag that enables or disables access control for remote console access.

Parameter

Valid values are "true" or "false".

Returns

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.

Example
 #Get admin_access_remote_console
 my $admin_access_remote_console = $obj->admin_access_remote_console();
 #Modify admin_access_remote_console
 $obj->admin_access_remote_console("false");

audit_log_format( )

Use this method to set or retrieve the audit log format.

Parameter

Valid values are "detailed" or "brief". Default value is "detailed".

Returns

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.

Example
 #Get audit_log_format
 my $audit_log_format = $grid->audit_log_format();
 #Modify audit_log_format
 $grid->audit_log_format("brief");

alternate_resolver( )

Use this method to set or retrieve the alternate resolver.

Parameter

The valid values are Infoblox::DNS::Member object or Infoblox::DNS::Nameserver object.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get alternate_resolver
 my $alternate = $grid->alternate_resolver();
 #Modify alternate_resolver
 $grid->alternate_resolver("4.4.4.4");

consent_banner_setting( )

Use this method to set or retrieve the Grid consent banner settings.

Parameter

An Infoblox::Grid::ConsentBannerSetting object.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Enable the consent banner
 my $banner = Infoblox::Grid::ConsentBannerSetting->new(enable => 'true', message => 'Consent message');
 $grid->consent_banner_setting($banner);

copy_audit_to_syslog( )

Use this method to set or retrieve the flag that enables the appliance to copy audit log messages to syslog.

Parameter

Valid values are "true" or "false".

Returns

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.

Example
 #Get copy_audit_to_syslog
 my $copy_audit_to_syslog = $obj->copy_audit_to_syslog();
 #Modify copy_audit_to_syslog
 $obj->copy_audit_to_syslog("true");

descendants_action( )

Use this method to set or retrieve the default actions for extensbile attributes that exist on descendants.

Parameter

Valid value is an Infoblox::Grid::ExtensibleAttributeDef::Descendants object.

Returns

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.

Example
 #Get attribute value
 my $descendants_action = $grid->descendants_action();
 #Modify attribute value
 $grid->descendants_action($descendants);

deny_mgm_snapshots( )

Use this method to set or retrieve the flag that controls whether the subgrid should send snapshots to MGM or not.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Paramter

Specify 'true' to allow sending snapshots to MGM by subgrid and 'false' to forbid it.

Returns

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.

Example
 #Get deny_mgm_snapshots value
 my $value = $object->deny_mgm_snapshots();
 #Modify deny_mgm_snapshots value
 $object->deny_mgm_snapshots('true');

dscp( )

Use this method to set or retrieve the DSCP value.

Parameter

Valid values are integers between 0 and 63 inclusive. The default value is 0.

Returns

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.

Example
 #Get dscp
 my $dscp = $grid->dscp();
 #Modify dscp
 $grid->dscp(12);

enable_login_banner( )

Use this method to enable or disable the login banner.

Parameter

Specify "true" to enable the login banner or "false" to disable it. The default value is "true".

Returns

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.

Example
 #Get enable_login_banner
 my $enable_login_banner = $grid->enable_login_banner();
 #Modify enable_login_banner
 $grid->enable_login_banner("false");

enable_lom( )

Use this method to set or retrieve the flag that controls whether the LOM functionality is enabled.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Specify "true" to set the enable_lom flag or "false" to deactivate/unset it. The default value is "false".

Returns

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.

Example
 #Get enable_lom from the grid
 my $lom = $grid->enable_lom();
 #Modify enable_lom
 $grid->enable_lom("true");

enable_gui_api_for_lan_vip( )

Use this method to enable or disable GUI and API access on the LAN/VIP port, in addition to the MGMT port when it is configured.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Paramter

Specify 'true' to enable GUI and API access on the LAN/VIP port or 'false' to disable it.

Returns

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.

Example
 #Get enable_gui_api_for_lan_vip
 my $enable_gui_api_for_lan_vip = $grid->enable_gui_api_for_lan_vip();
 #Modify enable_gui_api_for_lan_vip
 $grid->enable_gui_api_for_lan_vip('true');

enable_member_redirect( )

Use this method to set or retrieve the flag that specifies if GUI redirection is enabled for members.

Parameter

Valid values are "true" or "false". Default value is "true".

Returns

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.

Example
 #Get enable_member_redirect
 my $enable_member_redirect = $obj->enable_member_redirect();
 #Modify enable_member_redirect
 $obj->enable_member_redirect("true");

enable_ntp( )

Use this method to enable/disable NTP (Network Time Protocol).

Parameter

Specify "true" to enable NTP or "false" to disable it. Default value is "false".

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get ntp
 my $ntp = $grid->enable_ntp();
 #Modify NTP
 $grid->enable_ntp ("true");

enable_recycle_bin( )

Use this method to enable/disable the recycle bin.

When the recycle bin is enabled, deleted DNS data (Zone,View) and DHCP data (Network,Network container,Shared network,DHCP range,Fixed address,DHCP MAC filter) is moved to the recycle bin and can be restored later.

Parameter

Specify "true" to enable the recycle bin or "false" to disable it. Default value is "true".

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get enable_recycle_bin
 my $recycle_bin = $grid->enable_recycle_bin();
 #Modify enable_recycle_bin
 $grid->enable_recycle_bin ("false");

enable_rir_swip( )

Use this method to enable or diasble support for RIR/SWIP.

The following specific extensible attribute definitions with the 'RIPE' namespace will be added when support for RIR/SWIP is enabled for the first time:

 +--------------------------------------------------------------------------------------------------------------------------------------+
 | RIPE Network Name      - The name of the network that contains the RIR assignment, in string format.                                 |
 |                          Required for Infoblox::DHCP::Network, Infoblox::DHCP::IPv6Network, Infoblox::DHCP::NetworkContainer,        |
 |                          Infoblox::DHCP::IPv6NetworkContainer, Infoblox::DHCP::NetworkTemplate, Infoblox::DHCP::IPv6NetworkTemplate  |
 |                          objects if rir_organization member is defined. Otherwise this is optional RIR attribute for these objects.  |
 | RIPE Description       - The short description related to the object in string format.                                               |
 |                          Required for Infoblox::DHCP::Network, Infoblox::DHCP::IPv6Network, Infoblox::DHCP::NetworkContainer,        |
 |                          Infoblox::DHCP::IPv6NetworkContainer, Infoblox::DHCP::NetworkTemplate, Infoblox::DHCP::IPv6NetworkTemplate  |
 |                          objects if rir_organization member is defined. Otherwise this is optional RIR attribute for these objects.  |
 |                          Optional for Infoblox::Grid::RIR::Organization object.                                                      |
 | RIPE Country           - The country name with the two-letter ISO 3166 country code in string format, e.g. 'Afghanistan (AF)'.       |
 |                          Valid values you can see in the next table.                                                                 |
 |                          Required for Infoblox::DHCP::Network, Infoblox::DHCP::IPv6Network, Infoblox::DHCP::NetworkContainer,        |
 |                          Infoblox::DHCP::IPv6NetworkContainer, Infoblox::DHCP::NetworkTemplate, Infoblox::DHCP::IPv6NetworkTemplate  |
 |                          objects if rir_organization member is defined. Otherwise this is optional RIR attribute for these objects.  |
 |                          Required for Infoblox::Grid::RIR::Organization object.                                                      |
 | RIPE Admin Contact     - The admin contact in string format.                                                                         |
 |                          Required for Infoblox::DHCP::Network, Infoblox::DHCP::IPv6Network, Infoblox::DHCP::NetworkContainer,        |
 |                          Infoblox::DHCP::IPv6NetworkContainer, Infoblox::DHCP::NetworkTemplate, Infoblox::DHCP::IPv6NetworkTemplate  |
 |                          objects if rir_organization member is defined. Otherwise this is optional RIR attribute for these objects.  |
 |                          Required for Infoblox::Grid::RIR::Organization object.                                                      |
 | RIPE Technical Contact - The technical contact in string format.                                                                     |
 |                          Required for Infoblox::DHCP::Network, Infoblox::DHCP::IPv6Network, Infoblox::DHCP::NetworkContainer,        |
 |                          Infoblox::DHCP::IPv6NetworkContainer, Infoblox::DHCP::NetworkTemplate, Infoblox::DHCP::IPv6NetworkTemplate  |
 |                          objects if rir_organization member is defined. Otherwise this is optional RIR attribute for these objects.  |
 |                          Required for Infoblox::Grid::RIR::Organization object.                                                      |
 | RIPE IPv4 Status       - The status of the address range represented by inetnum object that can be 'ALLOCATED PA',                   |
 |                          'ALLOCATED PI', 'ALLOCATED UNSPECIFIED', 'LIR-PARTITIONED PA', 'LIR-PARTITIONED PI', 'SUB-ALLOCATED PA',    |
 |                          'ASSIGNED PA', 'ASSIGNED PI', 'ASSIGNED ANYCAST', 'EARLY-REGISTRATION' or 'NOT-SET'.                        |
 |                          Required for Infoblox::DHCP::Network, Infoblox::DHCP::NetworkContainer and Infoblox::DHCP::NetworkTemplate  |
 |                          objects if rir_organization member is defined. Otherwise this is optional RIR attribute for these objects.  |
 | RIPE IPv6 Status       - The status of the address range represented by inet6num object that can be 'ALLOCATED-BY-RIR',              |
 |                          'ALLOCATED-BY-LIR', 'ASSIGNED', 'ASSIGNED ANYCAST' or 'ASSIGNED PI'.                   |
 |                          Required for Infoblox::DHCP::IPv6Network, Infoblox::DHCP::IPv6NetworkContainer and                          |
 |                          Infoblox::DHCP::IPv6NetworkTemplate objects if rir_organization member is defined. Otherwise this is        |
 |                          optional RIR attribute for these objects.                                                                   |
 | RIPE Remarks           - Some freeform remarks in string format.                                                                     |
 |                          Required for Infoblox::DHCP::Network, Infoblox::DHCP::IPv6Network, Infoblox::DHCP::NetworkContainer,        |
 |                          Infoblox::DHCP::IPv6NetworkContainer, Infoblox::DHCP::NetworkTemplate, Infoblox::DHCP::IPv6NetworkTemplate  |
 |                          objects if rir_organization member is defined. Otherwise this is optional RIR attribute for these objects.  |
 |                          Optional for Infoblox::Grid::RIR::Organization object.                                                      |
 | RIPE Notify            - The Email address to which notifications must be sent for any updates in string format.                     |
 |                          Optional for Infoblox::DHCP::Network, Infoblox::DHCP::IPv6Network, Infoblox::DHCP::NetworkContainer,        |
 |                          Infoblox::DHCP::IPv6NetworkContainer, Infoblox::DHCP::NetworkTemplate, Infoblox::DHCP::IPv6NetworkTemplate, |
 |                          Infoblox::Grid::RIR::Organization objects.                                                                  |
 | RIPE Lower Level Maintainer                                                                                                          |
 |                        - The identifier of a registerd maintainer object used for hierarchical authorization, in string format.      |
 |                          Optional for Infoblox::DHCP::Network, Infoblox::DHCP::IPv6Network, Infoblox::DHCP::NetworkContainer,        |
 |                          Infoblox::DHCP::IPv6NetworkContainer, Infoblox::DHCP::NetworkTemplate, Infoblox::DHCP::IPv6NetworkTemplate  |
 |                          objects.                                                                                                    |
 | RIPE Reverse Domain Maintainer                                                                                                       |
 |                        - The identifier of a registered maintainer object used for reverse domain authorization, in string format.   |
 |                          Optional for Infoblox::DHCP::Network, Infoblox::DHCP::IPv6Network, Infoblox::DHCP::NetworkContainer,        |
 |                          Infoblox::DHCP::IPv6NetworkContainer, Infoblox::DHCP::NetworkTemplate, Infoblox::DHCP::IPv6NetworkTemplate  |
 |                          objects.                                                                                                    |
 | RIPE Routes Maintainer - The identifier of a registered maintainer object that contols the authorization of the creation of route    |
 |                          and route6 objects, in string format.                                                                       |
 |                          Optional for Infoblox::DHCP::Network, Infoblox::DHCP::IPv6Network, Infoblox::DHCP::NetworkContainer,        |
 |                          Infoblox::DHCP::IPv6NetworkContainer, Infoblox::DHCP::NetworkTemplate, Infoblox::DHCP::IPv6NetworkTemplate  |
 |                          objects.                                                                                                    |
 | RIPE Computer Security Incident Response Team                                                                                        |
 |                        - The point to an irt object representing a Computer Security Incident Response Team (CSIRT) that handles     |
 |                          security incidents for the address space specified by the inetnum or inet6num object in string format.      |
 |                          Optional for Infoblox::DHCP::Network, Infoblox::DHCP::IPv6Network, Infoblox::DHCP::NetworkContainer,        |
 |                          Infoblox::DHCP::IPv6NetworkContainer, Infoblox::DHCP::NetworkTemplate, Infoblox::DHCP::IPv6NetworkTemplate  |
 |                          objects.                                                                                                    |
 | RIPE Registry Source   - The registry where the object is registered. This can be 'RIPE' or "TEST'.                                  |
 |                          Required for Infoblox::DHCP::Network, Infoblox::DHCP::IPv6Network, Infoblox::DHCP::NetworkContainer,        |
 |                          Infoblox::DHCP::IPv6NetworkContainer, Infoblox::DHCP::NetworkTemplate, Infoblox::DHCP::IPv6NetworkTemplate  |
 |                          objects if rir_organization member is defined. Otherwise this is optional RIR attribute for these objects.  |
 |                          Required for Infoblox::Grid::RIR::Organization object.                                                      |
 | RIPE Organization Type - The organization type. This can be 'IANA','RIR','NIR','LIR','WHITEPAGES','DIRECT_ASSIGNMENT', or 'OTHER'.   |
 |                          Optional for Infoblox::Grid::RIR::Organization object.                                                      |
 | RIPE Address           - The organization address in string format.                                                                  |
 |                          Optional for Infoblox::Grid::RIR::Organization object.                                                      |
 | RIPE Phone Number      - The organization phone number in string format.                                                             |
 |                          Optional for Infoblox::Grid::RIR::Organization object.                                                      |
 | RIPE Fax Number        - The organization fax number in string format.                                                               |
 |                          Optional for Infoblox::Grid::RIR::Organization object.                                                      |
 | RIPE Email             - The organization email address in string format.                                                            |
 |                          Required for Infoblox::Grid::RIR::Organization object.                                                      |
 | RIPE Abuse Mailbox     - The email address to which abuse complaints should be sent in string format.                                |
 |                          Optional for Infoblox::Grid::RIR::Organization object.                                                      |
 | RIPE Reference Notify  - The email address to be notified when a reference to the organization object is added or removed, in string |
 |                          format.                                                                                                     |
 |                          Optional for Infoblox::Grid::RIR::Organization object.                                                      |
 +--------------------------------------------------------------------------------------------------------------------------------------+

The following values are valid for 'RIPE Country' attribute:

 +------+----------------------------------------------------+------------------------------------------------------+
 | Code | Country                                            | Value                                                |
 +------+----------------------------------------------------+------------------------------------------------------+
 |  AF  | Afghanistan                                        | Afghanistan (AF)                                     |
 |  AX  | Aland Islands                                      | Aland Islands (AX)                                   |
 |  AL  | Albania                                            | Albania (AL)                                         |
 |  DZ  | Algeria                                            | Algeria (DZ)                                         |
 |  AS  | American Samoa                                     | American Samoa (AS)                                  |
 |  AD  | Andorra                                            | Andorra (AD)                                         |
 |  AO  | Angola                                             | Angola (AO)                                          |
 |  AI  | Anguilla                                           | Anguilla (AI)                                        |
 |  AQ  | Antarctica                                         | Antarctica (AQ)                                      |
 |  AG  | Antigua and Barbuda                                | Antigua and Barbuda (AG)                             |
 |  AR  | Argentina                                          | Argentina (AR)                                       |
 |  AM  | Armenia                                            | Armenia (AM)                                         |
 |  AW  | Aruba                                              | Aruba (AW)                                           |
 |  AU  | Australia                                          | Australia (AU)                                       |
 |  AT  | Austria                                            | Austria (AT)                                         |
 |  AZ  | Azerbaijan                                         | Azerbaijan (AZ)                                      |
 |  BS  | Bahamas                                            | Bahamas (BS)                                         |
 |  BH  | Bahrain                                            | Bahrain (BH)                                         |
 |  BD  | Bangladesh                                         | Bangladesh (BD)                                      |
 |  BB  | Barbados                                           | Barbados (BB)                                        |
 |  BY  | Belarus                                            | Belarus (BY)                                         |
 |  BE  | Belgium                                            | Belgium (BE)                                         |
 |  BZ  | Belize                                             | Belize (BZ)                                          |
 |  BJ  | Benin                                              | Benin (BJ)                                           |
 |  BM  | Bermuda                                            | Bermuda (BM)                                         |
 |  BT  | Bhutan                                             | Bhutan (BT)                                          |
 |  BO  | Bolivia, Plurinational State of                    | Bolivia, Plurinational State of (BO)                 |
 |  BQ  | Bonaire, Sint Eustatius and Saba                   | Bonaire, Sint Eustatius and Saba (BQ)                |
 |  BA  | Bosnia and Herzegovina                             | Bosnia and Herzegovina (BA)                          |
 |  BW  | Botswana                                           | Botswana (BW)                                        |
 |  BV  | Bouvet Island                                      | Bouvet Island (BV)                                   |
 |  BR  | Brazil                                             | Brazil (BR)                                          |
 |  IO  | British Indian Ocean Territory                     | British Indian Ocean Territory (IO)                  |
 |  BN  | Brunei Darussalam                                  | Brunei Darussalam (BN)                               |
 |  BG  | Bulgaria                                           | Bulgaria (BG)                                        |
 |  BF  | Burkina Faso                                       | Burkina Faso (BF)                                    |
 |  BI  | Burundi                                            | Burundi (BI)                                         |
 |  KH  | Cambodia                                           | Cambodia (KH)                                        |
 |  CM  | Cameroon                                           | Cameroon (CM)                                        |
 |  CA  | Canada                                             | Canada (CA)                                          |
 |  CV  | Cape Verde                                         | Cape Verde (CV)                                      |
 |  KY  | Cayman Islands                                     | Cayman Islands (KY)                                  |
 |  CF  | Central African Republic                           | Central African Republic (CF)                        |
 |  TD  | Chad                                               | Chad (TD)                                            |
 |  CL  | Chile                                              | Chile (CL)                                           |
 |  CN  | China                                              | China (CN)                                           |
 |  CX  | Christmas Island                                   | Christmas Island (CX)                                |
 |  CC  | Cocos (Keeling) Islands                            | Cocos (Keeling) Islands (CC)                         |
 |  CO  | Colombia                                           | Colombia (CO)                                        |
 |  KM  | Comoros                                            | Comoros (KM)                                         |
 |  CG  | Congo                                              | Congo (CG)                                           |
 |  CD  | Congo, The Democratic Republic of the              | Congo, The Democratic Republic of the (CD)           |
 |  CK  | Cook Islands                                       | Cook Islands (CK)                                    |
 |  CR  | Costa Rica                                         | Costa Rica (CR)                                      |
 |  CI  | Côte d'Ivoire                                      | Côte d'Ivoire (CI)                                   |
 |  HR  | Croatia                                            | Croatia (HR)                                         |
 |  CU  | Cuba                                               | Cuba (CU)                                            |
 |  CW  | Curaçao                                            | Curaçao (CW)                                         |
 |  CY  | Cyprus                                             | Cyprus (CY)                                          |
 |  CZ  | Czech Republic                                     | Czech Republic (CZ)                                  |
 |  DK  | Denmark                                            | Denmark (DK)                                         |
 |  DJ  | Djibouti                                           | Djibouti (DJ)                                        |
 |  DM  | Dominica                                           | Dominica (DM)                                        |
 |  DO  | Dominican Republic                                 | Dominican Republic (DO)                              |
 |  EC  | Ecuador                                            | Ecuador (EC)                                         |
 |  EG  | Egypt                                              | Egypt (EG)                                           |
 |  SV  | El Salvador                                        | El Salvador (SV)                                     |
 |  GQ  | Equatorial Guinea                                  | Equatorial Guinea (GQ)                               |
 |  ER  | Eritrea                                            | Eritrea (ER)                                         |
 |  EE  | Estonia                                            | Estonia (EE)                                         |
 |  ET  | Ethiopia                                           | Ethiopia (ET)                                        |
 |  FK  | Falkland Islands (Malvinas)                        | Falkland Islands (Malvinas) (FK)                     |
 |  FO  | Faroe Islands                                      | Faroe Islands (FO)                                   |
 |  FJ  | Fiji                                               | Fiji (FJ)                                            |
 |  FI  | Finland                                            | Finland (FI)                                         |
 |  FR  | France                                             | France (FR)                                          |
 |  GF  | French Guiana                                      | French Guiana (GF)                                   |
 |  PF  | French Polynesia                                   | French Polynesia (PF)                                |
 |  TF  | French Southern Territories                        | French Southern Territories (TF)                     |
 |  GA  | Gabon                                              | Gabon (GA)                                           |
 |  GM  | Gambia                                             | Gambia (GM)                                          |
 |  GE  | Georgia                                            | Georgia (GE)                                         |
 |  DE  | Germany                                            | Germany (DE)                                         |
 |  GH  | Ghana                                              | Ghana (GH)                                           |
 |  GI  | Gibraltar                                          | Gibraltar (GI)                                       |
 |  GR  | Greece                                             | Greece (GR)                                          |
 |  GL  | Greenland                                          | Greenland (GL)                                       |
 |  GD  | Grenada                                            | Grenada (GD)                                         |
 |  GP  | Guadeloupe                                         | Guadeloupe (GP)                                      |
 |  GU  | Guam                                               | Guam (GU)                                            |
 |  GT  | Guatemala                                          | Guatemala (GT)                                       |
 |  GG  | Guernsey                                           | Guernsey (GG)                                        |
 |  GN  | Guinea                                             | Guinea (GN)                                          |
 |  GW  | Guinea-Bissau                                      | Guinea-Bissau (GW)                                   |
 |  GY  | Guyana                                             | Guyana (GY)                                          |
 |  HT  | Haiti                                              | Haiti (HT)                                           |
 |  HM  | Heard Island and McDonald Islands                  | Heard Island and McDonald Islands (HM)               |
 |  VA  | Holy See (Vatican City State)                      | Holy See (Vatican City State) (VA)                   |
 |  HN  | Honduras                                           | Honduras (HN)                                        |
 |  HK  | Hong Kong                                          | Hong Kong (HK)                                       |
 |  HU  | Hungary                                            | Hungary (HU)                                         |
 |  IS  | Iceland                                            | Iceland (IS)                                         |
 |  IN  | India                                              | India (IN)                                           |
 |  ID  | Indonesia                                          | Indonesia (ID)                                       |
 |  IR  | Iran, Islamic Republic of                          | Iran, Islamic Republic of (IR)                       |
 |  IQ  | Iraq                                               | Iraq (IQ)                                            |
 |  IE  | Ireland                                            | Ireland (IE)                                         |
 |  IM  | Isle of Man                                        | Isle of Man (IM)                                     |
 |  IL  | Israel                                             | Israel (IL)                                          |
 |  IT  | Italy                                              | Italy (IT)                                           |
 |  JM  | Jamaica                                            | Jamaica (JM)                                         |
 |  JP  | Japan                                              | Japan (JP)                                           |
 |  JE  | Jersey                                             | Jersey (JE)                                          |
 |  JO  | Jordan                                             | Jordan (JO)                                          |
 |  KZ  | Kazakhstan                                         | Kazakhstan (KZ)                                      |
 |  KE  | Kenya                                              | Kenya (KE)                                           |
 |  KI  | Kiribati                                           | Kiribati (KI)                                        |
 |  KP  | Korea, Democratic People's Republic of             | Korea, Democratic People's Republic of (KP)          |
 |  KR  | Korea, Republic of                                 | Korea, Republic of (KR)                              |
 |  KW  | Kuwait                                             | Kuwait (KW)                                          |
 |  KG  | Kyrgyzstan                                         | Kyrgyzstan (KG)                                      |
 |  LA  | Lao People's Democratic Republic                   | Lao People's Democratic Republic (LA)                |
 |  LV  | Latvia                                             | Latvia (LV)                                          |
 |  LB  | Lebanon                                            | Lebanon (LB)                                         |
 |  LS  | Lesotho                                            | Lesotho (LS)                                         |
 |  LR  | Liberia                                            | Liberia (LR)                                         |
 |  LY  | Libya                                              | Libya (LY)                                           |
 |  LI  | Liechtenstein                                      | Liechtenstein (LI)                                   |
 |  LT  | Lithuania                                          | Lithuania (LT)                                       |
 |  LU  | Luxembourg                                         | Luxembourg (LU)                                      |
 |  MO  | Macao                                              | Macao (MO)                                           |
 |  MK  | Macedonia, The Former Yugoslav Republic of         | Macedonia, The Former Yugoslav Republic of (MK)      |
 |  MG  | Madagascar                                         | Madagascar (MG)                                      |
 |  MW  | Malawi                                             | Malawi (MW)                                          |
 |  MY  | Malaysia                                           | Malaysia (MY)                                        |
 |  MV  | Maldives                                           | Maldives (MV)                                        |
 |  ML  | Mali                                               | Mali (ML)                                            |
 |  MT  | Malta                                              | Malta (MT)                                           |
 |  MH  | Marshall Islands                                   | Marshall Islands (MH)                                |
 |  MQ  | Martinique                                         | Martinique (MQ)                                      |
 |  MR  | Mauritania                                         | Mauritania (MR)                                      |
 |  MU  | Mauritius                                          | Mauritius (MU)                                       |
 |  YT  | Mayotte                                            | Mayotte (YT)                                         |
 |  MX  | Mexico                                             | Mexico (MX)                                          |
 |  FM  | Micronesia, Federated States of                    | Micronesia, Federated States of (FM)                 |
 |  MD  | Moldova, Republic of                               | Moldova, Republic of (MD)                            |
 |  MC  | Monaco                                             | Monaco (MC)                                          |
 |  MN  | Mongolia                                           | Mongolia (MN)                                        |
 |  ME  | Montenegro                                         | Montenegro (ME)                                      |
 |  MS  | Montserrat                                         | Montserrat (MS)                                      |
 |  MA  | Morocco                                            | Morocco (MA)                                         |
 |  MZ  | Mozambique                                         | Mozambique (MZ)                                      |
 |  MM  | Myanmar                                            | Myanmar (MM)                                         |
 |  NA  | Namibia                                            | Namibia (NA)                                         |
 |  NR  | Nauru                                              | Nauru (NR)                                           |
 |  NP  | Nepal                                              | Nepal (NP)                                           |
 |  NL  | Netherlands                                        | Netherlands (NL)                                     |
 |  NC  | New Caledonia                                      | New Caledonia (NC)                                   |
 |  NZ  | New Zealand                                        | New Zealand (NZ)                                     |
 |  NI  | Nicaragua                                          | Nicaragua (NI)                                       |
 |  NE  | Niger                                              | Niger (NE)                                           |
 |  NG  | Nigeria                                            | Nigeria (NG)                                         |
 |  NU  | Niue                                               | Niue (NU)                                            |
 |  NF  | Norfolk Island                                     | Norfolk Island (NF)                                  |
 |  MP  | Northern Mariana Islands                           | Northern Mariana Islands (MP)                        |
 |  NO  | Norway                                             | Norway (NO)                                          |
 |  OM  | Oman                                               | Oman (OM)                                            |
 |  PK  | Pakistan                                           | Pakistan (PK)                                        |
 |  PW  | Palau                                              | Palau (PW)                                           |
 |  PS  | Palestinian Territory, Occupied                    | Palestinian Territory, Occupied (PS)                 |
 |  PA  | Panama                                             | Panama (PA)                                          |
 |  PG  | Papua New Guinea                                   | Papua New Guinea (PG)                                |
 |  PY  | Paraguay                                           | Paraguay (PY)                                        |
 |  PE  | Peru                                               | Peru (PE)                                            |
 |  PH  | Philippines                                        | Philippines (PH)                                     |
 |  PN  | Pitcairn                                           | Pitcairn (PN)                                        |
 |  PL  | Poland                                             | Poland (PL)                                          |
 |  PT  | Portugal                                           | Portugal (PT)                                        |
 |  PR  | Puerto Rico                                        | Puerto Rico (PR)                                     |
 |  QA  | Qatar                                              | Qatar (QA)                                           |
 |  RE  | Réunion                                            | Réunion (RE)                                         |
 |  RO  | Romania                                            | Romania (RO)                                         |
 |  RU  | Russian Federation                                 | Russian Federation (RU)                              |
 |  RW  | Rwanda                                             | Rwanda (RW)                                          |
 |  BL  | Saint Barthélemy                                   | Saint Barthélemy (BL)                                |
 |  SH  | Saint Helena, Ascension and Tristan da Cunha       | Saint Helena, Ascension and Tristan da Cunha (SH)    |
 |  KN  | Saint Kitts and Nevis                              | Saint Kitts and Nevis (KN)                           |
 |  LC  | Saint Lucia                                        | Saint Lucia (LC)                                     |
 |  MF  | Saint Martin (French part)                         | Saint Martin (French part) (MF)                      |
 |  PM  | Saint Pierre and Miquelon                          | Saint Pierre and Miquelon (PM)                       |
 |  VC  | Saint Vincent and the Grenadines                   | Saint Vincent and the Grenadines (VC)                |
 |  WS  | Samoa                                              | Samoa (WS)                                           |
 |  SM  | San Marino                                         | San Marino (SM)                                      |
 |  ST  | Sao Tome and Principe                              | Sao Tome and Principe (ST)                           |
 |  SA  | Saudi Arabia                                       | Saudi Arabia (SA)                                    |
 |  SN  | Senegal                                            | Senegal (SN)                                         |
 |  RS  | Serbia                                             | Serbia (RS)                                          |
 |  SC  | Seychelles                                         | Seychelles (SC)                                      |
 |  SL  | Sierra Leone                                       | Sierra Leone (SL)                                    |
 |  SG  | Singapore                                          | Singapore (SG)                                       |
 |  SX  | Sint Maarten (Dutch part)                          | Sint Maarten (Dutch part) (SX)                       |
 |  SK  | Slovakia                                           | Slovakia (SK)                                        |
 |  SI  | Slovenia                                           | Slovenia (SI)                                        |
 |  SB  | Solomon Islands                                    | Solomon Islands (SB)                                 |
 |  SO  | Somalia                                            | Somalia (SO)                                         |
 |  ZA  | South Africa                                       | South Africa (ZA)                                    |
 |  GS  | South Georgia and the South Sandwich Islands       | South Georgia and the South Sandwich Islands (GS)    |
 |  SS  | South Sudan                                        | South Sudan (SS)                                     |
 |  ES  | Spain                                              | Spain (ES)                                           |
 |  LK  | Sri Lanka                                          | Sri Lanka (LK)                                       |
 |  SD  | Sudan                                              | Sudan (SD)                                           |
 |  SR  | Suriname                                           | Suriname (SR)                                        |
 |  SJ  | Svalbard and Jan Mayen                             | Svalbard and Jan Mayen (SJ)                          |
 |  SZ  | Swaziland                                          | Swaziland (SZ)                                       |
 |  SE  | Sweden                                             | Sweden (SE)                                          |
 |  CH  | Switzerland                                        | Switzerland (CH)                                     |
 |  SY  | Syrian Arab Republic                               | Syrian Arab Republic (SY)                            |
 |  TW  | Taiwan, Province of China                          | Taiwan, Province of China (TW)                       |
 |  TJ  | Tajikistan                                         | Tajikistan (TJ)                                      |
 |  TZ  | Tanzania, United Republic of                       | Tanzania, United Republic of (TZ)                    |
 |  TH  | Thailand                                           | Thailand (TH)                                        |
 |  TL  | Timor-Leste                                        | Timor-Leste (TL)                                     |
 |  TG  | Togo                                               | Togo (TG)                                            |
 |  TK  | Tokelau                                            | Tokelau (TK)                                         |
 |  TO  | Tonga                                              | Tonga (TO)                                           |
 |  TT  | Trinidad and Tobago                                | Trinidad and Tobago (TT)                             |
 |  TN  | Tunisia                                            | Tunisia (TN)                                         |
 |  TR  | Turkey                                             | Turkey (TR)                                          |
 |  TM  | Turkmenistan                                       | Turkmenistan (TM)                                    |
 |  TC  | Turks and Caicos Islands                           | Turks and Caicos Islands (TC)                        |
 |  TV  | Tuvalu                                             | Tuvalu (TV)                                          |
 |  UG  | Uganda                                             | Uganda (UG)                                          |
 |  UA  | Ukraine                                            | Ukraine (UA)                                         |
 |  AE  | United Arab Emirates                               | United Arab Emirates (AE)                            |
 |  GB  | United Kingdom                                     | United Kingdom (GB)                                  |
 |  US  | United States                                      | United States (US)                                   |
 |  UM  | United States Minor Outlying Islands               | United States Minor Outlying Islands (UM)            |
 |  UY  | Uruguay                                            | Uruguay (UY)                                         |
 |  UZ  | Uzbekistan                                         | Uzbekistan (UZ)                                      |
 |  VU  | Vanuatu                                            | Vanuatu (VU)                                         |
 |  VE  | Venezuela, Bolivarian Republic of                  | Venezuela, Bolivarian Republic of (VE)               |
 |  VN  | Viet Nam                                           | Viet Nam (VN)                                        |
 |  VG  | Virgin Islands, British                            | Virgin Islands, British (VG)                         |
 |  VI  | Virgin Islands, U.S.                               | Virgin Islands, U.S. (VI)                            |
 |  WF  | Wallis and Futuna                                  | Wallis and Futuna (WF)                               |
 |  EH  | Western Sahara                                     | Western Sahara (EH)                                  |
 |  YE  | Yemen                                              | Yemen (YE)                                           |
 |  ZM  | Zambia                                             | Zambia (ZM)                                          |
 |  ZW  | Zimbabwe                                           | Zimbabwe (ZW)                                        |
 +------+----------------------------------------------------+------------------------------------------------------+
Parameter

Specify "true" to enable the RIR SWIP feature or "false" to disable it. Default value is "false".

Returns

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.

Example
 #Get enable_rir_swip
 my $enable_rir_swip = $grid->enable_rir_swip();
 #Modify enable_rir_swip
 $grid->enable_rir_swip("true");

enable_snmpv3_query( )

Use this method to enable or disable SNMPv3 queries.

Parameter

Specify "true" to enable SNMPv3 queries or "false" to disable it.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get enable_snmpv3_query
 my $enable_snmpv3_query = $grid->enable_snmpv3_query();
 #Modify enable_snmpv3_query
 $grid->enable_snmpv3_query("false");

enable_snmpv3_traps( )

Use this method to enable or disable SNMPv3 traps.

Parameter

Specify "true" to enable SNMPv3 traps or "false" to disable it. Default value is "false".

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get enable_snmpv3_traps
 my $enable_snmpv3_traps = $grid->enable_snmpv3_traps();
 #Modify enable_snmpv3_traps
 $grid->enable_snmpv3_traps("true");

enable_security_access( )

Use this method to enable or disable the security access.

Parameter

Specify "true" to enable the security access or "false" to disable it. Default value is "false".

Returns

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.

Example
 #Get enable_security_access
 my $enable_security_access = $grid->enable_security_access();
 #Modify enable_security_access
 $grid->enable_security_access("true");

external_syslog_server_enable( )

Use this method to set or retrieve the flag that indicates whether external syslog servers are enabled.

The external_syslog_server_enable attribute can be specified explicitly. It is also set implicitly when syslog_server is set to a defined value.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Specify 'true' to enable external syslog servers and 'false' to disable them.

Returns

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.

Example
 #Get external_syslog_server_enable value 
 my $value = $object->external_syslog_server_enable();
 #Modify external_syslog_server_enable value
 $object->external_syslog_server_enable('true');

http_proxy_server_setting( )

Use this method to set or retreive the Grid HTTP proxy server settings.

Parameter

The valid value is an Infoblox::Grid::HTTPProxyServerSetting object.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get http_proxy_server_setting value
 my $http_proxy_server_setting = $grid->http_proxy_server_setting();
 #Modify http_proxy_server_setting value
 $grid->http_proxy_server_setting($http_proxy_setting);

informational_banner_setting( )

Use this method to set or retrieve the Grid informational banner settings.

Parameter

An Infoblox::Grid::InformationalBannerSetting object.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Enable the informational banner
 my $banner = Infoblox::Grid::InformationalBannerSetting->new(enable => 'true', message => 'Informational message', color = > 'GREEN');
 $grid->informational_banner_setting($banner);

is_grid_visualization_visible( )

Use this method to enable or disable graphical visualization of the Grid. The default value is 'false'.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Specify 'true' to enable graphical visualization of the Grid or 'false' to disable it.

Returns

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.

Example
 #Get is_grid_visualization_visible
 my $is_grid_visualization_visible = $grid->is_grid_visualization_visible();
 #Modify is_grid_visualization_visible
 $grid->is_grid_visualization_visible('true');

lcd_input( )

Use this method to enable/disable LCD (Liquid Crystal Display) input. Default value is "true".

Parameter

Specify "true" to enable LCD input or "false" to disable it.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get lcd_input
 my $lcd = $grid->lcd_input();
 #Modify lcd_input
 $grid->lcd_input("false");

login_banner_text( )

Use this method to set or retrieve the login banner text.

Parameter

The login banner text.

Returns

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.

Example
 #Get login_banner_text
 my $login_banner_text = $grid->login_banner_text();
 #Modify login_banner_text
 $grid->login_banner_text('Your login banner text');

lom_users( )

Use this method to set or retrieve the list of users for the LOM functionality.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Valid value is an array reference that contains Infoblox::Grid::LOM::User objects.

Returns

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.

Example
 #Get lom_users from the grid
 my $users = $grid->lom_users();
 #Modify the lom users
 $grid->lom_users([$u1, $u2]);

mgm_strict_delegate_mode( )

Use this method to enable/disable strict delegate mode for a grid managed by the Master Grid.

Parameter

Specify "true" to enable strict delegate mode or "false" to disable it. Default value is "false".

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get mgm_strict_delegate_mode
 my $delegated = $grid->mgm_strict_delegate_mode();
 #Modify mgm_strict_delegate_mode
 $grid->mgm_strict_delegate_mode ("true");

ms_default_ip_site_link( )

Use this method set or retrieve the default IP site link for sites created from NIOS for all Microsoft servers.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Valid value is a string with the default IP site link name.

Returns

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.

Example
 #Get ms_default_ip_site_link value
 my $default_ip_site_link = $grid->ms_default_ip_site_link();
 #Modify ms_default_ip_site_link value
 $grid->ms_default_ip_site_link('Site1');

ms_enable_invalid_mac( )

Use this method to allow invalid MAC address synchronization for DHCP leases and fixed addresses.

Parameter

Specify "true" to allow invalid MAC address synchronization or "false" to forbid it. Default value is "false".

Returns

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.

Example
 #Get ms_enable_invalid_mac value
 my $enable_invalid_mac = $grid->ms_enable_invalid_mac();
 #Modify ms_enable_invalid_mac value
 $grid->ms_enable_invalid_mac("true");

ms_enable_dhcp_monitoring( )

Use this method to enable or disable the monitoring and control of DHCP service on all Microsoft servers in the Grid.

Parameter

Specify "true" to enable monitoring and control of DHCP service on all Microsoft servers in the Grid and "false" to forbid it. Default value is "false".

Returns

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.

Example
 #Get ms_enable_dhcp_monitoring value
 my $enable_dhcp_monitoring = $grid->ms_enable_dhcp_monitoring();
 #Modify ms_enable_dhcp_monitoring value
 $grid->ms_enable_dhcp_monitoring("true");

ms_enable_dns_monitoring( )

Use this method to enable or disable the monitoring and control of DNS service on all Microsoft servers in the Grid.

Parameter

Specify "true" to enable monitoring and control of DNS service on all Microsoft servers in the Grid and "false" to forbid it. Default value is "false".

Returns

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.

Example
 #Get ms_enable_dns_monitoring value
 my $enable_dns_monitoring = $grid->ms_enable_dns_monitoring();
 #Modify ms_enable_dns_monitoring value
 $grid->ms_enable_dns_monitoring("true");

ms_enable_dns_reports_sync( )

Use this method to enable or disable the synchronization of DNS reporting data from all Microsoft servers in the Grid.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Specify "true" to enable the synchronization of DNS reporting data from all Microsoft servers in the Grid. Specify "false" to disable the synchronization of DNS reporting data from all Microsoft servers in the Grid. Default value is "true".

Returns

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.

Example
 #Get ms_enable_dns_reports_sync
 my $enable_dns_reports_sync = $grid->ms_enable_dns_reports_sync();
 #Modify ms_enable_dns_reports_sync
 $grid->ms_enable_dns_reports_sync("true");

ms_enable_network_users( )

Use this method to enable or disable Network Users creation.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Specify "true" to enable network users creation for all Microsoft servers in the Grid and "false" to forbid it. Default value is "false".

Returns

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.

Example
 #Get ms_enable_network_users value
 my $enable_network_users = $grid->ms_enable_network_users();
 #Modify ms_enable_network_users value
 $grid->ms_enable_network_users('true');

ms_enable_user_sync( )

Use this method to enable or disable Active Directory users synchronization for all Microsoft servers in the Grid.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Specify "true" to enable Active Directory users synchronization for all Microsoft servers in the Grid and "false" to forbid it. Default value is "false".

Returns

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.

Example
 #Get ms_enable_user_sync value
 my $enable_user_sync = $grid->ms_enable_user_sync();
 #Modify ms_enable_user_sync value
 $grid->ms_enable_user_sync('true');

ms_ldap_timeout( )

Use this method to set or retrieve an LDAP connection timeout interval in seconds for all Microsoft servers.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Valid value is an unsigned integer. Default value is 10.

Returns

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.

Example
 #Get ms_ldap_timeout value
 my $ldap_timeout = $grid->ms_ldap_timeout();
 #Modify ms_ldap_timeout value
 $grid->ms_ldap_timeout(10);

ms_log_destination( )

Use this method to direct the logging of synchronization messages to the syslog or mslog.

Parameter

Valid values are "SYSLOG" and "MSLOG".

Returns

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.

Example
 #Get ms_log_destination value
 my $log_destination = $grid->ms_log_destination();
 #Modify ms_log_destination value
 $grid->ms_log_destination("SYSLOG");

ms_max_connection( )

Use this method to set or retrieve the maximum number of connections to Microsoft servers.

Parameter

Valid values are integers between 2 and 40 inclusive.

Returns

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.

Example
 #Get ms_max_connection value
 my $max_connection = $grid->ms_max_connection();
 #Modify ms_max_connection value
 $grid->ms_max_connection(20);

ms_rpc_timeout( )

Use this method to set or retrieve timeout in seconds for RPC connections to all Microsoft servers.

Parameter

Valid values are integers between 0 and 65535 inclusive.

Returns

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.

Example
 #Get ms_rpc_timeout value
 my $rpc_timeout = $grid->ms_rpc_timeout();
 #Modify ms_rpc_timeout value
 $grid->ms_rpc_timeout(10);

ms_user_default_timeout( )

Use this method to set or retrieve the default timeout in seconds for Active Directory users synchronization for all Microsoft servers.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

The valid value is an unsigned integer.

Returns

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.

Example
 #Get ms_user_default_timeout value
 my $user_default_timeout = $grid->ms_user_default_timeout();
 #Modify ms_user_default_timeout value
 $grid->ms_user_default_timeout(10);

name( )

Use this method to set or retrieve the grid name.

Parameter

String with the name of the grid.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get name
 my $name = $grid->name();
 #Modify name
 $grid->name("InfobloxGrid");

nat_group_list( )

Use this method to set or retrieve the NAT (Network Address Translation) group list.

Parameter

Array reference that contains each Infoblox::Grid::NatGroup object. The default value is empty.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Add a new nat_group_list
 my $nat1 = Infoblox::Grid::NatGroup->new( "name" => "natgroup" ,
                                           "comment" => "new NAT group" );
 $grid->nat_group_list( [$nat1] );
 #To undefined the nat_group_list
 $grid->nat_group_list([ ]);

notification_email_addr( )

Use this method to set or retrieve the notification e-mail address.

Parameter

Text with the e-mail address of the administrator.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get notification_email_addr
 my $email = $grid->notification_email_addr();
 #Modify notification_email_addr
 $grid->notification_email_addr("admin\@domain.com");

ntp_server( )

Use this method to set or retrieve the NTP ( Network Time Protocol) server list. Only valid when enable_ntp is set to "true".

Parameter

Array reference that contains Infoblox::Grid::NTPServer objects.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Add a new ntp_server
 my $ntp_server1 = Infoblox::Grid::NTPServer->new(address => "1.1.1.1");
 my $ntp_server2 = Infoblox::Grid::NTPServer->new(address => "2.2.2.2");
 $grid->ntp_server([$ntp_server1, $ntp_server2]);

ntp_access_list( )

Use this method to set or retrieve the NTP ( Network Time Protocol) access control list. Only valid when enable_ntp is set to "true".

Parameter

Valid value is an Infoblox::Grid::NamedACL object or an array reference that contains Infoblox::Grid::NTPAccess objects.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get ntp_access_list
 my @ntp_access_list = $grid->ntp_access_list();
 #Modify ntp_access_list
 $grid->ntp_access_list([$ntpac1,$ntpac2]);
 #To undefined ntp_access_list
 $grid->ntp_access_list([ ]);
 #Use Infoblox::Grid::NamedACL
 $grid->ntp_access_list($nacl);

ntp_service_type( )

Use this method to set or retrieve the NTP service type for assigned Named ACL object.

The attribute value is ignored if 'ntp_access_list' attribute is not a Named ACL object.

Parameter

Valid values are "Time" or "Time and NTP control". The default value is "Time".

Returns

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.

Example
 #Get ntp_service_type
 my $service = $grid->ntp_service_type();
 #Modify ntp_service_type
 $grid->ntp_service_type("Time and NTP control");

ntp_authentication_key( )

Use this method to set or retrieve the NTP ( Network Time Protocol) authentication keys of the grid. Only valid when enable_ntp is set to "true".

Parameter

Valid value is an array reference that contains Infoblox::Grid::NTPKey objects.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Add a new ntp_authentication_key
 my $ntp_key1 = Infoblox::Grid::NTPKey->new(
            key_number => "1111",
            key_type   => "M",
            key_string => "aaaa"
        );
 my $ntp_key2 = Infoblox::Grid::NTPKey->new(
            key_number => "2222",
            key_type   => "n",
            key_string => "d3e54352e5548080"
        );
 $grid->ntp_authentication_key([$ntp_key1, $ntp_key2]);
 #To undefined ntp_authentication_key
 $grid->ntp_authentication_key(undef);

ntp_kod( )

Use this method to enable Kiss-o'-Death packets on the NTP server.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Specify "true" to enable Kiss-o'-Death packets on the NTP server or "false" to disable them. The default value is "false".

Returns

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.

Example
 #Get the current value of the ntp_kod parameter
 my $ntp_kod = $grid->ntp_kod();
 #Set the ntp_kod parameter
 $grid->ntp_kod("true");

objects_changes_tracking_setting( )

Use this method to set or retrieve the object changes tracking setting.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

The valid value is an Infoblox::Grid::ObjectsChangesTrackingSetting object.

Returns

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.

Example
 #Get objects_changes_tracking_setting value
 my $value = $object->objects_changes_tracking_setting();
 #Construct objects_changes_tracking_setting value
 my $objects_changes_tracking_setting = Infoblox::Grid::ObjectsChangesTrackingSetting->new(
     enable => 'true',
 );
 #Modify objects_changes_tracking_setting value
 $object->objects_changes_tracking_setting($objects_changes_tracking_setting);

password_chars_to_change( )

Use this method to set or retrieve the minimum required character changes from the previous user password.

Parameter

Valid values are between 0 and 64. The default value is 0.

Returns

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.

Example
 #Get password_chars_to_change
 my $password_chars_to_change = $obj->password_chars_to_change();
 #Modify password_chars_to_change
 $obj->password_chars_to_change(6);

password_expire_days( )

Use this parameter to set the number of days that a password is valid. This parameter will be ignored if password_expiration_enable is not set to "true".

Parameter

The parameter is a number of days of password validity. The default value is 30.

Returns

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.

Example
 #Get the current value of the password_expire_days
 my $passw_expiration = $grid->password_expire_days();
 #Set the password_expire_days parameter
 $grid->password_expire_days(120);

password_expire_enable( )

Use this parameter to enable password expiration.

Parameter

Setting the parameter to "true" enables user passwords to expire. Setting the parameter to "false" enables user passwords to remain valid indefinitely. The default value is "false".

Returns

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.

Example
 #Get the current value of the password_expire_enable parameter
 my $passw_expiration = $grid->password_expire_enable();
 #Set the password_expire_enable parameter
 $grid->password_expire_enable("true");

password_force_reset( )

Use this parameter to force users to reset their passwords when they first log in.

Parameter

Setting the parameter to "true" forces users to reset their passwords when they first log in. Setting the parameter to "false" allows the new user to keep the admin-defined password. The default value is "false".

Returns

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.

Example
 #Get the current value of the password_force_reset parameter
 my $passw_force_reset = $grid->password_force_reset();
 #Set the password_force_reset parameter
 $grid->password_force_reset("true");

password_min_length( )

Use this method to set or retrieve the minimum user password length.

Parameter

Valid values are between 4 and 64.

Returns

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.

Example
 #Get password_min_length
 my $password_min_length = $obj->password_min_length();
 #Modify password_min_length
 $obj->password_min_length(6);

password_num_lower_char( )

Use this method to set or retrieve the required minimum number of lowercase characters in a user password.

Parameter

Valid values are between 0 and 64. The default value is 0. Note that the total of password_num_lower_char, password_num_upper_char, password_num_numeric_char and password_num_symbol_char must not exceed password_min_length.

Returns

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.

Example
 #Get password_num_lower_char
 my $password_num_lower_char = $obj->password_num_lower_char();
 #Modify password_num_lower_char
 $obj->password_num_lower_char(6);

password_num_numeric_char( )

Use this method to set or retrieve the required minimum number of numeric characters in a user password.

Parameter

Valid values are between 0 and 64. The default value is 0. Note that the total of password_num_lower_char, password_num_upper_char, password_num_numeric_char and password_num_symbol_char must not exceed password_min_length.

Returns

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.

Example
 #Get password_num_numeric_char
 my $password_num_numeric_char = $obj->password_num_numeric_char();
 #Modify password_num_numeric_char
 $obj->password_num_numeric_char(6);

password_num_symbol_char( )

Use this method to set or retrieve the required minimum number of symbol (non-alphanumeric) characters in a user password.

Parameter

Valid values are between 0 and 64. The default value is 0. Note that the total of password_num_lower_char, password_num_upper_char, password_num_numeric_char and password_num_symbol_char must not exceed password_min_length.

Returns

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.

Example
 #Get password_num_symbol_char
 my $password_num_symbol_char = $obj->password_num_symbol_char();
 #Modify password_num_symbol_char
 $obj->password_num_symbol_char(6);

password_num_upper_char( )

Use this method to set or retrieve the required minimum number of uppercase characters in a user password.

Parameter

Valid values are between 0 and 64. The default value is 0. Note that the total of password_num_lower_char, password_num_upper_char, password_num_numeric_char and password_num_symbol_char must not exceed password_min_length.

Returns

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.

Example
 #Get password_num_upper_char
 my $password_num_upper_char = $obj->password_num_upper_char();
 #Modify password_num_upper_char
 $obj->password_num_upper_char(6);

password_reminder_days( )

Use this method to set the number of days before a password expires that the appliance starts displaying password change reminders. This parameter will be ignored if password_expiration_enable is "false".

Parameter

The parameter is a number of days before password expiration when the user get a reminder to change password. The default value is 7. Note that password_reminder_days must be lower than password_expire_days.

Returns

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.

Example
 #Get the current value of the password_reminder_days parameter
 my $passw_reminder= $grid->password_reminder_days();
 #Set the password_reminder_days parameter
 $grid->password_reminder_days(7);

prefer_resolver( )

Use this method to set or retrieve the preferred resolver.

Parameter

The valid values are Infoblox::DNS::Member object or Infoblox::DNS::Nameserver object.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get prefer_resolver
 my $prefer_resolver = $grid->prefer_resolver();
 #Modify prefer_resolver
 $grid->prefer_resolver("3.3.3.3");

query_comm_string ( )

Use this method to set or retrieve the SNMP (Simple Network Management Protocol) community string that management systems must send together with their queries to the Infoblox appliance. If this is set to undef, SNMP queries will be disabled.

Parameter

Text with the SNMP community string.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get query_comm_string
 my $query_comm_string = $grid->query_comm_string();
 #Modify query_comm_string
 $grid->query_comm_string("private");

remote_console_access( )

Use this method to enable/disable remote console access.

Parameter

Specify "true" to enable remote console access or "false" to disable it.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get remote_console_access
 my $remote_console_access = $grid->remote_console_access();
 #Modify remote_console_access
 $grid->remote_console_access("false");

restart_banner_setting( )

Use this method to set or retrieve Grid restart banner setting.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

The valid value is an Infoblox::Grid::RestartBannerSetting object.

Returns

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.

Example
 #Get restart_banner_setting
 $restart_banner_setting = $grid->restart_banner_setting();
 #Modify restart_banner_setting
 $grid->restart_banner_setting($banner);

restart_status( )

Use this method to retrieve the restart status of the Grid. This is a read-only attribute.

Omit the parameter to retrieve the attribute value.

Parameter

None

Returns

The valid return value is an Infoblox::Grid::ServiceRestart::Status object.

Example
 #Get restart_status
 $restart_status = $grid->restart_status();

rpz_hit_rate_interval( )

Use this method to set or retrieve the minimum time interval (in seconds) between changes in RPZ Hit Rate.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

The valid value is an unsigned integer greater than 1 that represents the number of seconds between changes in RPZ Hit Rate.

Returns

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.

Example
 # Get attribute value
 my $value = $grid->rpz_hit_rate_interval();
 # Modify attribute value
 $grid->rpz_hit_rate_interval(20);

rpz_hit_rate_min_query( )

Use this method to set or retrieve the minimum number of queries between RPZ Hit Rate checks.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

The valid value is an unsigned integer between 0 and 1073741824 that represents the minimum number of queries between changes in RPZ Hit Rate.

Returns

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.

Example
 # Get attribute value
 my $value = $grid->rpz_hit_rate_min_query();
 # Modify attribute value
 $grid->rpz_hit_rate_min_query(20);

rpz_hit_rate_max_query( )

Use this method to set or retrieve the maximum number of queries between RPZ Hit Rate checks.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

The valid value is an unsigned integer between 1 and 1073741824 that represents the maximum number of queries between changes in RPZ Hit Rate.

Returns

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.

Example
 # Get attribute value
 my $value = $grid->rpz_hit_rate_max_query();
 # Modify attribute value
 $grid->rpz_hit_rate_max_query(20);

search_domains( )

Use this method to set or retrieve the Search Domain Group, which is a group of domain names that the Infoblox device can add to partial queries that do not specify a domain name. Note that you can set this parameter only when prefer_resolver or alternate_resolver is set.

Parameter

Valid value is a reference to an array of strings.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get search_domains
 my $search_domains = $grid->search_domains();
 #Modify search_domains
 $grid->search_domains(["domain1.com", "domain2.com"]);

secret( )

Use this method to set the shared secret of the grid. This is a write-only attribute.

Parameter

Text with the shared secret of the grid.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Modify secret
 $grid->secret("shared secret");

service_status( )

Use this method to retrieve the overall service status of the Grid. This is a read-only attribute.

Parameter

None

Returns

The valid return values are 'FAILED', 'OFFLINE', 'INACTIVE', 'UNKNOWN', 'WARNING' and 'WORKING'.

Example
 #Get service_status
 $grid->service_status();

support_access( )

Use this method to enable/disable support access. Default value is "true".

Parameter

Specify "true" to enable support access or "false" to disable it.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get support_access
 my $support_access = $grid->support_access();
 #Modify support_access
 $grid->support_access("false");

support_access_info( )

Use this method to retrieve the information string for support access.

Parameter

None.

Returns

The method returns the attribute value.

Example
 #Get support_access_info
 my $support_access_info = $grid->support_access_info();

scheduled_backup( )

Use this method to retrieve the scheduled backup configuration.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Valid value is an Infoblox::Grid::ScheduledBackup object.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get scheduled_backup
 my $scheduled_backup = $grid->scheduled_backup();
 #Modify scheduled_backup
 $grid->scheduled_backup($scheduled_backup);

session_timeout( )

Use this method to set or retrieve the session timeout.

Parameter

Number that specifies the session timeout for the grid (range is from 60 to 31536000 seconds).

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get session_timeout
 my $session_timeout = $grid->session_timeout();
 #Modify session_timeout
 $grid->session_timeout("6000");

snmp_admin( )

Use this method to set or retrieve the SNMP admin object.

Parameter

Valid data type is an Infoblox::Grid::SNMP::Admin object.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Add a SNMP Admin object
 my $snmp = Infoblox::Grid::SNMP::Admin->new(
     sysContact  => "Somebody",
     sysLocation => "Infoblox Headquarter",
     sysName     => "noc1",
     sysDescr    => "SunOS noc1 5.6 Generic_105181-03 sun4u"
 );
 $grid->snmp_admin($snmp);
 #To undefined SNMP Admin object
 $grid->snmp_admin(undef);

snmpv3_query_users( )

Use this method to set or retrieve the SNMPv3 users from which the appliance accepts SNMP queries.

Parameter

Valid value is a reference to the list of the Infoblox::Grid::SNMP::User manpage objects.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get snmpv3_query_users field
 my $snmpv3_users = $grid->snmpv3_query_users();
 my $user = $$snmpv3_users[0];
 #Set snmpv3_query_users field
 $grid->snmpv3_query_users([$user1, $user2]);

syslog_backup_servers( )

Use this method to set or retrieve an array that contains syslog backup server settings for a Grid.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Valid value is an array reference that contains Infoblox::Grid::SyslogBackupServer objects.

Returns

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.

Example
 #get syslog_backup_servers value
 my $servers = $grid->syslog_backup_servers();
 #modify syslog_backup_servers value
 $grid->syslog_backup_servers([$server1, $server2]);

syslog_server( )

Use this method to set or retrieve the list of syslog servers.

Setting this method to a defined value implicitly sets the external_syslog_server_enable method to 'true'. Setting the parameter to undefined sets the external_syslog_server_enable method to 'false'.

Note that when syslog_server is set to a defined value and external_syslog_server_enable is set to 'false', the last operation takes precedence. Thus the sequence $object->syslog_server([$syslog]); $object->external_syslog_server_enable('false'); will set external_syslog_server_enable to 'false', and the sequence $object->external_syslog_server_enable('false'); $object->syslog_server([$syslog]); will result in external_syslog_server_enable='true'.

Include the specified parameter to set the attribute value. Omit the parameter to retrieve the attribute value.

Parameter

Array reference that contains Infoblox::Grid::SyslogServer objects.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 my $syslog1 = Infoblox::Grid::SyslogServer->new(
     ipv4addr => "44.44.44.44",
     severity => "debug",
 );
 my $syslog2 = Infoblox::Grid::SyslogServer->new(
     ipv4addr => "55.55.55.55",
     severity => "debug",
 );
 $grid->syslog_server([$syslog1, $syslog2]);

syslog_size( )

Use this method to set or retrieve the grid syslog rotation size in megabytes.

Parameter

Valid value is between 10 and 300.

Returns

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.

Example
 #Get syslog_size
 my $syslog_size = $obj->syslog_size();
 #Modify syslog_size
 $obj->syslog_size(100);

threshold_traps( )

Use this method to retrieve or modify the list of threshold traps. Each element in the list is a reference to the Infoblox::Grid::SNMP::ThresholdTrap object. All the possible threshold traps are in the list. The user can only change the values for each trap or remove traps.

Parameter

Reference to a list of Infoblox::Grid::SNMP::ThresholdTrap objects. The default value is a reference to a list of all threshold traps.

Returns

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.

Example
 #Get threshold traps
 my $threshold_traps = $grid->threshold_traps();
 #Modify threshold traps
 my $threshold_traps = $grid->threshold_traps();
 foreach(@$threshold_traps){if $_->trap_name() eq 'Rootfs'; $_->trap_reset=60;} #Change value for 'Rootfs' trap
 $grid->threshold_traps($threshold_traps);
 $session->modify($grid);

token_usage_delay( )

Use this method to set or retrieve the amount of time (in minutes) that the one-time security token for a pre-provisioned vNIOS member can stay unused before the appliance logs a warning message. The token_usage_delay has a life time of 60 minutes.

Parameter

The amount of time (in minutes) that the one-time security token for a pre-provisioned vNIOS member can stay unused before the appliance logs a warning message. Valid values must be between 1 and 60. The default value is 10.

Returns

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.

Example
 #Get token_usage_delay
 my $delay = $grid->token_usage_delay();
 #Modify token_usage_delay
 $grid->token_usage_delay("30");

trap_comm_string( )

Use this method to set or retrieve the trap community string. If this is set to undef, SNMP traps will be disabled.

Parameter

Text with the SNMP trap community string.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get trap_comm_string
 my $trap_comm_string = $grid->trap_comm_string();
 #Modify trap_comm_string
 $grid->trap_comm_string("public");

trap_notifications( )

Use this method to configure trap notifications. Each element in the list is a reference to the Infoblox::Grid::SNMP::TrapNotification object.

Parameter

Reference to a list of Infoblox::Grid::SNMP::TrapNotification objects. The default value is a reference to a list of all trap notifications.

Returns

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.

Example
 #Get a reference to trap notifications array
 my $trap_notifications = $grid->trap_notifications();
 #Modify trap notifications
 my $notifications = $grid->trap_notifications();
 foreach(@$notifications){if $_->trap_type() eq 'CPU'; $_->enable_email="true";} #Change value for 'CPU' trap
 $grid->trap_notifications($notifications);
 $session->modify($grid);

trap_receiver( )

Use this method to set or retrieve a trap receiver.

Parameter

Array reference that contains IPv4 addresses (example: 192.168.1.2) and the Infoblox::Grid::SNMP::TrapReceiver manpage objects.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

Example
 #Get trap_receiver
 my $trap_receiver = $grid->trap_receiver();
 #Modify trap receiver (SNMPv2)
 $grid->trap_receiver(["10.0.0.10"]);
 #SNMPv3 trap receivers
 my $receiver1 = Infoblox::Grid::SNMP::TrapReceiver->new( ip_addr => "19.20.21.22", user => $user);
 $grid->trap_receiver([$receiver1]);

updates_download_member_config( )

Use this method to set or retrieve the list of updates download member configurations.

Parameter

The valid value is array of Infoblox::Grid::UpdatesDownloadMemberConfig objects.

Returns

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.

Example
 #Get updates_download_member_config value
 my $updates_download_member_config = $grid->updates_download_member_config();
 #Modify updates_download_member_config value
 $grid->updates_download_member_config([$config1, $config2]);

vpn_port( )

Use this method to set or retrieve the VPN port.

Parameter

Number of the Virtual Private Network (VPN) port of the grid. Value must be between 1024 and 63999.

Returns

If you specified a parameter,the method returns true when the modification succeeds,and returns false when the operation fails.

Example
 #Get port
 my $port = $grid->vpn_port();
 #Modify vpn_port
 $grid->vpn_port("2000");


SAMPLE CODE

The following sample code demonstrates different operations that can be applied to an object, such create, modify, and remove an object. This sample code also includes error handling for the operations.

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

#Get and modify the Grid object.

 #Get a Grid through the session
 my $grid = $session->get(
     object => "Infoblox::Grid",
     name   => "Infoblox"
 );
 unless ($grid) {
     die("Get Grid failed: ",
         $session->status_code() . ":" . $session->status_detail());
 }
 #Modifying the value of the specified object.
 my $nat1 = Infoblox::Grid::NatGroup->new( "name" => "natgroup" ,
                                           "comment" => "new NAT group" );
 $grid->nat_group_list( [$nat1] );
 $grid->enable_ntp ("true");
 my $ntp_server1 = Infoblox::Grid::NTPServer->new(address => "2.2.2.2");
 $grid->ntp_server([$ntp_server1]);
 my $ntpac1 = Infoblox::Grid::NTPAccess->new(
                                             address => "2.2.2.2",
                                             service => "Time",
                                            );
 my $ntpac2 = Infoblox::Grid::NTPAccess->new(
                                             address => "4.4.4.4",
                                             service => "Time and NTP control",
                                            );
 $grid->ntp_access_list([$ntpac1,$ntpac2]);
 my $ntp_key1 = Infoblox::Grid::NTPKey->new(
            key_number => "1111",
            key_type   => "M",
            key_string => "aaaa"
        );
 my $ntp_key2 = Infoblox::Grid::NTPKey->new(
            key_number => "2222",
            key_type   => "n",
            key_string => "d3e54352e5548080"
        );
 $grid->ntp_authentication_key([$ntp_key1, $ntp_key2]);
 #Apply the changes
 $session->modify($grid)
     or die("Modify Grid failed: ",
            $session->status_code() . ":" . $session->status_detail());
 print "Grid object modified successfully \n";
 ####PROGRAM ENDS####


AUTHOR

Infoblox Inc. http://www.infoblox.com/


SEE ALSO

Infoblox::Session, Infoblox::Session->get(), Infoblox::Session->search(), Infoblox::Session->add(), Infoblox::Session->remove(), Infoblox::Session->modify(), Infoblox::Grid::NamedACL, Infoblox::Grid::ExtensibleAttributeDef::Descendants, Infoblox::Grid::SyslogBackupServer , Infoblox::DNS::View, Infoblox::DNS::Zone, Infoblox::Grid::LOM::User, Infoblox::Grid::ServiceRestart::Status, Infoblox::Grid::RestartBannerSetting


COPYRIGHT

Copyright (c) 2017 Infoblox Inc.