Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Enabling IP address management - revised

This section describes how to enable IP address management (IPAM) for your environment. You can use the integrated IPAM system in BMC Network Automation, or you can enable an interface between BMC Network Automation and a third-party IPAM system. BMC Atrium Orchestrator is used as a middle tier between BMC Network Automation and the third-party IPAM system. BMC Network Automation currently supports the use of the the Infoblox IPAM and Alcatel-Lucent VitalQIP IPAM products as third-party IPAM solutions.

Managing the BMC Network Automation integrated IPAM system

The following topics describe how to manage the integrated IPAM system that is installed with BMC Network Automation.

Viewing the IP address pools

You can view the IP address pools by navigating to Admin > IP Address Management > IP Address Pools in BMC Network Automation. The IP Address Pools page is displayed.
ip_AddressPools1.gif
 These address pools are created when pods are created on the Network tab and destroyed when pods are destroyed.
 You cannot modify address pools on this page.
 The IP Address Pools page has the following menu options:

  • Print View: Print the list of IP address pools.
  • Refresh: Refresh the list.
  • Help: Display Help for managing IP address pools.

The following actions can be taken for the IP address pools in the IP Address Pool page:

  • Delete

Viewing the excluded IP addresses

You can view the list of IP address pools that are excluded from address pools by navigating to Admin > IP Address Management > Excluded IP Addresses in BMC Network Automation. The Excluded IP Addresses page is displayed.
excludedIpAddresses1.gif
 The Excluded IP Addresses page has the following menu options:

  • Add: Add one or more IP addresses.
  • Print View: Print the list.
  • Refresh: Refresh the list.
  • Help: Display Help for managing IP addresses.

The following actions can be taken on the IP addresses in the Excluded IP Addresses page:

  • Delete

Adding an excluded IP address

This topic describes how to exclude an IP address.

  1. Open the Excluded IP Addresses page by navigating to Admin > IP Address Management > Excluded IP Addresses in BMC Network Automation.
  2. Click Add. The Excluded IP Address dialog box opens, as shown in the following figure: 
    excludedIpAddresses2.gif 
  3. Enter one or more IP addresses in dotted quad format (for example, 123.45.67.89). Separate multiple addresses by commas, or define a range of IP addresses by entering a dash between the starting and ending addresses. For example, to exlcude all ip addresses between 192.10.21.1 to 192.10.21.20, the address 192.10.21.30 and all addresses between 192.10.21.40 and 192.10.21.45, you would enter the following: 192.10.21.1 - 192.10.21.20, 192.10.21.30, 192.10.21.40 - 192.10.21.45.
  4. Click Save. The IP address or addresses are added to the list.

Installing Infoblox DMAPI PERL modules

This section contains information about the installation of the Infloblox DMAPI PERL modules as a third-party IPAM solution.

Before you begin

  • BMC Atrium Orchestrator must be installed. 
  • Infloblox Perl modules and the BMC Atrium Orchestrator peers – configuration distribution peer (CDP), activity peer (AP), or lightweight activity peer (LAP) – must be on the same host. 
  • Install the Infoblox application on a different host. The Infloblox Perl modules invoke web service calls to Infoblox as a target. 

To install Infoblox DMAPI packages on a Windows management system

Depending on your connection, the following are required:

IP version

Component

IPv4

  • Perl 5.8.8 or later
  • ActiveState version of Perl 5.8.8 or later with PPM 3.x or later
  • Crypt::SLeay version 0.51 or later, plus its dependencies (ssleay32.dll and libeay32.dll)
  • LWP::UserAgent version 5.813 or later
  • XML::Parser

