Importing/upgrading a repository

The repository-import command allows you to upgrade a legacy Structure101 filesystem repository to the more scalable format released with Structure101 Version 7. It also allows you to transform a repository from one storage format to another. It can even be used to import individual projects/snapshots from one repository to another, using the optional -projectFilter= and -snapshotFilter= command line arguments. It has 2 required command line arguments, -source= and -target=, taking the form:

java \
    -cp structure101-.jar \
    com.structure101.headless.S101HeadlessCmdRunner \
    repository-import \
    -source=/path-to/old-structure101-repository-dir \
    -target=/path-to/new-empty-structure101-repository-dir

The following optional arguments are supported:

• projectFilter: only the named project will be imported to the target repository,

• snapshotFilter: If specified it must be used in conjunction with the projectFilter argument. Only the named snapshot from the named project will be imported to the target repository.

Note: if the -target argument points to an empty directory, the -source repository will be copied to the -target in the more scalable filesystem format released with Structure101 Version 7.

Adding a repository

Structure101 Build, Workspace, Dashboard and the Soda Dependency Database access repositories directly by reference (see below). However, Studio must first "add" a local, remote, or third-party repository before publishing or loading a project snapshot.

Publishing a project

To publish your first project, you can use Studio publishing, or Build publishing.

Loading your repository project

To load a repository project in Workspace, see opening a Workspace project. Please note, Workspace is currently designed to work only with local repositories, and projects.

To load or publish a repository project in Studio, see the switching repositories section.

To work with repositories using Build, see the Build configuration section.

To view a repository project in Structure101 Dashboard or Soda Dependency Database simply navigate to the appropriate URL determined by how Dashboard or the Soda Dependency Database was configured during setup.

Upgrading a Version 4 repository

Structure101 introduced the concept of 'key measures' in Version 5. If you have a legacy Version 4 repository, we recommend you first upgrade to the Version 5 format using the following command:

java -cp structure101-cpa-build.jar com.structure101.headless.S101HeadlessCmdRunner repo-generate-measures -repository=YOUR_REPO_DIR -projectFilter=YOUR_PROJECT_NAME

The repository argument must be provided. The projectFilter argument is optional and can be used to selectively upgrade projects in the repository as they are transitioned to Version 6.

You can then upgrading to Version 7 as above.