Placing a project into a CVS repository

Placing a project into a repository enables version control of that project and makes it accessible to other users of the version control system. In JBuilder, placing a project into the repository also involves configuring the connection to the repository that the project will use.

The Place Project Into CVS wizard configures the project's connection to CVS, creates a module in CVS, checks your project into it, and immediately checks it back out to you so you can work on it.

If you try to place a project using a .jpr type of project file into CVS, JBuilder will prompt you to convert the .jpr project file to a .jpx project file. The .jpx file type is designed for shared environments. The .jpr file is not suitable for shared projects.

The wizard has three steps: CVS Module Properties, CVS Project Description, and Choose Directories And Files To Include.

Step 1: CVS Module Properties

The Module Properties page has up to three areas to complete, depending on your settings.

Note that the CVSROOT path is displayed at the bottom of the dialog box. For more information on CVSROOT, please see "Checking and setting user environment variables" in the "CVS Reference" in Team Development Using JBuilder.

Connect Type

Choose the type of server you need to connect to in order to access CVS.

If you have any questions about your connection type, ask your CVS administrator.

Login Settings

Enter your login settings according to the requirements of your connection type.

Module Location

Repository Path

Type in or select the path to an existing CVS repository. If you're using a local repository, you can click the ellipsis button to browse to it.

Module name

Type in the name you want to give the new module.

JBuilder stores previously-used paths and module names, and makes them available from drop-down lists in this page of the wizard.

Caution: You can use the same name for modules in different repositories without overwriting the existing module. However, if you use the same name and the same repository, the existing module will be overwritten.

Step 2: CVS Project Description

The second step of the wizard prompts you for a comment describing the new module. Fill this in according to your usual policy in CVS.

Step 3: Choose Directories And Files To Include

The last step of the wizard allows you to choose which files to place into the module. The rest will remain local, available only to you.

To include a whole directory, check the checkbox next to the directory.

To include only certain files within the directory, expand the directory by clicking the widget beside the directory's checkbox and check the files and subdirectories that you want to include.

The .jpx project file is always included because of the shared information it provides for the project. Once under CVS control, the project file is updated and committed separately from the rest of the project.

Backup and output files (including temp directories used for web application .jar files) are unchecked by default.



Placing a project into a Visual SourceSafe database

Placing a project into a VSS database enables version control of that project and makes it accessible to other users of the version control system. In JBuilder, placing a project into the database also involves configuring the connection to the database the project will use.

The Place Project Into Visual SourceSafe wizard configures the project's connection and takes an existing JBuilder project and creates a corresponding VSS project in an existing VSS database.

Normally, the wizard has five steps. However, if JBuilder doesn't have the path to the Visual SourceSafe runtime directory, this wizard has six steps: the first step sets this path. Once the path is set, it doesn't have to be set again.

One-time step: Setting the path to the runtime directory

This sets the path to the VSS database executable. It's usually the ss.exe file within the win32 directory on the VSS server. If you can't find anything that matches that description, contact your Visual SourceSafe administrator for the correct path.

Click Next to go to the next step.

Step 1: Select Visual SourceSafe Database Directory

This points JBuilder to the directory containing the srcsafe.ini file, which it needs to use to access the database. Type it in or click the ellipsis button to navigate to it. If you don't know where it is, contact your VSS administrator.

Click Next to go to Step 2.

Step 2: Enter Username And Password

Enter the username and password which you use to access Visual SourceSafe.

Click Next to go to Step 3.

Step 3: Select Directories And Files To Include

If you want to check an entire directory into VSS, check the directory's checkbox here.

If you want to include some files but not others, expand the directory by clicking the widget next to the directory. The files and subdirectories will appear in a tree below it.

Check the files and subdirectories you want to include in this project. Unchecked directories will not be placed in the database.

Click Next to go to Step 4.

Step 4: Select Files To Keep Checked Out

Once the project has been placed into VSS, the files you choose here will be checked out to you so you can work on them right away. The other files will be checked in without being checked back out to you.

If you later decide to work on those other files, select Check Out File either from the Team menu or from the context menu in the project pane.

Click Next to go to Step 5.

Step 5: Select Location In VSS Database

Set the location and the project name for this project in VSS.

Location

Type in or choose the name of an existing root VSS directory to put the new project directory into.

Project Name

Type in a unique name for this project.

Finish button

Click Finish to create the connection and place the project into the database. JBuilder displays a feedback dialog that reports the progress of the command. Click OK to close the dialog when it's done.



Place Project Into A New ClearCase VOB

The Place Project Into A New ClearCase VOB wizard creates a new VOB, configures the project's connection to the ClearCase server, and selects a view to use to mount the VOB.

You must have suitable access to create a new VOB in ClearCase. If you don't but you have created a project that needs to be put into a VOB, please contact your ClearCase administrator.

Tip: Once a VOB has been created, you can mount it from within JBuilder using the Pull Project From ClearCase command available from both the Team menu and the object gallery (File|New, Project tab.)

Place Project Into A New ClearCase VOB wizard

This wizard has one step with five fields: Tag, Storage Path, View, ClearCase Registry Password, and Comment.

Tag

Type in the name of the mount point for the new VOB.

Storage Path

Type in or select the path to the physical location the new VOB will have on the ClearCase server.

View

Type in or select the view you want to use to access the new VOB. The VOB will be mounted in the view as soon as it's created.

ClearCase Registry Password

Type in your password to the ClearCase registry.This allows JBuilder and ClearCase to verify that you have the access to create this VOB.

Comment

Type a description of the new VOB, according to your company's usual practices.

Click the Next button to create the new VOB. JBuilder will display a feedback dialog that displays the progress of the VOB creation.

When the VOB is created, click OK to close the feedback dialog.