IPv6

  • Perl 5.14.2 or later
  • ActiveState version of Perl 5.14.2 or later with PPM 3.x or later
  • LWP::UserAgent version 6.02 or later, plus relevant dependencies, including LWP Protocol https
  • Net::INET6Glue
  • XML::Parser
  1. Download and install PPM from http://www.activestate.com/.

  2. Install Crypt::SSLeay and libwww-perl 5.837 or earlier. To downgrade libwww-perl to 5.387, remove the ~/.cpan files and then re-install libwww-perl-5.837 for your environment: 

    cpan> i /libwww-perl/
    ...
    Distribution    GAAS/libwww-perl-5.837.tar.gz
    Distribution    GAAS/libwww-perl-6.01.tar.gz
    Distribution    GAAS/libwww-perl-6.04.tar.gz
    Author         
    LWWWP ("The libwww-perl mailing list" <libwww@perl.org>)
    4 items found
    cpan> install GAAS/libwww-perl-5.837.tar.gz

     

  3. Add the Infoblox device as a repository.
  4. Search the Infoblox device for Infoblox packages.
  5. Install Infoblox packages on your management system.
  6. Fetch and install Infoblox packages.

To install Infoblox DMAPI packages on a UNIX system

Depending on your connection, the following are required:

IP version

Component

Steps

IPv4

  • Perl 5.8.8 or later
  • Crypt::SLeay version 0.51 or later
  • LWP::UserAgent version 5.813 or later
  • XML::Parser
  1. To install the required libraries, use CPAN.

  2. After installing PERL, run:

    perl -e shell -MCPAN

  3. After PERL is configured, run:

    install LWP::UserAgent
    install XML::Parser 

Any other packages you need, depend on IPv4 accessibility.

IPv6

  • Perl 5.14.2 or later
  • LWP::UserAgent version 6.02 or later, plus relevant dependencies, including LWP Protocol https
  • Net::INET6Glue
  • XML::Parser
  1. To install the required libraries, use CPAN.

  2. After installing PERL, run:

    perl -e shell -MCPAN

  3. After PERL is configured, run:

    install LWP::UserAgent
    install XML::Parser 

Any other packages you need, depend on IPv6 accessibility.

 

  1. Download and install ActivePerl version 5.12.4.1205 from http://www.activestate.com/.
  2. Add the bin directory to the PATH environment variable to access it conveniently. For example, if you installed the API package in /home/<username>/ActivePerl-5.12, set setenv PATH = /home/<username>/ActivePerl-5.12/bin:$PATH
  3. Download and install the API package from https://<ipAddress>/api/dist/CPAN/authors/id/INFOBLOX/, where <ipAddress> is the IP address of the appliance.
  4. Locate and download the Infoblox-xxxxxxx.tar.gz file, where xxxxxxx is an integer depending on your API package version.
  5. Extract Infoblox-xxxxxxx.tar.gz to a temporary directory by using the following command: tar xvfz Infoblox-xxxxxxx.tar.gz

  6. Execute the following commands:

    cd Infoblox-xxxxxxx/
    perl Makefile.PL
    make
    make install

     

For about , see .

Installing the VitalQIP client

This section contains information about the installation of Lucent VitalQIP IPAM as a third-party IPAM solution.

Before you begin

  • BMC Atrium Orchestrator must be installed. 
  • Lucent VitalQIP IPAM and the BMC Atrium Orchestrator peer (configuration distribution peer (CDP), activity peer (AP), or lightweight activity peer (LAP)) must be on the same host.

To install the VitalQIP client

If you are going to use VitalQIP as your IPAM solution, perform the steps below to install the VitalQIP client:

  1. Verify whether the Oracle Instant Client is installed on the host where you will be installing the VitalQIP client. If the Oracle Instant Client is installed, go to the next step. Otherwise, perform the procedure in the Installing the Oracle Instant Client section.
  2. Installing the VitalQIP client
  3. Once you have finished installing the third-party IPAM product, go to Configuring BMC Atrium Orchestrator.

Installing the Oracle Instant Client

  1. Start the installation on the desired server.
  2. In the Welcome screen, click Next to continue.
  3. In the Select Installation Type screen, select the InstantClient option, and click Next to continue.
  4. In the Specify Home Details section, ensure that the value in the Path field is c:\oracle\product\10.2.0\client_1, and click Next to continue.
  5. In the Product-Specific Prequisite Checks screen, if the checks have a Succeeded status, click Next to continue.
  6. In the Summary screen, click Install.
  7. In the End of Installation screen, click Exit to close the installer.

