Skip to main content

Troubleshooting Connector Pack installation

Manually loading the connectors

If connectors fail to load during install / modify procedure:

  1. Click Report to list which connectors failed.

  2. Execute loadplatform.exe from the command line to manually load the missing connectors.

    You can load specific connectors using the following command:

    loadplatform.exe -a <connector name>

    You can also load all connectors available to the instance by running this command:

    loadplatform.exe -target

    The -target argument examines both the global and instance specific Connector Pack s.

Attribute or template conflicts

Attribute or template conflicts can occur when Bravura Security Fabric is upgraded. You can use loadplatform to list attribute or template conflicts, and forcibly override those conflicts if required. The idmsuite.log file also describes which attributes or templates are at fault and proposes changes.

It is the responsibility of the Bravura Security Fabric administrator to determine which portions of the Bravura Security Fabric instance may be affected by changes to default attribute values or characteristics; for example, the attribute’s value may no longer be queried by default. If PSLang scripts make decisions based on this attribute’s value, the decisions may no longer be correct.

Note

The Connector Pack upgrade process does not modify any existing attribute definitions used by the instance. You must decide which, if any, attributes should be modified when upgrading the Connector Pack.

If you choose to apply this upgrade, then it is recommended that you backup the attrdef and attrdefval tables before updating the values. The attrdef and attrdefval CSV files are located in the agent\dat directory.

There are currently two ways to update the attribute default values:

  • Manually running loadplatform. exe with the -force flag. This applies all changes for the targets you specify. See the loadplatform usage information for details.

  • Manually overriding individual attributes from the Target system attributes menu. You can override attributes at the target system or target system type level. See the Bravura Security Fabric documentation for details

To forcibly update the attributes or templates, manually run loadplatform.exe with the -force flag. This applies all changes for the targets you specify. For example:

loadplatform.exe -force -a <connector name>

To see a list of all loadplatform arguments, use the following command:

loadplatform.exe --help

See usage information on loadplatform .

loadplatform

Use the loadplatform program to query connectors for their abilities and populate platform, objoper and objrel database tables with the information. The program also sets the default attributes for the connector platforms by populating attrdef and attrdefval tables. This is particularly useful when custom connectors have been created and the target type needs to be available in the user interface.

When used without the -force argument, it is safe to run. If run with -force it can return to defaults any custom settings in newly created target system configurations, in system attributes, discovery templates, account attribute overrides.

Bravura Security Fabric target systems types are displayed in Type drop-down list on the Target system information page. Target types in this list are displayed according to target system category.

loadplatform is installed in the Bravura Security Fabric instance util directory.

Requirements

The client software required by the specified target systems must be installed or else the platform data for the connector will not be imported to the database.

The loadplatform program loads a binary executable (.exe), or a scripted platform definition file that calls a binary agent. If you do not specify an .exe or .con extension, the program looks for files with either extension. If both exist, loadplatform loads the .exe file.

To load and list official scripted connectors, both the scripted platform definition file (.con) and the configuration script specified within the .con file must be located in the agent directory.

Usage
loadplatform.exe -a <connector name> [-dry-run]
loadplatform.exe -target [-dry-run]

Argument

Description

-v, --version

Print out version and exit

-a, --agent <connector name>

Load the specified connector.

-target

Load all target system connectors.

-d, --dir <directory path>

Changes the directory to look for the agents and connectors in the specified path.

-32bit

Load 32-bit connectors.

-dry-run

Query the specified connectors but do not write the information to the database.

-force

Forcibly update attribute information if conflict exists.

Warning

Do not run the command with this argument until you check the idmsuite.log or the result of the command executed in -dry-run mode, as it can change custom attribute definitions and discovery template configuration.

-list-db-inserts

Include a list of all inserted database values.

Examples

  1. To import information about the Unix connector into the database, type:

    loadplatform.exe -a agtunix.exe

  2. To see the operations supported by the Active Directory DN connector, type:

    loadplatform.exe -dry-run -a agtaddn.exe
In this section: