When running the Group Policy Administrator (GPA) Offline Mirror utility (RunOfflineMirror.bat), the (NETIQKB52722)

  • 7752722
  • 02-Feb-2007
  • 27-Aug-2007

Resolution

fact
NetIQ Group Policy Administrator 5.0

symptom
When running the Group Policy Administrator (GPA) Offline Mirror utility (RunOfflineMirror.bat), the Offline Mirror utility does not create category folders and import Group Policy Objects (GPOs) into the GP Repository if the Active Directory OU name contains a special character.

symptom
The Offline Mirror utility does not import GPOs into the GP Repository if the Active Directory OU that contains the GPO has ampersand (&), comma (,), plus (+), forward slash (/), or curly brace ({) characters in the OU name.

cause
This is a known issue that occurs when you use the GPA Offline Mirror utility to import GPOs into the GP Repository and you have Active Directory OU names that contain special characters that GPA does not support.

fix

This issue is resolved with NetIQ Group Policy Administrator version 5.0 Hotfix 52722.

Hotfix 52722 addresses an issue that occurs if you are using the Offline Mirror utility to import GPOs into the GP Repository and you have Active Directory OU names that contain characters that NetIQ Group Policy Administrator (GPA) does not support. When you run the Offline Mirror utility, the Offline Mirror utility automatically creates a category folder with the name of the domain from which you are importing Group Policy Objects (GPOs). The Offline Mirror utility also creates category folders for each OU within the domain in which to place GPOs. Then, the Offline Mirror utility imports all the GPOs into corresponding category folders in the GP Repository. The Offline Mirror utility does not allow ampersand (&), comma (,), plus (+), forward slash (/), or curly brace ({) characters in GP Repository category names. If you have Active Directory OU names that contain characters the Offline Mirror utility does not support, the Offline Mirror utility cannot create the corresponding category folder in the GP Repository.

Hotfix 52722 addresses this issue by updating the syntax of the Offline Mirror utility (RunOfflineMirror.bat) and adding the /R option. The /R option allows you to specify replacement characters to use in category names.

Syntax for Offline Mirror Utility
RUNOFFLINEMIRROR /D:domain /S:server [/SU:name /SP:pwd] [/R:"char":"replacement" [...]]

Options for Offline Mirror Utility
/D:domain                             Specifies the DNS name of the evaluation domain, such as domainname.local.
/S:server                              Specifies the name of the Microsoft SQL Server computer where you installed the GP Repository. The default value . (period) indicates the GP Repository is installed on the local computer.
/SU:name                             Specifies the Microsoft SQL Server login user name.
/SP:pwd                               Specifies the Microsoft SQL Server login user password.
/R:"char":"replacement"      Specifies the invalid character and the replacement character with which to replace it. You can specify this parameter up to five times in one command. Each invalid character and replacement character must be enclosed in quotes.

Example for Offline Mirror Utility
To replace "&" with "AND" and "+" with "PLUS" when using the Offline Mirror utility to import GPOs, enter the following command:

RUNOFFLINEMIRROR /D:HOU.MYCOMPANY.COM /S:HOUSQL /SU:JSMITH /SP:JSMITHPASSWORD /R:"&":"AND" /R:"+":"PLUS"

Hotfix Installation Instructions
To install this hotfix, run the GPA50000_Hotfix52722.exe file on each computer where you installed the GPA Console.

This hotfix modifies the following files:

  • OfflineMirror.vbs
  • RunOfflineMirror.bat

By default, these files are located in the Program Files\NetIQ\Group Policy Administrator\Tools folder.

For more information, please contact NetIQ Technical Support at <.
a href="https://www.netiq.com/support">www.netiq.com/support .

.


Additional Information

Formerly known as NETIQKB52722