Installing the VitalQIP client

This section describes the steps necessary to install the VitalQIP client.

  1. Start the installation on the same server where the Oracle Instant Client is installed.
  2. In the license agreement screen, select the I accept the terms of the license agreement option, and click Next to continue.
  3. In the Welcome screen, click Next to continue.
  4. In the VitalQIP Platform Support Policy screen, click Next to continue.
  5. In the Directory Name field, enter c:\qip, and click Next to continue.
  6. In the VitalQIP features to install screen, select the Client Package, GUI Client, and CLI's options, and click Next to continue.
  7. In the Please read the information below screen, click Next to continue.
  8. In the Please select a database type screen, select the Oracle option, and click Next to continue.
  9. In the Oracle home directory screen, enter c:\oracle\product\10.2.0\client_1, and click Next to continue.
  10. In the QIP data server screen, enter the name of the QIP data server, and click Next to continue.
  11. In the local IP address screen, enter the IP address of the host in the IP Address field, and click Next to continue.
  12. In the Enterprise Server IP Address screen, enter the IP address of the QIP server, and click Next to continue.
  13. In the DNS Update Server IP Address screen, enter the DNS update server, for example, the QIP server, and click Next to continue.
  14. In the Login Server IP Address screen, enter the login server, for example, the QIP server, and click Next to continue.
  15. In the DNS Update Server IP Address screen, enter the DSN update server, for example, the QIP server, and click Next to continue.
  16. In the qipman password screen, enter the qipman password, and click Next to continue.
  17. In the SSL Key Import Selection screen, select the No option, and click Next to continue.
  18. In the Message Service IP Address screen, ensure that the value is set to 127.0.0.1, and click Next to continue.
  19. In the SMTP Information screen, specify the SMTP Host IP Address and Email Return Path, and click Next to continue.
  20. In the Communication mode of Tomcat Server screen, select the Non-secure option, and click Next to continue.
  21. Specify the Web Server IP address and the corresponding HTTP Port, and click Next to continue.
  22. In the Summary screen, verify the information in the installation summary, and click Next to continue.
  23. Once the Summary screen is updated with a successful installation message, click Next to continue.
  24. In the Remove command output screen, ensure that the Remove output files option is selected, and click Next to reboot the host.
  25. If a message displays stating that files required to run Windows have been replaced by unrecognized versions, click Cancel and reboot the host.

Configuring BMC Atrium Orchestrator to enable third-party IPAM

This section describes how to configure BMC Atrium Orchestrator to enable a third-party IPAM solution.
 If you are using the VitalQIP client as an IPAM solution, perform the following steps to configure BMC Atrium Orchestrator:

  1. Activate the VitalQIP AD adapter files, as described in Activating the adapters for the VitalQIP client.
  2. Configure the OA and SA modules, as described in Configuring the OA and SA modules.

If you are using another product as a third-party IPAM solution, perform the following steps to configure BMC Atrium Orchestrator:

  1. Create and activate an AD adapter files for your third-party IPAM product, as described in Creating and activating a custom AD module adapter.
  2. Configure the OA and SA modules, as described in Configuring the OA and SA modules.

Once you have completed configuring BMC Atrium Orchestrator, go to Configuring BMC Network Automation.
Activating the AD adapter for the VitalQIP client

  1. Open a web browser session and log into to the BMC Atrium Orchestrator Grid Manager using the following format: http://<BAO_SERVER>:<WEB_PORT>/baocdp.
  2. Add the command line and file adapters to the grid:
    1. Select Manage > Adapters.
    2. Select ro-adapter-command-line and ro-adapter-file from the left-hand table, and click Add to Grid.
  3. Configure the command line and file adapters on the grid:
    1. Select Manage > Adapters, and open the command line adapter for configuration (click Configure if configuring for the first time, or click the name of the adapter).
    2. Enter the adapter name and description in the appropriate fields, and click OK.
    3. Repeat for the file adapter.
  4. Enable the command line and file adapters on the grid:
    1. Select Manage > Peers, and select the peer from the list.
    2. Click the Edit selected Peer icon, and click Enable.
    3. Select the file and command line adapter names from list and click OK.
    4. Click OK to save the changes.
  5. Activate the three IPAM BMC Atrium Orchestrator modules on the grid:
    1. Select Manage > Modules, and select the three available IPAM modules from left-hand table.
    2. Click Activate.

