B.2 Configuring Cloud Manager for Nixu NameSurfer Integration

  1. From the Cloud Manager Application Server, open /opt/netiq/cloudmanager/etc/cloudmanager-ipam-nixu.cfg

  2. Edit the configuration file:

    1. Edit the properties that specify the Nixu Server connection information:

      Configuration Property and Default Value

      Value Detail

      Example

      url=<server:port>/SOAP

      Specify the Nixu Server URL, without the "http" connection protocol.

      url=mynixuserver.mydomain.com:8443/SOAP/

      secureConnection=true

      Specify whether the connection is secure. If http, specify false. If https, specify true.

      secureConnection=true

      keyname=<keyname>

      This is the name of the NSAPI key configured in the Nixu NameSurfer console. It is needed for Web Service API access.

      keyname=EngKey

      keyvalue=<keyvalue>

      This is the value of the NSAPI key specified in "keyname" property, as configured in the Nixu NameSurfer console. It is needed for Web Service API access.

      keyvalue=KrqcCHySczwIFfshSMfrPoCESY3ip8Nh90egtrmouTg=

    2. Edit the properties that specify the Cloud Manager options:

      Configuration Property and Default Value

      Value Detail

      autoHostname=TRUE

      Specifies whether Nixu NameSurfer should auto-create a hostname for the requested address. Hostname auto-generation follows the rules specified on the Address Block in the Nixu NameSurfer console.

      addToDNS=FALSE

      Specifies whether Nixu NameSurfer should auto-register the hostname with Nixu NameSurfer's DNS service. If you are not using Nixu NameSurfer for your DNS server, set this to FALSE.

      defaultToDHCP=FALSE

      Specifies behavior in the case of a Nixu NameSurfer integration failure. Failures can occur because of inability to connect to the server, inability to find a Nixu Address Block that is correctly configured to provide an address for a specified Cloud Manager Zone, etc.

      In case of a failure, if this value is TRUE, the Cloud Manager workload is configured to obtain its network information from DHCP.

      NCMNetworkIDValueIsName=FALSE

      Specifies whether to use the full Cloud Manager Network ID or the simple Network Name as the match string in Nixu NameSurfer Address Blocks.

      Using the full Cloud Manager Network ID is preferable, because it provides a greater probability of uniqueness.

      NOTE:This property is codependent with a Nixu IP Address block setting. See NCMNetworkID, above, for more information.

      Do not set this value to TRUE unless you are sure that all network interfaces have unique names.

      defaultVMNameFromHostName=FALSE

      Specifies whether to set the workload's PreferredVMName from the hostname provided by Nixu NameSurfer. We recommend that you set this value to FALSE, because the VM's name is now attached to a network name or IP address, which could change in the future if the Cloud Manager Network is deleted or modified.

      If TRUE, the PreferredVMName that will be set (the filename and display name of the VM) follows the pattern: <hostname>.<workloadid>

      NOTE:The PreferredVMName does not change in change requests, even if the hostname changes as a result of an altered NIC configuration.

      failBusinessServiceRequestOnIPAMFailure=TRUE

      Specifies what Cloud Manager should do in the case of a failure to obtain a valid NIC configuration from the IPAM system. the case of such a failure.

      If the value is set to TRUE, the business service is placed in a BUILD_FAILED state and the administrator can reconfigure the NIC and resubmit the business service.

      If the value is set to FALSE, the business service advances to the pre-build configuration phase. The administrator can then override the network type and specify a different NIC configuration.

      nixuIntegrationEnabled=FALSE

      Leave the value at FALSE until you finish setting all of the properties above. Setting the value to TRUE enables Cloud Manager to detect the Nixu IPAM integration and to display it as a network option.

  3. Restart the Cloud Manager Application Server to refresh the configuration settings and enable IPAM integration.