Infoblox::Grid::SyslogBackupServer - Syslog Backup Server object.


NAME

Infoblox::Grid::SyslogBackupServer - Syslog Backup Server object.


DESCRIPTION

The Syslog Backup Server object contains configuration for external servers that are used for replication of rotated log files through SCP or FTP.


CONSTRUCTOR

 my $syslog_backup_server = Infoblox::Grid::SyslogBackupServer->new(
     address        => $ipv4addr | $ipv6addr, # Optional
     directory_path => $string,               # Optional
     enable         => 'true' | 'false',      # Optional
     password       => $string,               # Optional
     port           => $uint,                 # Optional
     protocol       => 'SCP' | 'FTP',         # Optional
     username       => $string,               # Optional
 );


MODULE METHODS

The following functions are available to be applied to a syslog backup server object.

Infoblox::Grid->syslog_backup_servers( )

Use this method to set or retrieve an array that contains Grid-level syslog backup server settings. See Infoblox::Grid->syslog_backup_servers() for parameters and return values.

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

Infoblox::Grid::Member->syslog_backup_servers( )

Use this method to set or retrieve an array that contains syslog backup server settings for a Grid member. See Infoblox::Grid::Member->syslog_backup_servers() for parameters and return values.

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


METHODS

address( )

Use this method to set or retrieve the IPv4 or IPv6 address of a syslog backup server.

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

Parameter

An IPv4 address is a 32-bit number in dotted decimal notation. It consists of four 8-bit groups of decimal digits separated by decimal points (example: 192.168.1.2).

An IPv6 address is a 128-bit number represented as eight groups of four hexadecimal digits (i.e. two octets), with each group separated by a colon(:) (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334). Leading zeroes and groups of consecutive zeros within the value can be omitted to produce a more compact representation (example: 2001::1, ::1).

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 address value
 my $address = $server->address();
 #modify address value
 $server->address('192.168.1.5');

directory_path( )

Use this method to set or retrieve the path for rotated syslog file replication.

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

Parameter

The valid value is a desired path in a string format.

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 directory_path value
 my $directory_path = $server->directory_path();
 #modify directory_path value
 $server->directory_path('/path/to/directory');

enable( )

Use this method to enable or disable the syslog backup server.

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

Parameter

Specify 'true' to enable syslog backup server 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 value
 my $enable = $server->enable();
 #modify enable value
 $server->enable('true');

password( )

Use this method to set the syslog backup server password. This is a write-only attribute.

Include the specified parameter to set the attribute value.

Parameter

The valid value is a desired password in a string format.

Returns

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

Example
 #modify password value
 $server->password('infoblox');

port( )

Use this method to set or retrieve the transport layer port for connection to the syslog backup server.

Include the specified parameter to set the attribute value.

Parameter

The valid value is an unsigned integer between 0 and 65535.

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 port value
 my $port = $server->port();
 #modify port value
 $server->port(22);

protocol( )

Use this method to set or retireve the transport layer protocol for the syslog backup server connection.

Include the specified parameter to set the attribute value.

Parameter

The valid values are 'FTP' and 'SCP'.

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 protocol value
 my $protocol = $server->protocol();
 #modify protocol value
 $server->protocol('SCP');

username( )

Use this method to set or retrieve the username for the syslog backup server.

Include the specified parameter to set the attribute value.

Parameter

Valid value is a desired username in string format.

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 username value
 my $username = $server->username();
 #modify username value
 $server->username('admin');


AUTHOR

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


SEE ALSO

Infoblox::Grid, Infoblox::Grid::Member


COPYRIGHT

Copyright (c) 2017 Infoblox Inc.