sagcc add repository assets flatfile

Software AG Command Central 10.2 | Command Central Developer Reference | Using the Command Line Interface | Repository Commands | sagcc add repository assets flatfile

sagcc add repository assets flatfile

Add a flat file repository that contains user-created source assets.

Syntax

Command Central syntax:

sagcc add repository assets flatfile name=repoName
[location=flat-file-repo-folder-or-zip-on-server|-i flat-file-repo-zip-on-client]
[registryRoot=URL] [registryNamespacesRoot=URL]
[description=description] [overwrite=true|false][options]

Not supported by Platform Manager.

Arguments and Options

Argument or Option	Description
name=repoName	Required. A unique name for the flat file repository that you are adding.
location=flat-file-repo-folder-or-zip-on-server	The path to the directory on the Command Central server that contains the flat file repository or the zip archive of the flat file.
-i flat-file-repo-zip-on-client	The path to the zip archive of the flat file repository on a client machine.
[registryRoot=URL]	Optional. A valid URL that points to the location of the registry that stores the metadata for the assets in the flat file repository. The registry is located inside the local directory that stores the flat file repository. For example, if the flat file repository is located in the C:\fileRepo directory and the registry directory is "MyRegistry", you must set this parameter as follows: registryRoot=/MyRegistry
[registryNamespacesRoot=URL]	Optional. A valid URL that points to the location of the directory that stores the registry namespaces. The namespace directory is located inside the registry directory. For example, if the registry directory is C:\fileRepo, you must set this parameter as follows: registryNamespacesRoot=/MyRegistryNs
[description=description]	Optional. A description of the asset repository.
[overwrite=true\|false]	Optional. Use this argument when re-posting build artifacts from a Jenkins CI job. When the argument is set to true: If the repository does not exist, Command Central creates the repository. If the repository exists, Command Central removes the existing repository and creates a new one. The default is true.
[options]	Optional. The command allows all options supported by the Command Line Interface. For a description of the options, see Common Options.

Usage Notes

You must specify where the flat file repository is located either using the location argument, or the input file option.

If you do not specify values for the registryRoot and registryNamespacesRoot arguments, Command Central resolves the directory path to "." and looks for the registry at the root of:

the folder that you specify in the location argument

in the Software AG_directory /profiles/CCE/data/flatfile/<repoName> directory. If you specify a zip archive, Command Central unzips the archive in this directory (regardless of whether the archive is located on the server or client).

When creating or updating an asset repository, you can check the progress of the operation and troubleshoot issues using Jobmanager Jobs Commands or in the Command Central web user interface, go to Stacks > Jobs.

Example When Executing on Command Central

To add a flat file asset repository with name "f1" from a folder on the Command Central server:

sagcc add repository assets flatfile name=f1 location=C:\CommandCentral\AssetRepo
description="Local asset build repository"

To add a flat file asset repository with name "f1" from a zip archive, located on the Command Central server:

sagcc add repository assets flatfile name=f1 location=C:\CommandCentral\AssetRepo.zip
description="Local asset build repository"

To add a flat file asset repository with name "f1" from a zip archive, located on the client:

sagcc add repository assets flatfile name=f1 -i C:\CommandCentral\AssetRepo.zip
description="Local asset build repository"

In this example, registryRoot and registryNamespacesRoot are not included and Command Central resolves them to the default values:

registryRoot="." registryNamespacesRoot="."

To add a flat file asset repository with name "f1" from a zip archive, located on the client, specify "MyRegistry" as the registry directory, and "MyRegistryNs" as the directory for the registry namespaces:

sagcc add repository assets flatfile name=f1
-i C:\CommandCentral\AssetRepo.zip registryRoot="/MyRegistry"
registryNamespacesRoot="/MyRegistryNs" description="Local asset build repository."

Copyright © 2013-2018 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Innovation Release