Creating and activating a custom AD module adapter

If you are using a third-party IPAM solution other than VitalQIP, use the BMC Atrium Orchestrator Platform: Adapter Developer's Guide to create and activate a custom AD module adapter for the product. You can download this guide from the PDF product guides page of the BMC Atrium Orchestrator Platform on-line documentation.
 Configuring the OA and SA modules

  1. Configure the third-party IPAM product configuration details from the AD adapter in the Operations Actions (OA) module configuration parameters:
    1. Select Manage > Modules, and click on the OA module link in the right-hand table.
    2. Navigate to Configuration > IP_Address_Management, and click the name of the third-party IPAM product in the configuration tree. For example, VitalQIP.
    3. Edit the properties for the third-party IPAM product, including the command line and file adapter names configured in the AD adapter, and click OK.
  2. Configure the OA module configuration name in the SA module configuration parameters:
    1. Select Manage > Modules, and click on the SA module link in the right-hand table.
    2. Navigate to Configuration > IP_Address_Management, and click Configuration_Name in the configuration tree.
    3. Set the name to the name of your third-party IPAM product, and click OK. For example, VitalQIP.

Related topics

See the following topics in the BMC Atrium Orchestrator on-line documentation:

Configuring BMC Network Automation to enable third-party IPAM

  1. Open a BMC Network Automation client session and select Reports > system diagnostics.
  2. In the Global Propertiesfield, verify that the following properties are configured as indicated:
    • vdcEnabled=true
    • ipamProvider=com.bmc.bcan.engine.network.ipam.ao.ThirdPartyIpamImpl
  3. If the properties are set to the correct values, proceed to step 5. Otherwise, proceed to the next step.
  4. Edit the BCAN_DATA\global.propertiesfile and update the properties to the values shown in step 2.
    1. Log on to the BMC Network Automation server as an Administrator or user with access to the BCAN_DATA directory.
    2. Back up the BCAN_DATA\global.properties file.
    3. Use a text editor to open the global.properties file.
    4. Change the values of the vdcEnabled and ipamProvider properties to match the values shown in step 2.
    5. Save the file and close the editor.
    6. Restart the BMC Network Automation server.
  5. Configure the BMC Atrium Orchestrator integration details in system parameters:
    1. Select Admin > system parameters.
    2. In the External Integrations section, select the Enable BMC Atrium Orchestrator Integration option.
    3. Enter the Web Service Endpoint URL in the following format: http://<BNA_server>:<port_number>/baocdp/orca.
    4. Enter the BMC Atrium Orchestrator Username.
    5. Enter the BMC Atrium Orchestrator user account Password.
    6. Confirm the BMC Atrium Orchestrator user account Password.
    7. Enter the BMC Atrium Orchestrator Grid Name.

Troubleshooting

This section describes the actions you can take to try and determine why the interface to the third-party IPAM solution is not working correctly.

  1. Open a BMC Network Automation client session and select Reports > system diagnostics.
  2. In the Global Propertiesfield, verify that the following properties are configured as indicated:
    • vdcEnabled=true
    • ipamProvider=com.bmc.bcan.engine.network.ipam.ao.ThirdPartyIpamImpl
  3. If the properties are set to the correct values, proceed to step 5. Otherwise, proceed to the next step.
  4. Perform the steps in Configuring BMC Network Automation. If that resolves the problem, the procedure is complete. Otherwise, proceed to the next step.
  5. Review the BMC Atrium Orchestrator log file (BAO_HOME\CDP\tomcat\logs\processes.log) for information that might indicate the source of the problem.
  6. Review the BMC Network Automation log file (BCAN_DATA\log\BCA-Networks.log) for information that might indicate the source of the problem.
  7. Contact BMC Support for assistance.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*