Working with VMware Dynamic Environment Manager Logs

Configure FlexEngine logging settings or verify the configuration if already configured.

Table 1. Steps to Configure FlexEngine Logging
Option	Description
Path and name of log file	Enter a location that is unique for each user, and include the file name FlexEngine.log. For example: `\\Filesrv\DemUsers$\%username%\Logs\FlexEngine.log`
Log level	For the purpose of debugging, set the log level to `Debug`. Note: Do not use `Debug` or `Info` in production environments, because the amount of logging information might slow down the login and logout process.
Maximum log file size in kB	Set the maximum size of the log file. If you set a maximum log file size, the log file is created again after that size is reached. If you set the maximum size to 0, the log file expands indefinitely.
Log total size of profile archive and profile archive backups folders	FlexEngine logs the number of profile archives and profile archives backups, and their file sizes at the end of a path-based export.

Log into your target machine and then log out to allow VMware Dynamic Environment Manager to generate a log file with an "import" (login) and "export" (logout) section.

Open a FlexEngine.log file that contains at least one import and one export action.

Search for the line "Performing path-based import", and scroll up to view the line, "Starting FlexEngine...".

Check the version number to determine which version of FlexEngine is installed. Check the release notes for your FlexEngine version to see if any known issues apply to your installation.
```
[INFO ] Starting FlexEngine v9.2.0.701 [IFP#bf65d9d3-T5>>]
```
Check to see how the VMware Dynamic Environment Manager agent is started at login. VMware Dynamic Environment Manager is configured to run as a Group Policy client-side extension, a logon script, or directly from FlexService. Use a Group Policy client-side extension or NoAD mode unless a logon script is specifically required by your environment limitations. The following example shows the login mode.
```
[INFO ] Running as Group Policy client-side extension
```
Check to see if the login occurred without incident. If the user could log on, the log files show the following line.
```
[DEBUG] Performing path-based import
```

Check the log for other information, such as user name, computer name, and Windows version.

[DEBUG]    User: DEMO\uem5, Computer: H-W101, OS: x64-win10 (Version 1607, BuildNumber 14393.0, SuiteMask 100, ProductType 1/7d, Lang 0409, IE 11.0.14393.0, App-V 5.2.0.0, VMware VDM 7.2.0.5748532, UEM 9.2.0.701, ProcInfo 1/2/2/2, UTC+02:00D), PTS: 1132/4324/1CT

Note the type of profile being used (local, roaming, or mandatory). Do not use roaming profiles with VMware Dynamic Environment Manager because it causes the profile to be stored twice, causing a delay.
```
[DEBUG]    Profile state: local (0x00000204)
```

Search for the term, "Done (N ms)" where N represents the number of milliseconds. Then scroll up to view the following sections.

Check to see the overview of how many VMware Dynamic Environment Manager configuration files were processed. These files manage the personalization functionality of VMware Dynamic Environment Manager.
```
[DEBUG] Processed 58 Flex config files (30 successful, 12 skipped, 12 added to DirectFlex cache, 4 disabled)
```

View the overview of all the user environment actions that have been processed and check whether or not they have been processed successfully.

[DEBUG] Processed 2 UEM drive mappings (1 scheduled, 1 skipped)
[DEBUG] Processed 1 UEM settings import (1 disabled)
[DEBUG] Processed 3 UEM ADMX-based settings (3 successful)
[DEBUG] Processed 21 UEM shortcuts (3 successful, 6 skipped, 12 disabled)
[DEBUG] Processed 2 UEM folder redirection settings (1 successful, 1 disabled)
[DEBUG] Processed 1 UEM Horizon Smart Policies setting (1 skipped)
[DEBUG] Processed 1 UEM application blocking setting (1 disabled)
[DEBUG] Processed 1 UEM privilege elevation setting (1 disabled)

Check for indications that DirectFlex launched successfully. For example:
```
[DEBUG] Started injection
[DEBUG] Launched FlexEngine in DirectFlex mode
```
Check to see how much time it took for the FlexEngine to process all actions at login. For example, VMware Dynamic Environment Manager ran for 2391 milliseconds during the user login.
```
[INFO ] Done (2391 ms) [<<IFP#bf65d9d3-T5]
```
Check to see if a separate asynchronous FlexEngine has started to handle asynchronous drive mappings, printer mappings, and shortcuts. You can see this action logged as Triggering scheduled UEM actions. If a separate asynchronous FlexEngine has started, check the FlexEngine-async.log to see if asynchronous actions have correctly completed.

