NAME

Brocade::BSC - Configure and query the Brocade SDN controller.

VERSION

Version 1.0.4

DESCRIPTION

A Brocade::BSC object is used to model, query, and configure Brocade's OpenDaylight-based Software-Defined Networking controller.

Most API methods return a duple: a Brocade::BSC::Status object, and a reference to a data structure with the requested information. Status should always be verified before attempting to dereference the second return value.

METHODS

new

Creates a new Brocade::BSC object and populates fields with values from argument hash, if present, or YAML configuration file.

  ### parameters:
  #   + cfgfile       - path to YAML configuration file specifying controller attributes
  #   + ipAddr        - IP address of controller
  #   + portNum       - TCP port for controller's REST interface
  #   + adminName     - username
  #   + adminPassword - password
  #   + timeout       - for HTTP requests, in seconds
  #
  ### YAML configuration file labels and default values
  #
  #   parameter hash | YAML label  | default value
  #   -------------- | ----------- | -------------
  #   ipAddr         | ctrlIpAddr  | 127.0.0.1
  #   portNum        | ctrlPortNum | 8181
  #   adminName      | ctrlUname   | admin
  #   adminPassword  | ctrlPswd    | admin
  #   timeout        | timeout     | 5

Returns new Brocade::BSC object.

as_json

  # Returns pretty-printed JSON string representing BSC object.

get_nodes_operational_list

  # Returns   : BSC::Status
  #           : reference to an array of node names

get_node_info

  # Parameter : node name (string, required)
  # Returns   : BSC::Status
  #           : array reference containing node info

check_node_config_status

  # Parameter : node name (string, required)
  # Returns   : BSC::Status - NODE_CONFIGURED or NODE_NOT_FOUND

check_node_conn_status

  # Parameter : node name (string, required)
  # Returns   : BSC::Status - NODE_CONNECTED or NODE_DISCONNECTED

get_all_nodes_in_config

  # Returns   : BSC::Status
  #           : array reference - list of node identifiers

get_all_nodes_conn_status

  # Returns   : BSC::Status
  #           : reference to array of hashes:
  #             { id        => nodename,
  #               connected => boolean }

get_netconf_nodes_in_config

  # Returns   : BSC::Status
  #           : array reference - list of node identifiers

get_all_nodes_conn_status

  # Returns   : BSC::Status
  #           : reference to array of hashes:
  #             { id        => nodename,
  #               connected => boolean }

get_schemas

  # Parameters: node name (string, required)
  # Returns   : BSC::Status
  #           : array reference - supported schemas on node

get_schema

  # Parameters: node name
  #           : YANG schema ID
  #           : YANG schema version
  # Returns   : BSC::Status
  #           : requested YANG schema as formatted JSON

get_netconf_operations

  # Parameters: node name
  # Returns   : BSC::Status
  #           : hash reference - operations supported by specified node

get_all_modules_operational_state

  # Returns   : BSC::Status
  #           : array reference - hashes of module state

get_module_operational_state

  # Parameter : module type
  #           : module name
  # Returns   : BSC::Status
  #           : array reference - hash of module state

get_sessions_info

  # Parameters: node name
  # Returns   : BSC::Status
  #           : hash reference - session listing on specified node

get_streams_info

  # Parameters:
  # Returns   : BSC::Status
  #           : hash reference - streams info

get_service_providers_info

  # Parameters:
  # Returns   : BSC::Status
  #           : array reference ~ name/provider pairs

get_service_provider_info

  # Parameters: node name
  # Returns   : BSC::Status
  #           : array reference ~ name/provider pairs

add_netconf_node

Add a mount point on controller for specified node.

  # Parameters: node name
  # Returns   : BSC::Status

delete_netconf_node

  # Parameters: node name
  # Returns   : BSC::Status
  #           :

get_ext_mount_config_urlpath

  # Parameters: node name
  # Returns   : base restconf URL for configuration of mounted netconf node

get_ext_mount_operational_urlpath

  # Parameters: node name
  # Returns   : base restconf URL for operational status of mounted netconf node

get_node_operational_urlpath

  # Parameters: node name
  # Returns   : base restconf URL for node, operational status

get_node_config_urlpath

  # Parameters: node name
  # Returns   : base restconf URL for node, configuration

get_openflow_nodes_operational_list

  # Returns   : BSC::Status
  #           : array reference - node names

AUTHOR

<pruiklw at cpan.org>

BUGS

Please report any bugs or feature requests to bug-brocade-bsc at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Brocade-BSC. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Brocade::BSC

You can also look for information at:

• RT: CPAN's request tracker (report bugs here)

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Brocade-BSC

ACKNOWLEDGEMENTS

Brocade::BSC is entirely based on pybvc created by Sergei Garbuzov.

COPYRIGHT

Copyright (c) 2015, BROCADE COMMUNICATIONS SYSTEMS, INC

All rights reserved.