White Papers
Abstract
For some IBM products GSKit libraries are also installed. These can either be local GSKit libraries or global GSKit libraries depending on the product.
IBM Spectrum Protect for Mail - Data Protection for IBM Domino uses global GSKit libraries. On the other hand, IBM Domino server uses local GSKit libraries. This may result in interoperability issues in case of different GSKit ICC library versions.
To ensure that IBM Spectrum Protect and IBM Domino server use GSKit ICC libraries from a single source and that the latest of each version of GSKit ICC libraries is used, symbolic links can be created. In this regard, these white papers were released to guide users facing GSKit incompatibility issues between IBM Spectrum Protect and IBM Domino server.
Content
Jump to the desired section by using the following links:
Usage: “Solve_GSKit_Incompatibility_Domino_SP.pl”
Usage: “Solve_GSKit_Incompatibility_Domino_SP.ps1”
Download the following Zip file GSKit_Verification.zip and choose the appropriate GSKit compatibility verification script and the related module file depending on your operating system:
| Operating system | GSKit compatibility verification script | GSKit compatibility verification module |
| Linux x86 / Data Protection for IBM Domino | Solve_GSKit_Incompatibility_Domino_SP.pl | Solve_GSKit_Incompatibility_Domino_SP.pm |
| Windows 32-bit / Data Protection for IBM Domino 32 bit Windows 64-bit / Data Protection for IBM Domino 64 bit | Solve_GSKit_Incompatibility_Domino_SP.ps1 | Solve_GSKit_Incompatibility_Domino_SP.psm1 |
Note: The verification script and the related module (see table above) must be in the same directory. Otherwise, the script will not run properly.
The following short usage instructions as well as more detailed examples of the execution of each GSKit compatibility verification script can be found in this document:
solve_gskit_incompatibility_SP_Domino.docx
For instructions on how to set the links manually and a list of GSKit versions included in the products, see Resolving GSKit incompatibility between Domino and Spectrum Protect for Domino
Usage: “Solve_GSKit_Incompatibility_Domino_SP.pl”
Operating systems: Linux x86
Prerequisites:
- Ensure Perl is installed
- Install the Switch.pm Perl module.
- Download the 'Solve_GSKit_Incompatibility_Domino_SP.pl' script and the related Perl module file 'Solve_GSKit_Incompatibility_Domino_SP.pm' and save them in the same directory.
Execution of the script:
Depending on the value of the optional parameter, the script will behave differently. The following parameter values are possible:
- Parameter: not set
Result: The script’s usage information is printed out.
Syntax: > perl Solve_GSKit_Incompatibility_Domino_SP.pl
- Parameter: fix
Result: The symbolic links are automatically created if the version of IBM Spectrum Protect's ICC lib is more recent than IBM Domino's.
Syntax: > perl Solve_GSKit_Incompatibility_Domino_SP.pl fix
- Parameter: preview
Result: The list of commands that need to be executed by the user are printed out.
Syntax: > perl Solve_GSKit_Incompatibility_Domino_SP.pl preview
- Parameter: revert
Result: The symbolic links are removed, and the original configuration is restored.
Syntax: > perl Solve_GSKit_Incompatibility_Domino_SP.pl revert
Usage: “Solve_GSKit_Incompatibility_Domino_SP.ps1”
Operating systems: Windows 32-bit and Windows 64-bit
Prerequisites:
- Download the 'Solve_GSKit_Incompatibility_Domino_SP.ps1' script and the related PowerShell module file 'Solve_GSKit_Incompatibility_Domino_SP.psm1' and save them in the same directory.
- Run the following command in PowerShell before executing the script to change the PowerShell execution policy:
>Set-ExecutionPolicy RemoteSigned
Execution of the script:
Run PowerShell as Administrator. Go to the the diretory where the scripts are located.
Note: If you are running a 64-bit version of Windows, run the script with a 64-bit version of PowerShell.
Depending on the value of the optional parameter, the script will behave differently. The following parameter values are possible:
- Parameter: not set
Result: The script’s usage information is printed out.
Syntax: > .\Solve_GSKit_Incompatibility_Domino_SP.ps1
- Parameter: fix
Result: The symbolic links are automatically created if the version of IBM Spectrum Protect's ICC lib is more recent than IBM Domino's.
Syntax: > .\Solve_GSKit_Incompatibility_Domino_SP.ps1 fix
- Parameter: preview
Result: The list of commands that need to be executed by the user are printed out.
Syntax: > .\Solve_GSKit_Incompatibility_Domino_SP.ps1 preview
- Parameter: revert
Result: The symbolic links are removed, and the original configuration is restored.
Syntax: > .\Solve_GSKit_Incompatibility_Domino_SP.ps1 revert
Was this topic helpful?
Document Information
Modified date:
19 March 2019
UID
ibm10737863