Search for the following section of the log.

[DEBUG] Performing path-based export

Review the contents of this section of the log.

Check to see if the Group Policy setting, Always wait for the network at computer startup and logon is enabled. If FlexEngine is configured to start as Group Policy client-side extension, this setting is required. For example, see the following log.
```
[DEBUG]    Policy "Always wait for the network at computer startup and logon" is enabled
```
Check to see if the GPO setting, Run logon scripts synchronously is enabled. This setting should be enabled if FlexEngine is configured to start as a logon script. For example:
```
[DEBUG]    Policy "Run logon scripts synchronously" is enabled for the user
```
Check to see which folders are redirected. Use VMware Dynamic Environment Manager config files to manage AppData and Favorites rather than redirecting them. Redirecting these folders can cause performance issues. For example, you use the VMware Dynamic Environment Manager config file, Internet Explorer-Personal Settings to manage your Internet Explorer settings. If you also redirect the Favorites folder, the Favorites files will be copied to and from the network multiple times, causing delays and slowing login times. Similarly, the AppData folder should never be redirected (regardless of VMware Dynamic Environment Manager configuration settings).
```
[DEBUG]    Redirected folders: AppData, Desktop, Favorites, Personal
```
Check for Group Policy print restrictions. These restrictions can cause conflicts with VMware Dynamic Environment Manager if you are using VMware Dynamic Environment Manager to map printers.
```
[DEBUG]    Policy "Point and Print Restrictions" is configured for the computer (1/2)
```
Check the time it took to process the user's Group Policy settings during login. If FlexEngine is configured to start as a Group Policy client-side extension, this time includes the amount of time VMware Dynamic Environment Manager was busy at login. For example:
```
[DEBUG]    User policy last applied at 2017-10-13 11:09:52.687 (took 3.960 s)
```
Check to see if profile archives are configured for compression. Performance can be slow if compression is disabled. For example:
```
[DEBUG]    Profile archives will be compressed
```
Check to see how VMware Dynamic Environment Manager is configured to handle shares that are not available at login. You can configure how VMware Dynamic Environment Manager handles unavailable Flex configuration files or user profile archives in the VMware Dynamic Environment Manager GPO Or in the NoAD.xml file if you configured NoAD mode. See "Configure Paths Unavailable at Logon Settings" in Installing and Configuring VMware Dynamic Environment Manager for more details. For example:
```
[DEBUG]    If Flex config files path is not available at logon, log off automatically
[DEBUG]    If profile archive path is not available at logon, skip import but apply user environment settings
```
Check the import status. If the import status is successful, the export is performed as normal. If the import encountered an issue, VMware Dynamic Environment Manager skips the export to prevent overwriting the user profile with incorrect information. For example:
```
[DEBUG] Import status flag indicates success, so performing export
```

Review the information at the end of the log.

Search for the term "triggered" to see if triggered tasks have been performed during the session. Note that triggered tasks are not logged until logout. For example:
```
[DEBUG] No UEM triggered tasks have been performed
```

You can also see if undo-at-logoff actions are performed.

[DEBUG] Deleted application blocking and privilege elevation configuration
[DEBUG] Processed 5 UEM shortcut undo actions (5 successful)
[DEBUG] Processed 2 UEM export tasks (2 disabled)
[DEBUG] Processed 8 UEM folder redirection setting undo actions (8 successful)

Check for an overview of the configuration files that are processed at logout. This can help you understand what user profile information is exported. For example:
```
[DEBUG] Processed 58 Flex config files (30 successful, 24 skipped, 4 disabled)
```
Check to see an overview of the size of the user profile. If the size of the files is large, it can cause delays. For example:
```
[DEBUG] Profile archive folder contains 15 files (231 kilobytes); profile archive backup folder contains no files
```
Check to see the time it took for FlexEngine to process all actions at logout. In this example, it took 1804 milliseconds to process logout actions.
```
[INFO ] Done (1804 ms) [<<IFP#05388090-24749e4]
```

Perform a search for the terms, "WARN," "ERROR," "and "FATAL" to find warning and error messages. For example, the following note indicates that DirectFlex is not configured optimally to work with Firefox.

[WARN ] DirectFlex executable configuration: Generic config file 'Applications\Mozilla Firefox.ini' refers to both fully-qualified path 'C:\Program Files (x86)\Mozilla Firefox\firefox.exe' and to 'firefox.exe'. Configuring just 'firefox.exe' would be sufficient.

Procedure