Ericsson RSA/P Best Practice

1.3 CREATING A STARTEAM PROJECT

Projects are the most essential part of StarTeam. Most of the RSA/P specific norms are applied at the project level.

1.3.1 Choosing the right StarTeam-project implementation

RSA/P uses StarTeam in special way that is not fully supported in the current StarTeam version. At RSA/P we have many small/medium sized projects and even project-independent programs. In order to avoid “overflow” in the StarTeam-project selector, one StarTeam-project is created for each department within the RSA/P. Subprojects are then created within each department in the form of floating views.

For large projects a separate StarTeam-project can be created. Contact your local StarTeam administrator for more information on this subject.

1.3.2 Create a new small/medium size project

Select Open… from the Project menu. If you have configured the server settings correctly a server name (StarTeam Gavle) should appear in the Open dialog. Select you department and click Next.

In the next dialog box you are presented with a number of so called Views. Each view is a subset of the complete database. If you would like to create a new project, select the RSA/P/TA view (the root) and click Finish.

NOTE: The Projects and TestPrograms views/folders are part of the StarTeam RSA/P standardization and should always exist within each department.

The next step is to create a new folder (and a new view) for the project. Make sure the Projects folder is marked. Then select the New option from the Folder menu. In the first dialog box, click Next, then enter the name of the Project and a description:

Click Next> and then Finish.

1.3.3 Creating your project View

This step is very important with regards to the RSA/P StarTeam norms. Select the newly created folder and access the popup-menu with a right mousebutton click. From the popup-menu select New View.

Now, make sure the Permit items to branch item is selected and that the default item branching is set to Branch none. All project views should have these properties, since they are floating configurations (in order words, if you later change something in the subviews of the project, this view will be updated as well). Click Next.

In the next dialog, enter a name (enter the project name) and a description (enter the project description). Click Next until the following dialog is displayed:

Select No at this point since we will not do any individual branching within this view. In the Next dialog the most important view property is configured. The Specified configuration should be Floating Configuration:

Click Finish. Your project view is now created. When you reopen this project, ALWAYS select the project view. All changes and labels associated with this project should be attached to the project view.

NOTE: You can switch views at any time by using the Select View option found in the View menu.

1.3.4 Create standard folders

Within each project three standard folders should always be created: Doc, Install and Source. Create these by using the New Folder option. Within Install there should also be two folders called Files and InstallShield.

In order to simplify readability and access all project should have the same base folder structure. It is recommended to use the standard folder, however extensions and modifications must be allowed to ensure flexibility.

<< previous page first page next page >>

The information in this document is published with permission by Ericsson Radio Access.
is the trademark or registered trademark of Telefonaktiebolaget LM Ericsson.

Fox Data AB, P. O. Box 78, 194 22 Upplands Vasby, Sweden. Telephone +46-8-626 8100.
For general information, please send an e-mail to: Info. For sales inquiries contact: Sales. If you have questions about our web site, please contact Webmaster. Copyright Fox Data AB, 1993 - 2007.