Appendix: Clearing Environment Management Framework Cache

To ensure consistent behavior across all the elements of the Environment Management Framework, at times, it is necessary to clear the cache stored within each element. Clearing the cache just on the web server for the Hub, for example, is not sufficient. To re-initialize the entire framework, you need to perform this cleanup on:

• All agents

• Change Assistant

• Viewer

• Hub

When to Clear Environment Management Framework Cache

After analyzing customer environments and consulting PeopleSoft support, the following list reflects the most common situations in which it is recommended that you clear cache files:

• After applying a maintenance pack. Maintenance packs deliver a large number of files. Clearing the cache after applying a maintenance pack may increase performance for applying future updates.

• After applying a PeopleTools patch. Information related to previous PeopleTools releases stored in the cached directories can cause a variety of issues for Change Assistant.

• After receiving a warning during file deploys or during the validate process (Tools, Validate). This is typically related to cached references to peer IDs that are no longer used. Clearing the cache removes references to unused peer IDs.

• After Change Assistant hangs during re-validation. This is often a sign of cache issues.

• After receiving notifications that you need to apply prerequisites that have already been applied.

Note. The above list reflects the most common situations when cache should be cleared, not every possible situation. If you are encountering unexpected behavior, one element of your troubleshooting should be clearing the cache.

Clearing EMF Cache

To clear EMF cache:

1. Close the Change Assistant, stop all agents, and stop PSEMHUB.

2. Delete cache files from Change Assistant, agents, and Viewer.

   1. Navigate to the following EMF locations:

      EMF Element	Location
      Change Assistant	Change Assistant installation location. For example, c:\Program Files\PeopleSoft\Change Assistant\envmetadata
      Agents	PS_HOME\PSEMAgent\envmetadata
      Viewer	PS_HOME\PSEMViewer\envmetadata

   2. Delete the following directories:

      \PersistentStorage

      \ScratchPad

      \transactions (if it exists)

      \data\ids

   3. For Change Assistant and agents only, delete the following file:

      \data\search-results.xml

3. Delete cached files on PSEMHUB.

   1. On the web server, navigate to PIA_HOME\webserv\peoplesoft\applications\domain\PSEMHUB\envmetadata.

   2. Delete the files stored in these directories:

      \scratchpad

      \PersistentStorage

      \transactions (if it exists)

   3. Delete all objects in \data (files and subdirectories, but not the \data directory).

      For example,

      \data\*.*

4. Restart PSEMHUB.

5. Restart all agents.

6. Restart Change Assistant and Environment Management Viewer as needed.