Troubleshooting: Check the Logs
If you experience any problems with the utility, check the logs. The utility will create the following two log files on remote computers:
- %USERPROFILE%\Application Data\Quest Software\CacheCred\cachecredui.log
- %ALLUSERSPROFILE%\Application Data\Quest Software\CacheCred\cachecredsvc.log
CCU also creates Vmover log files on network shares specified by the SUCCESS_REPORT and ERROR_REPORT parameters. Note that the Write permission must be granted to Everyone for those network shares. For details, see corresponding parameter description in Technical Reference: Utility Configuration Parameters
Enabling extended logging
If you need increase the logging level for a specific computer, take the following steps:
- Open the cachecred.ini located at %Program Files%\Quest\Cached Credentials Utility or %Program Files(x86)%\Quest\Cached Credentials Utility with any text editor.
- Change the following field values:
svc.log.verbose = 5
ui.log.verbose = 5
- Save the changes and then restart the service.
Technical Reference: Utility Configuration Parameters
The following section describes configuration parameters that can be adjusted for the CCU installation package. For details on configuring them, see Configuring CCU Installation Package
These configuration parameters are defined in the update_msi.cmd file included as a part of the utility.
The parameters are divided into required parameters and optional parameters:
Required Parameters
- MOVE_DATE — The date in YYYY-MM-DD format that defines when to move the remote users's computers to the target domain.
- TRG_DOMAIN — NETBIOS name of target domain.
- TRG_DOMAIN_DNS — FQDN of target domain.
- MAP_FILE — Full path to network share with read only access to Everyone where vmover.ini and vmover.exe files are located. For details, see Preparing Vmover Files
- JOIN_CRED — String containing encrypted credentials of the account that will be used to move computers to the target domain. This string is the output string of the cachecredconf.exe utility. For details, see step 1 of Configuring CCU Installation Package.
Optional Parameters
- DELETE_TARGET_PROFILE {0|1} — Determines whether the solution must delete target user profile in case it exists. If the target profile does not exist, the Vmover utility will bind source user profile to the target user. By default, the profile is deleted.
|
|
Caution: Using CCU and RUM to process the same users' computer or server is not recommended. If CCU is run on a machine after RUM processing has processed the user Profile, the profile (which will have been redirected to the target user by RUM) will be deleted, resulting in data loss. If CCU might run after RUM processing, change the value of DELETE_TARGET_PROFILE to 0, or Revert the the RUM processing prior to running CCU. |
- PREPROC_ENABLE {0|1} — Defines whether resources will be processed by Vmover (default value is 1). By default, processing is turned on.
- TARGET_OU — Specifies distinguish name of the OU to be used to create target computer accounts.
- MOVE_ENABLE {0|1} — Defines whether station will be moved to the target domain. By default, computer is moved.
- SUCCESS_REPORT — Full path to network share with write permission to Everyone where to save Vmover logs upon successful processing. File name may contain environment variables $COMPUTER and $STAMP (computer name and time stamp in the YYYYMMDDHHmmss format).
SamplePath: \\cddom5dc\vmover_results\errors\$COMPUTER.$STAMP.txt
Created log file: \\cddom5dc\vmover_results\errors\CDDOM5SRV1.20121019165042.txt - ERROR_REPORT —Full path to network share with write permission to Everyone where to save Vmover logs generated on computers where any errors appeared during re-permissioning.
|
|
Important: Because every user will have write permissions on network shares specified by the SUCCESS_REPORT and ERROR_REPORT parameters, avoid using the same share as specified by the MAP_FILE parameter. |
Changing default messages and captions
To change messages and captions you can alter the following parameters or edit the cachecred.text.ini file, as described in the Providing Multilanguage Support.
The following messages and captions can be overridden:
- CHECK_MESSAGE — This message appears at the very beginning of processing. End user is requested to specify password of the target user to be cached. Default value is Specify target user password to begin processing".
- PROCESS_MESSAGE — Message that appears during resource processing. The default value is Resources are being processed, please wait.\r\n===================================\r\n.
- SUCCESS_MESSAGE — Message that appears after processing of resources is completed by Vmover, and right before CCU starts to move computer to target domain. By default, it is Resource processing was completed.
- REBOOT_JOIN_TIMEOUT — Restart timeout after computer is moved to the target domain (by default, 60 seconds).
- REBOOT_JOIN_MESSAGE — Message that appears before computer is moved to the target domain and restarted. The default value is Your computer will be now moved to the target domain, and then restarted.
- MOVE_FAILED_MESSAGE — Message that appears if CCU fails to move the computer to the target domain. Default value is Failed to move computer to the target domain.\r\nFor details see log files.\r\n%USERPROFILE%\Application Data\Quest Software\CacheCred\cachecredui.log\r\n%ALLUSERSPROFILE%\Application Data\Quest Software\CacheCred\cachecredsvc.log.
- CAPTION — General title for all windows. Default value is Cached Credentials Utility.
- CHECK_CAPTION — Title of the first window.
- PROCESS_CAPTION — Title of the process message window.
- SUCCESS_CAPTION — Caption of the window which appears after processing of resources is completed by Vmover, and right before CCU starts to move computer to target domain.
- MOVE_FAILED_CAPTION — Caption of the window which appears if CCU fails to move the computer to the target domain.
|
|
TIP: To start a new line you can use \r\n in the above messages. |