Refreshing workspaces

Workspace links to IPLM Cache and generated files can be refreshed if they are deleted or are out of date due to configuration changes.

Workspace refresh overview

Several workspace regeneration functions are bundled in the Helix IPLM workspace refresh functionality:

Function	Option	Description
Restore missing Picache IPVs	Default	IPLM Cache managed IPVs can be missing if they have been cleaned up, or removed via the 'pi-admin picache remove' command Workspace refresh restores any missing IPVs required by the workspace into IPLM Cache.
Refresh workspace derived files	Default	Files generated via the Workspace Configuration options in piclient.conf might be intentionally or accidentally modified. Workspace refresh will regenerate them based on the current state of the workspace.
Reset the P4 client View (p4 IPs only)	--reset	Manually changing the P4 client is discouraged, it should normally be left to Helix IPLM to manage. If it does get manually modified the --reset option can be used to correct it.

Function

Option

Description

Restore missing Picache IPVs

Default

IPLM Cache managed IPVs can be missing if they have been cleaned up, or removed via the 'pi-admin picache remove' command

Workspace refresh restores any missing IPVs required by the workspace into IPLM Cache.

Refresh workspace derived files

Default

Files generated via the Workspace Configuration options in piclient.conf might be intentionally or accidentally modified.

Workspace refresh will regenerate them based on the current state of the workspace.

Reset the P4 client View (p4 IPs only)

--reset

Manually changing the P4 client is discouraged, it should normally be left to Helix IPLM to manage. If it does get manually modified the --reset option can be used to correct it.

Command line

The 'pi ws refresh' command is used to refresh Helix IPLM workspaces.

pi ws refresh Command

> pi ws refresh -h
Usage: pi workspace refresh [-h] [--wsdir WSDIR] [--reset]

Description: Refresh a Workspace. Regenerate derived files and restore missing
refer IP Versions in the cache.

Optional arguments:
  --reset               Reset the P4 client View field so that it contains
                        only the lines generated by Pi.
  --wsdir WSDIR, -ws WSDIR
                        The Workspace directory. If not specified, the current
                        directory should be a Workspace directory.
  -h, --help            Show this help message and exit

Resetting the P4 Client (P4 IPVs only)

If the p4 client is modified manually it may cause issues with normal Helix IPLM operations. To reset it to the state Helix IPLM expects use the '–reset' option.

Command Option	Description
--reset	Reset the Perforce client view spec to the state Helix IPLM expects.