Skip to main content

Upgrading Customer-Verified connectors

Starting with Connector Pack 4.6.0, the Connector Pack is separated between Bravura Security-Verified and Customer-Verified connectors .

Bravura Security-Verified connectors have been tested and are fully supported. They are the core connectors that are installed by connector-pack-x64.msi . Customer-Verified connectors are not shipped with the core Connector Pack and are distributed and installed separately.

When upgrading the instance-specific or global Connector Pack from 4.5.x or earlier using setup to Connector Pack 4.6.0 or later:

  • Only Bravura Security-Verified and connectors are upgraded.

  • Customer-Verified connectors from previous versions of the Connector Pack that are not upgraded by setup are removed during the upgrade.

When upgrading the instance-specific or global Connector Pack from version 4.6.0 or later using setup to 4.6.1:

  • Only Bravura Security-Verified and connectors are upgraded.

  • Customer-Verified connectors manually installed from the previous version prior to the upgrade are retained from that version after the upgrade. There will therefore be a mix of the upgraded Bravura Security-Verified connectors alongside the older Customer-Verified connectors.

In both cases, Customer-Verified connectors must be copied and installed manually to be upgraded to the latest Connector Pack version.

When the instance-specific or global Connector Pack is upgraded using setup, the Bravura Security-Verified connectors will be upgraded.

Any in-use Customer-Verified connectors are only upgraded during either the post-upgrade (or post-installation) tasks when loading connectors or by the loadcvagents utility. They are provided separately in the connector-pack-customer-verified.zip file.

During an installation or upgrade, only the Customer-Verified connectors that are currently configured as target systems on the Bravura Security Fabric instance are copied and loaded for this action.

You can also run loadcvagents separately to copy additional Customer-Verified connector files if needed. In this case, you still need to run loadplatform manually in order to load the connector for the instance.

The loadcvagents utility is only available for Bravura Security Fabric 12.7.1 and up.

For backwards compatibility between Connector Pack 4.6.1 and up, with Bravura Security Fabric 12.7.0 and below, you must manually copy Customer-Verified connectors to the Bravura Security Fabric instance; since the loadcvagents utility is not available in this case.

In this case, do the following:

  1. From the connector-pack-customer-verified.zip file, locate directories and files for each of the platforms for the required Customer-Verified connectors.

  2. Read notes, including instructions on where to copy the directory structure, contained with each of these directories.

  3. Manually copy required files to the relevant directories for the Connector Pack located on the Bravura Security Fabric server.

  4. Run loadplatform for each of the connectors as well as any other requirements:

    loadplatform -a agt<xxx>

loadcvagents

The loadcvagents utility runs automatically during the post-installation or post-installation tasks when loading connectors from an installation or upgrade. It copies the contents of the provided connector-pack-customer-verified.zip file for the Customer-Verified connectors to the relevant locations for the Connector Pack. Only Customer-Verified connectors currently configured as target systems on the Bravura Security Fabric instance will be copied and loaded for this action.

You can run loadcvagents separately. In this case, it only copies the Customer-Verified connector files. You must also run loadplatform manually in order to load the connector for the instance.

Note

The loadcvagents utility is only available for Bravura Security Fabric 12.7.1 and up.

Usage
loadcvagents.exe -mode [single|used|all] [-platformName <platformName>] [zip <zipName>]
Table 1. loadcvagents arguments

Argument

Description

-h, --help

Print out help/usage message and exit

-v, --version

Print out version and exit

-mode <single|used|all>

REQUIRED

  • single: Use this option to specify an individual platform name to copy a specific connector from the zip file.

  • used: This option is used to copy only the Customer-Verified connectors for configured targets on the Bravura Security Fabric server. It is used during the post-install or post-upgrade tasks during an installation or upgrade when loading connectors.

  • all: This option is used to copy all of the Customer-Verified connectors from the zip file.

-platformName <platform to load>

Use this option in combination with the "-mode single" option to copy Customer-Verified connectors for a specific connector platform. Specify the platform id for the Customer-Verified connector to copy from the zip file.

-zip <zipfile containing agents>

Specify the full path to the connector-pack-customer-verified.zip file for the Customer-Verified connectors.



Examples

  1. Copy only the Customer-Verified connectors for configured targets on the Bravura Security Fabricserver, type:

    loadcvagents.exe -mode used -zip c:\temp\connector-pack-customer-verified.zip

  2. Copy only a specific connector (such as for XML-RPC Web Service) from the zip file, type:

    loadcvagents.exe -mode single -platformName XML -zip c:\temp\connector-pack-customer-verified.zip

  3. Copy all of the Customer-Verified connectors from the zip file to the Bravura Security Fabric server, type:

    loadcvagents.exe -mode all -zip c:\temp\connector-pack-customer-verified.zip

After running the loadcvagents command, ensure to also run the loadplatform command for the added Customer-Verified connector; for example:

loadplatform -a agt<xxx>
In this section: