STATIC_HEAD caching mode administration

STATIC_HEAD mode is used to avoid one user updating a shared IP@HEAD in the cache, which can change a second user’s workspace unexpectedly. See STATIC_HEAD caching mode for more information on when to use this mode.

STATIC_HEAD mode is enabled or disabled in the piclient.conf file, see Configuring STATIC_HEAD for details.

@HEAD IPs loaded in STATIC_HEAD mode are not cleaned up automatically by IPLM Cache, because Automatic cleanup of the cache directories is not supported for IP@HEAD loaded into the cache in STATIC_HEAD mode. They can be cleaned manually by using the pi-admin picache remove command. See Removing IPs from IPLM Cache for more information.

Changing STATIC_HEAD mode with existing workspaces

If the STATIC_HEAD configuration is changed, different commands will behave slightly differently.

pi update honors the current setting of STATIC_HEAD at the time the command is run, so IPs @HEAD will be loaded or updated using the current STATIC_HEAD setting. See Updating the workspace for details on the update command.

pi ws refresh honors the setting of STATIC_HEAD that the workspace was loaded with, because the refresh command refreshes the current state of the workspace. See Refreshing workspaces for details on the refresh command.