Command Central 10.3 | 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."