Section 7. Upgrading Directory Sync Pro for Active Directory and Migrator Pro for Active Directory
Directory Sync Pro for Active Directory and Migrator Pro for Active Directory can be upgraded to a new version without uninstalling the existing version. The install wizard will detect the necessary changes and manage the upgrade.
7.1 Supported Upgrade Path
Upgrades are supported to the latest GA (Generally Available Release) from two GA versions prior. GA releases are listed on our website. If you are upgrading to a CSR (Customer Specific Release), please contact Support for clarification on whether the upgrade is supported.
If upgrading from a release older than two releases prior to the current GA, it is highly recommended that Support is contacted to discuss upgrade options for your specific environment. Some implementations which are more complex or have custom configurations may require a dedicated resource to assist in the upgrade process. If the upgrade goes beyond the scope of product support, this issue will be escalated to our Professional Services to assist at a billable rate.
Please contact Support if you have questions or need clarification on the Directory Synchronization upgrade process.
7.2 Upgrade Process
Directory Sync Pro for Active Directory and Migrator Pro for Active Directory can be upgraded to a new version without uninstalling the existing version. The installation wizard will detect the necessary changes and manage the upgrade.
Redeploying the Migrator Pro for Active Directory agents after upgrading is recommended in order to take advantage of new features in the new version of Migrator Pro for Active Directory. Both the current version and previous version (n-1) of the agent are supported.
|
|
Any customizations to the System actions in the ADM_Command and/or ADM_ActionCommand tables will be overwritten upon upgrade. If new custom actions are added through the user interface, those will not be lost during future upgrade. The PowerShell commands that are installed and stored in the SQL database should not be modified as they may be lost during an upgrade. |
Careful consideration should be taken when:
-
Upgrading in a production environment
-
Upgrading an older release of Directory Sync Pro for Active Directory to the latest release
Recommendations:
-
Truncating the log or reducing the log size as much as possible before upgrading is recommended. This will reduce the amount of time needed to rebuild the log table index during the upgrade process.
-
The examination of the Log SQL database during an upgrade may take longer than expected. Please allow the process to complete and the upgrade installation to proceed.
-
Download the install executable file of the new version from the FTP site and save it on the server.
-
Run the executable file. The install wizard will appear and proceed through the standard installation steps.
|
|
You must delete the C:\Windows\BTPass folder from all domain controllers being used in the Directory Sync Pro for Active Directory profiles. A new version of BTPass will be pushed to the domain controllers on the next sync. |
|
|
Mirroring should be stopped in the SQL environment prior to upgrading or installing.
|
7.1 Supported Upgrade Path
Directory Sync Pro for Active Directory and Migrator Pro for Active Directory can be upgraded to a new version without uninstalling the existing version. The install wizard will detect the necessary changes and manage the upgrade.
Upgrades are supported to the latest GA (Generally Available Release) from two GA versions prior. GA releases are listed on our website. If you are upgrading to a CSR (Customer Specific Release), please contact Support for clarification on whether the upgrade is supported.
If upgrading from a release older than two releases prior to the current GA, it is highly recommended that Support is contacted to discuss upgrade options for your specific environment. Some implementations which are more complex or have custom configurations may require a dedicated resource to assist in the upgrade process. If the upgrade goes beyond the scope of product support, this issue will be escalated to our Professional Services to assist at a billable rate.
Please contact Support if you have questions or need clarification on the Directory Synchronization upgrade process.
7.2 Upgrade Process
Directory Sync Pro for Active Directory and Migrator Pro for Active Directory can be upgraded to a new version without uninstalling the existing version. The installation wizard will detect the necessary changes and manage the upgrade.
Redeploying the Migrator Pro for Active Directory agents after upgrading is recommended in order to take advantage of new features in the new version of Migrator Pro for Active Directory. Both the current version and previous version (n-1) of the agent are supported.
|
|
Any customizations to the System actions in the ADM_Command and/or ADM_ActionCommand tables will be overwritten upon upgrade. If new custom actions are added through the user interface, those will not be lost during future upgrade. The PowerShell commands that are installed and stored in the SQL database should not be modified as they may be lost during an upgrade. |
Careful consideration should be taken when:
-
Upgrading in a production environment
-
Upgrading an older release of Directory Sync Pro for Active Directory to the latest release
Recommendations:
-
Truncating the log or reducing the log size as much as possible before upgrading is recommended. This will reduce the amount of time needed to rebuild the log table index during the upgrade process.
-
The examination of the Log SQL database during an upgrade may take longer than expected. Please allow the process to complete and the upgrade installation to proceed.
-
Download the install executable file of the new version from the FTP site and save it on the server.
-
Run the executable file. The install wizard will appear and proceed through the standard installation steps.
|
|
You must delete the C:\Windows\BTPass folder from all domain controllers being used in the Directory Sync Pro for Active Directory profiles. A new version of BTPass will be pushed to the domain controllers on the next sync. |
|
|
Mirroring should be stopped in the SQL environment prior to upgrading or installing.
|
7.2 Upgrade Process
Directory Sync Pro for Active Directory and Migrator Pro for Active Directory can be upgraded to a new version without uninstalling the existing version. The install wizard will detect the necessary changes and manage the upgrade.
7.1 Supported Upgrade Path
Upgrades are supported to the latest GA (Generally Available Release) from two GA versions prior. GA releases are listed on our website. If you are upgrading to a CSR (Customer Specific Release), please contact Support for clarification on whether the upgrade is supported.
If upgrading from a release older than two releases prior to the current GA, it is highly recommended that Support is contacted to discuss upgrade options for your specific environment. Some implementations which are more complex or have custom configurations may require a dedicated resource to assist in the upgrade process. If the upgrade goes beyond the scope of product support, this issue will be escalated to our Professional Services to assist at a billable rate.
Please contact Support if you have questions or need clarification on the Directory Synchronization upgrade process.
Directory Sync Pro for Active Directory and Migrator Pro for Active Directory can be upgraded to a new version without uninstalling the existing version. The installation wizard will detect the necessary changes and manage the upgrade.
Redeploying the Migrator Pro for Active Directory agents after upgrading is recommended in order to take advantage of new features in the new version of Migrator Pro for Active Directory. Both the current version and previous version (n-1) of the agent are supported.
|
|
Any customizations to the System actions in the ADM_Command and/or ADM_ActionCommand tables will be overwritten upon upgrade. If new custom actions are added through the user interface, those will not be lost during future upgrade. The PowerShell commands that are installed and stored in the SQL database should not be modified as they may be lost during an upgrade. |
Careful consideration should be taken when:
-
Upgrading in a production environment
-
Upgrading an older release of Directory Sync Pro for Active Directory to the latest release
Recommendations:
-
Truncating the log or reducing the log size as much as possible before upgrading is recommended. This will reduce the amount of time needed to rebuild the log table index during the upgrade process.
-
The examination of the Log SQL database during an upgrade may take longer than expected. Please allow the process to complete and the upgrade installation to proceed.
-
Download the install executable file of the new version from the FTP site and save it on the server.
-
Run the executable file. The install wizard will appear and proceed through the standard installation steps.
|
|
You must delete the C:\Windows\BTPass folder from all domain controllers being used in the Directory Sync Pro for Active Directory profiles. A new version of BTPass will be pushed to the domain controllers on the next sync. |
|
|
Mirroring should be stopped in the SQL environment prior to upgrading or installing.
|
Section 8. Modifying, Repairing and Uninstalling Directory Sync Pro for Active Directory and Migrator Pro for Active Directory
Directory Sync Pro for Active Directory and Migrator Pro for Active Directory can be modified, repaired, or uninstalled from the Programs and Features upgraded to a new version without uninstalling the existing version. The install wizard will detect the necessary changes and manage the upgrade.
-
Open Programs and Features by clicking the Windows Start button, clicking Control Panel, and clicking Programs and Features.
-
Select Directory Sync Pro for Active Directory or Migrator Pro for Active Directory from the list of programs and click Change.
-
The wizard screen appears displaying the following options. Select one of the following options and click Next:
-
Modify – use the Modify option to add and subtract components of Directory Sync Pro for Active Directory and/or Migrator Pro for Active Directory. This is useful if you wish to add or remove the Directory Sync Pro for Active Directory Console.
-
Repair – use the Repair option if Directory Sync Pro for Active Directory and/or Migrator Pro for Active Directory needs to be repaired due to corruption.
-
Remove – use the Remove option to uninstall Directory Sync Pro for Active Directory and/or Migrator Pro for Active Directory. You can also uninstall by clicking Uninstall on the Programs and Features page.
-
Proceed through the wizard until finished.
-