If you are a licensed user of SecureBridge and you are upgrading to AC v3.4, you need to use SecureBridge Agent Manager Migration Utility to be able to make the older version of the SecureBridge compatible with that in AC v3.4.
Follow the steps below to run the migration utility:
- Open Command Prompt (Windows) or Terminal (Linux).
- Go to the directory ...<AdeptiaInstallFolder>/ AdeptiaServer/ServerKernel folder.
Run the following command:
For Windows:
migrationutility.bat –agentmanagermigration <path of the build directory of Connect Server> skipLogTables=false
For Linux:
./migrationutility.sh –agentmanagermigration <path of the build directory of Connect Server> skipLogTables=falseIn case you want to migrate the log tables, set the value of skipLogTables to true. By default, the value is set to false.After successful migration, it displays a message on console saying Successfully completed the Agent Manager migration.
In case of any error while migrating the Agent Manager, it displays an error message, Error while migrating the Agent Manager, on the console. For more details, check the log file agentmanagermigration.log generated at ...<AdeptiaInstallFolder>/ AdeptiaServer/ServerKernel location.
Post migration changes in SecureBridge
The utility brings the following changes into effect.
Database table related changes
The data from the older tables is migrated to the corresponding new tables in the log and backend database.
Old table | New table |
---|---|
Backend database | |
agentInfo | AC_AGENT_INFO |
Log database | |
agentaction | AC_AGENT_ACTION |
agentdiagnostics | AC_AGENT_DIAGNOSTICS |
transactionlog | AC_TRANSACTION_LOG |
Configuration related changes
The utility overwrites the default values for the properties under the Agent Manager Hub section in server-configure.properties file with the older properties' values defined in hubConfiguration.properties file.
The table below contains the updated property names in the server-configure.properties file corresponding to the ones in older hubConfiguration.properties file.
Old configuration property (hubConfiguration.properties) | New configuration property (server-configure.properties) |
---|---|
enableEmailNotification | abpm.services.agentmanager.emailNotification.enabled |
maxMissHeartbeatTimeInSec | abpm.services.agentmanager.maxMissHeartbeatTimeInSec |
notificationIntervalInSec | abpm.services.agentmanager.notificationIntervalInSec |
recipientsEmail | abpm.services.agentmanager.recipientsEmail |
mailSubject | abpm.services.agentmanager.mailNotificationSubject |
mailBodyContentType | abpm.services.agentmanager.mailBodyContentType |
mailBodyHeader | abpm.services.agentmanager.mailBodyHeader |
mailBodyHeaderDown | abpm.services.agentmanager.mailBodyHeaderDown |
mailBodyHeaderUp | abpm.services.agentmanager.mailBodyHeaderUp |
mailBodyFooter | abpm.services.agentmanager.mailBodyFooter |
ignoredTransactionId | abpm.services.agentmanager.ignoredTransactionId |
saveAgentDiagnosticsInfo | abpm.services.agentmanager.saveAgentDiagnosticsInfo |
dashbordRefreshTimeInSec | abpm.services.agentmanager.dashbordRefreshTimeInSec |
postNotificationData | abpm.services.agentmanager.postNotificationData |
postNotificationDataUrl | abpm.services.agentmanager.postNotificationDataUrl |