Chapter 11 Using Repository Versioning

Creating and restoring versions

Using Jaguar Manager, you can create versions for any repository entity type listed in Table 11-1.

Table 11-1: Version data for each entity type
Entity type	Version data contains
Server	For major and minor versions, includes only configuration properties for the server. WARNING! Unlike the application entity type, the server version data does not include installed applications, packages, or Web applications. You must create versions of these entities yourself.
Application	Includes application properties data, plus version data for each Web application and package in the application. Major versions include package and Web application implementation files, as described below.
Package	Version data for the package plus version data for each component installed in the package. A major version includes: Package property settings Package files (the file set indicated by the com.sybase.jaguar.package.files property) Major version data for each component in the package A minor version includes only package properties and minor version data for each component in the package.
Component	A major version includes configuration properties and implementation files (the file set indicated by the com.sybase.jaguar.component.files property plus the component implementation files). A minor version includes only configuration properties.
Web Application	A major version includes configuration properties and implementation files (the entire context root directory including the WEB-INF subdirectory), plus major version data for installed Web components. A minor version includes only configuration properties, plus minor version data for installed Web components.
Servlet or Web Component	A major version includes configuration properties and implementation files. A minor version includes only configuration properties.
J2EE Client	A major version includes configuration properties and implementation files. A minor version includes only configuration properties.

Manually creating a new version

Highlight the entity of interest.
Select File | Versioning, then select:
- Save Minor Version to create a new minor version, or
- Save Major Version to create a new major version.
Enter a comment describing the version and click OK.
Jaguar Manager creates a new version archive for the entity. If the entity contains nested entities (see Table 11-1), Jaguar Manager creates new versions for each nested entity.

Viewing version history

Version history shows the version number, creation date, and comment for all available versions of an entity. To display version history:

Highlight the entity of interest and select File | Versioning | List Versions.
Jaguar Manager displays a list of version numbers, creation dates, and the corresponding comments.

Restoring a version

Restoring replaces the current configuration and implementation files with the saved version files.

WARNING!
Restore overwrites the current configuration and implementation. Save the current version first if you may need to restore it in the future.

To restore a version:

Highlight the entity of interest and select File | Versioning | Restore Version.
Jaguar Manager displays a list of available versions and the corresponding comments.
Highlight the version to be restored, then click OK.