Configuring the Huawei CORBA TMF 814 collector

Edit online

To use data from the Huawei CORBA TMF 814 collector in a network discovery, you must configure the connection details between the Huawei CORBA TMF EMS and Network Manager.

About this task

You can also configure additional information to be collected from the EMS. To configure the Huawei CORBA TMF 814 collector, complete the following steps:

Procedure

  1. Change to the Huawei CORBA TMF 814 collector directory.
    cd $NCHOME/precision/collectors/javaCollectors/HuaweiCorbaTMF814/
  2. Within this directory, find the sample configuration file for the Huawei CORBA TMF 814 collector and copy it to the working configuration file.
    cp HuaweiCorbaTMF814Collector.properties.sample HuaweiCorbaTMF814Collector.properties
  3. Edit the collector configuration file:
    $NCHOME/precision/collectors/javaCollectors/HuaweiCorbaTMF814/HuaweiCorbaTMF814Collector.properties.
    The file is made up of the following sections:
    Collector properties
    General configuration parameters for the collector, such as port number and log and trace details.
    Data Source properties
    Details of the EMS that the collector is connecting to. Data from these fields is used by Network Manager to model the EMS.
    Data Acquisition properties
    Parameters that specify which data to collect from the EMS.
    ORB Initialization properties
    CORBA ORB-specific parameters.
    NameService properties
    Naming service parameters.
    EmsSessionFactory properties
    Parameters that specify how the collector should obtain the EMSSessionFactory object reference.
    Manager properties
    Parameters that specify the names of the manager interfaces.
    Iterator properties
    Parameters that define the behavior of the CORBA iterator.
    Filtering properties
    Parameters that define which devices should be excluded from processing.
  4. In the Collector properties section, configure the general collector properties:
    port
    Port on which to run the embedded collector server. The port must match the port configured in the insert into the collectorFinder.collectorRules table in the DiscoCollectorFinderSeeds.cfg file. The default value is 8080.
    log.filename
    Filename for the Huawei CORBA TMF 814 collector log file. The default value is HuaweiCorbaTMF814Collector.log.
    log.level
    Level of logging for the collector framework. The default value is INFO.
    trace.filename
    Filename for the Huawei CORBA TMF 814 collector trace file. The default value is HuaweiCorbaTMF814Collector-trace.log.
    trace.level
    Level of trace for the collector framework. The default value is INFO.
  5. You can optionally configure details about the source element management system (EMS) in the Data Source properties section by configuring the following generic fields. Data from these fields is used by Network Manager to model the EMS.
    DataSource.id
    Unique identifier for the datasource, in the form of an integer. This field takes the value 1, indicating that this is the primary data source.
    DataSource.descr
    Description of the EMS.
    DataSource.emsHost
    Hostname of the EMS.
    DataSource.emsName
    Name of the EMS.
    DataSource.emsPort
    Port of the EMS.
    DataSource.emsVersion
    Version of the EMS.
    DataSource.emsIdentifier
    Identifier for the EMS and key to integrate the Network Manager collector with the Netcool Configuration Manager driver.
    DataSource.emsRole
    Role of the EMS. This parameter can take one of the following values:
    • unknown
    • primary
    • backup
    • other
    DataSource.emsStatus
    Status of the EMS. This parameter can take one of the following values:
    • unknown
    • up
    • down
    • other
    DataSource.emsUserName
    Username of the EMS.
    DataSource.emsPassword
    Password of the EMS.
    DataSource.SecondaryEmsHost
    Host address of the Secondary EMS.
    DataSource.SecondaryEmsPort
    Port of the Secondary EMS.
    Datasource.switchEms
    You can use this parameter to switch between the primary and secondary EMS.
    Note: The DataSource.emsHost and DataSource.emsPort fields are compulsory if the nameService.useNameService variable is TRUE.
  6. In the Data Acquisition properties section, configure data acquisition parameters:
    collectData
    Takes one of the following values. The default value is True.
    True
    Enables the collector. The collector collects data from the EMS.
    False
    Disables the collector. The collector does not collect data from the EMS.
    DataAcquisition.GetEntities
    Takes one of the following values. The default value is 0.
    1: Enable
    Enables download of physical entity data from the EMS.
    0: Disable
    Disables download of physical entity data from the EMS.
    V4.2 Fix Pack 2: DataAcquisition.GetEquipmentAdditionalInfo
    V4.2 Fix Pack 2: Takes one of the following values. The default value is 0.
    1: Enable
    Enables download of equipment additional information from the EMS.
    0: Disable
    Disables download of equipment additional information from the EMS.
    DataAcquisition.GetCTPs
    Takes one of the following values. The default value is 0.
    1: Enable
    Enables download of ConnectionTP data from the EMS.
    0: Disable
    Disables download of ConnectionTP data from the EMS.
    DataAcquisition.GetTopoLinks
    Takes one of the following values. The default value is 0.
    1: Enable
    Enables download of layer 1 topological link connectivity from the EMS.
    0: Disable
    Disables download of layer 1 topological link connectivity from the EMS.
    DataAcquisition.GetSNCs
    Takes one of the following values. The default value is 0.
    1: Enable
    Enables discovery of Layer 1 subnetwork connections connectivity.
    0: Disable
    Disables discovery of Layer 1 subnetwork connections connectivity.
  7. In the ORB Initialization properties section, do not modify the following ORB initialization properties unless directed by IBM® Support:
    orbProp.1.name=org.omg.CORBA.ORBClass
    orbProp.1.value=com.ibm.CORBA.iiop.ORB
    Specifies the IBM ORB implementation to be activated.
    orbProp.2.name=org.omg.CORBA.ORBSingletonClass
    orbProp.2.value=com.ibm.rmi.corba.ORBSingleton
    Specifies the IBM ORB implementation to be activated.
    orbProp.3.name=com.ibm.CORBA.Debug.Output
    orbProp.3.value=../log/orbtrc.log
    Specifies the log file to which to write ORB error messages when the collector fails to connect to the CORBA service on the EMS.
  8. In the NameService properties section, configure the naming service properties:
    nameService.useNameService
    Takes one of the following values. Default value is True.
    True
    Collector obtains the root naming context reference by accessing the naming service using a corbaloc URL
    False
    Collector obtains the root naming context reference from the specified IOR file and bypasses the naming service.
    nameService.iorFile
    The full filepath to the IOR file containing the NameService reference. Supports local filepath and remote filepath; for example, HTTP, and FTP.
    nameService.nameServiceName
    Service name for the naming service.
  9. In the EmsSessionFactory properties section, configure the EmsSessionFactory properties:
    emsSessionFactory.useNameService
    Takes one of the following values. Default value is True.
    True
    Collector obtains the EmsSessionFactory_I reference by using the naming service and by resolving the specified naming context properties.
    False
    Collector obtains the EmsSessionFactory_I reference from the specified IOR file and bypasses the naming service.
    emsSessionFactory.iorFile
    Full filepath to the IOR file containing the EmsSessionFactory reference. Supports local filepath and remote filepath; for example, HTTP, FTP.
    emsSessionFactory.namingContext.*
    These naming context properties represent the naming context bindings for resolving the EmsSessionFactory reference from the naming service. All entries must be in *.id and *.kind pairs and specified in the correct sequence in order for the EmsSessionFactory reference to be correctly resolved.
  10. In the Manager properties section, configure the manager properties:
    manager.emsMgr
    Name for the EMSMgr interface. The default value is EMS.
    manager.equipmentInventoryMgr
    Name for the EquipmentInventoryMgr interface. The default value is EquipmentInventory.
    manager.managedElementMgr
    Name for the ManagedElementMgr interface. The default value is ManagedElement.
    manager.multiLayerSubnetworkMgr
    Name for the MultiLayerSubnetworkMgr interface. The default value is MultiLayerSubnetwork.
  11. In the Iterator properties section, configure the CORBA iterator properties:
    iterator.resultSize
    Specifies the maximum number of results returned for each set by the CORBA Iterator. The default value is 20. Increase this value if you want to decrease the number of iterations and increase the size of the data response from the EMS.
    iterator.destroyIterator
    Set to true if you want the CORBA Iterator to destroy the corresponding iterator object on the EMS side. The default value is false. Enable this property only if the EMS does not automatically perform memory garbage collection.
  12. In the filtering properties section, configure the device filtering properties:
    filter.enabled
    Takes one of the following values:
    • True: filter is enabled; the collector will exclude devices with the specified filter.productName property.
    • False: filter is disabled. This is the default value.
    filter.productName
    Specify here the model or type of device to excluded from processing. This property has no default value, and may be left blank. For multiple entries, separate the product names using commas. For example;
    filter.productName=Virtual NE,OptiX OSN 7500,OptiX DWDM OADM
    During processing, the values specified in the filter.productName property are compared with the contents of the entityData.Description field.
  13. Save the collector configuration file.