vCO Package import/export command line tool

Description:

Command line tool, that provides basic vCO package import and export operations. As source or target it can have either .package file, or directory.

Usage:

java <java-parameters> -jar PackageToolCli.jar <command> <command-parameters>

Commands:

These are the basic commands that tell the tool which operation to perform.

• fi - file import
  • Imports package to vCO from .package file.
• fe - file export
  • Exports vCO package to .package file.
• di - directory import
  • Imports package to vCO from directory tree.
• de - directory export
  • Exports vCO package to directory tree.
• fd - file from directory
  • Creates .package file from directory tree.

Command Parameters:

The direct parameters that pertain to the specific command. Source or destination files or directories.

• fi
  • - Name of the .package file to import.
• fe
  • - Name of the package to export.
  • - Directory to which to export. If not specified, current directory is assumed.
• di
  • - Directory from which to import.
• de
  • - Name of the package to export.
  • - Directory to which to export. If not specified, current directory is assumed.
• fd
  • - Directory from which to build .package file.

##Java Parameters: Additional parameters that may be needed by the system, in order to perform the specific commands.

• -DserverUrl=<user:password@serverurl>
  • URL and login of the vCO server against which the imports or exports will be performed.
• -DallowedMask=
  • Access attributes of the package.
  • v - elements can be viewed
  • e - elements can be edited
  • f - elements can be forwarded in another package
• -DkeystoreFileLocation=<path-to-vmokeystore-file>
  • Path to the .vmokeystore file that contains the development certificate
• -DkeystorePassword=<vmokeystore-password>
  • Password of the .vmokeystore file
• -DexportVersionHistory=<true|false>
  • Export version history
• -Dincludes=<include-pattern-list>
  • ';'-separated list of patterns showing which elements to include.
• -Dexcludes=<exclude-pattern-list>
  • ';'-separated list of patterns showing which elements to exclude.

Examples:

Export package com.vmware.test.TestPackage as a package file in the current folder.

java -DserverUrl=username:password@myserver:8281 -jar PackageToolCli.jar fe com.vmware.test.TestPackage

Export package com.vmware.test.TestPackage as directory structure in the current folder.

java -DserverUrl=username:password@myserver:8281 -jar PackageToolCli.jar de com.vmware.test.TestPackage

Import package file com.vmware.test.TestPackage.package to vCO server.

java -DserverUrl=username:password@myserver:8281 -jar PackageToolCli.jar fi com.vmware.test.TestImpex.package

(Note: the next two commands require development certificate in order to be performed)

Build .package file from directory structure.

java -DserverUrl=username:password@myserver:8281 -DkeystoreFileLocation=/path/to/my_cerificate.vmokeystore
       -DkeystorePassword=mypassword -jar PackageToolCli.jar fd com.vmware.test.TestPackage

Import package directory structure com.vmware.test.TestPackage to vCO server.

java -DserverUrl=username:password@myserver:8281 -DkeystoreFileLocation=/path/to/my_cerificate.vmokeystore
     -DkeystorePassword=mypassword -jar PackageToolCli.jar di com.vmware.test.TestPackage

The last two commands also support the allowedMask, exportVersionHistory and includes/excludes java parameters, which give more control to the content and access attributes of the package. -DallowedMask=vf Creates package that can not be editted. -DexportVersionHistory=true Preserves the local version history of developed vCO objects between exports and imports. -Dincludes="/Test Package//.element_info.xml;/Test Samples//.element_info.xml;/testPackage//*.element_info.xml" Includes only objects that have ".element_info.xml" descriptor (which is specific for packages exported as directory trees), from library folders Test Package and Test Samples (for workflows) or testPackage package (for actions).