Generate Baseline Package
To create a Baseline package:
- Log on to TeamForge and select a project from My Workspace.
- Click Baselines from the Project Home menu.
- Select (click) an approved Baseline or Project Baseline from the list of baselines.
- Click Generate Package.
- Type a name for the package.
Select one or more categories that the package must include.Note: The components available to select are those included in the Baseline or Project Baseline. You cannot generate more than one package for the same category (or the same set of components).
External Baselines, if part of a Baseline or a Project Baseline, can be included when you generate the Baseline/Project Baseline package.
Such External Baselines, if included, are available as TAR files in the baseline package.
Click Generate. A package is generated and listed on the Packages tab.
For a baseline including configuration items with large volume of data, there would be a delay in generating the package and the package status is shown as “Package is being generated”. In such cases, a “Click to refresh” link is provided to refresh the status of the package being generated.
When there are packages with the status “Package is being generated” on the Packages tab, the packages list is automatically refreshed every one minute until all the packages are generated. You can continue to use the Click to refresh link to manually refresh the package(s).
Package generation fails for baselines that include documents with slash (“/”) delimiter in the document name.
The Baseline service may go down during the baseline creation or the package generation process, which may obstruct subsequent baseline operations. Restart the Baseline service (
teamforge stop -s teamforge-baselineand
teamforge start -s teamforge-baseline) to restore baseline operations.
Download Baseline Package
Once you generate a baseline package, you can download it to extract the package contents or share it with stakeholders, if required.
To download the required package, click the Download icon. A TAR file will be downloaded to the location specified in the baseline configuration file.
View Baseline Package
Once you download a package, you can extract the downloaded TAR file and view its contents.
Example baseline package folder structure:
Every baseline package contains the following files:
index.pdfthat shows the list of all Tracker Artifacts, Documents, File Releases, Source Code Repositories, and Binaries, if these are included in the Baseline or Project Baseline from which the package was generated.The new
index.pdffile (created when you generate a baseline package) replaces the
index.htmlfile to better handle large volume of data associated with baselines with a large number of objects.
The JSON file for each configuration item included in the Baseline or Project Baseline from which the package is generated. Each JSON file contains the manifest fields and the response specific to that configuration item.
packageInfoJSON file that contains the package details such as package id, title, status, category selected during package generation, user name, package creation date, download path.
filesfolder that contains all the files attached to the configuration items included in the Baseline or Project Baseline from which the package was generated.
A TAR file for each external baseline included in the Baseline or Project Baseline from which the package is generated.