Skip to the content.

IBM UrbanCode Deploy Versioned File Storage - Process Steps

Download Artifacts

Download artifacts from a VFS server.

Name Type Description Required
Artifact Directory Offset String The base directory from which artifacts will be retrieved from the Component Version. For example, using App/Dist will only get all files from in the App/Dist directory and put them in the Current Working Directory. All includes/excludes will be evaluated relative to this offset. No
Charset String The Character set that files whose metadata includes a character set should be converted to upon download (e.g. UTF-8). If this field is left blank then the system’s default charset will be used. No
Directory Offset String The working directory to use when executing this command. This is relative to current working directory. Yes
Excludes String The patterns to exclude files to upload. No
Full Verification Boolean (Valid only with Sync Mode enabled) When selected, hashes will be computed on each file in the destination artifact set to determine whether network transfer is necessary. Otherwise, files will be compared by date modified and size. No
Handle Incremental Versions Boolean (Valid only with Sync Mode enabled) When selected, incremental version handling is enabled. When not selected, the legacy behavior is enabled, which is to handle incremental versions as though they are full versions. Enabling incremental version handling has two effects. First, when deploying a full version, all versions back to the most recently deployed full version are considered when determining which files to update or remove; the legacy behavior will only consider the the single most recently deployed version. Second, deploying an incremental version will not remove files from all currently deployed versions and will restore missing files from those versions; the legacy behavior will remove files from the single most recent currently deployed version and ignore files from other currently deployed versions. For server versions before 7.1.1.0, there is a negative performance impact to enabling this feature due to API availablity. The impact is the greatest for versions 6.2.7.0 through 7.1.0. Until 7.1.1.0, is not recommended to enable this feature unless you use incremental versions. No
Includes String The patterns to match files to upload. The wildcard ** indicates every directory and the wildcard * indicates every file. So the pattern dist/**/* would retrieve the entire file tree underneath the dist directory. Yes
Set File Execute Bits Boolean When enabled, sets file execute bits on the files which have them set in the repository. No
Sync Mode Enumeration: false / true / FULL Sync transfers only changed files, removing files that exist only in the previously deployed version. Clean removes all files not contained in the currently deployed version No
Verify File Integrity Boolean When enabled, verifies downloaded files match their hash. Enabling this may reduce performance. No

Compare version Artifacts for zOS

Compare two zOS version artifacts with new package format

Name Type Description Required
Version-1 String First version name. Yes
Version-2 String Second version name. Yes
Component Name String Name of the component that contains versions. Yes

Download Artifacts for zOS

Download zOS component artifacts from a VFS server.

Name Type Description Required
Directory Offset String The working directory to use when executing this command. This is relative to current working directory. Yes

Sync Artifacts

Compare local artifacts with the artifacts expected to be on the resource according to its inventory, and remediate any differences.

Name Type Description Required
Charset String The Character set that files whose metadata includes a character set should be converted to upon download (e.g. UTF-8). If this field is left blank then the system’s default charset will be used. No
Excludes String The patterns to exclude files to upload. No
Includes String The patterns to match files to upload. The wildcard ** indicates every directory and the wildcard * indicates every file. So the pattern dist/**/* would retrieve the entire file tree underneath the dist directory. Yes
Set File Execute Bits Boolean When enabled, sets file execute bits on the files which have them set in the repository. No
Verify File Integrity Boolean When enabled, verifies downloaded files match their hash. Enabling this may reduce performance. No

Upload Artifacts

Upload artifacts to a VFS server.

Name Type Description Required
Directory Offset String The working directory to use when executing this command. This is relative to current working directory. Yes
Excludes String The patterns to exclude files to upload. No
Includes String The patterns to match files to upload. The wildcard ** indicates every directory and the wildcard * indicates every file. So the pattern dist/**/* would retrieve the entire file tree underneath the dist directory. Yes
Save File Execute Bits Boolean When enabled, file execute bits are saved with the files. No
Text File Extensions String A comma separated list of extensions of files need to be converted to a new character set on download (e.g. txt,properties,log). This should be used in cases where the OS the files are being deployed to requires a different character set than the one uploading the files into the server. No

Verify Local Artifacts

Compare artifacts on local machine with inventory.

Name Type Description Required
Directory Offset String The working directory to use when executing this command. This is relative to current working directory. Yes
Excludes String The patterns to exclude files to upload. No
Includes String The patterns to match files to upload. The wildcard ** indicates every directory and the wildcard * indicates every file. So the pattern dist/**/* would retrieve the entire file tree underneath the dist directory. Yes
Back to …   Latest Version IBM UrbanCode Deploy Versioned File Storage    
All Plugins Deploy Plugins 48.1172096 Readme Overview Downloads