Use the Source Control tab to configure source control (SC) within the AR System by creating or selecting SC projects. Administrators can also set the level of SC integration they want, for example, Enforced or Advisory mode. Here you define specific options for your SC system as well as create, add, and open SC projects. How SC is integrated with AR System differs based upon which SC application you use. You will find the SC feature especially helpful in moving applications from development to production.
Server Group Server Group Names If the server belongs to a server group, enter the name of the group in this field. This setting is shared by all servers in the server group.
Check Interval Defines how often the server communicates with other servers in the group. Each server can register its own status, determine if any server is delinquent, establish the
parameters needed for sending signals, and determine operational responsibilities. The default is 30 seconds, the minimum value is 10 seconds, and there is no maximum value. This setting is shared by all servers in the server group, and when it is changed, all the AR System servers in the group must be restarted.
Preference Server Preference Server Option
Select where you want user preferences should be read from.
The options are:
User Defined—The user can choose whether to use a preference server, and this server might or might not be used depending on whether the Centralized Preference forms are defined.
Use This Server—The user must use a preference server, and this server is an available preference server.
Use Other Server—The user must use a preference server, and this server is not available as a preference server. This allows the specification that a preference server must be used, but that this one cannot be used for this purpose.
Group Name Field Name Description
To use SC with AR System, you must understand the details of your SC application and database. Different SC applications will have slightly different feature sets, creating slightly different implementations with AR System. For specific information, see your SC application
documentation.
For a detailed discussion on SC issues, see the Integrating with Plug-ins and Third-Party Products guide.
Note: You must install and configure your SC system before implementing SC with AR System. The recommended method of SC integration is installing and running the SC client instead of editing paths in the system registry. A correct installation of the SC client must work properly with AR System. When using the SC system, make sure that you have enabled integration and that you have installed the SC clients.
To configure source control1 Open the server window.
2 Select a server to administer.
3 Choose File > Server Information.
4 Click the Source Control tab.
Configuring AR System servers 173 Figure 5-13: Server Information window—Source Control tab
5 Edit the options, as needed:
Field Name Description Enable Source
Control Integration
Defines if SC within AR System is activated. If this option is selected, you can configure SC software (for example, Microsoft Visual SourceSafe or PVCS Version Manager) with AR System.
6 To activate Source Code Control integration in AR System, complete the following steps:
a Click the Enable Source Control Integration check box.
The SC options in the Source Control tab become activated.
b Choose the Enforced or Advisory Mode option to define the level of SC integration you want with AR System.
c Choose to add optional check-in or required check-out comments to SC.
Mode Sets one of the following modes:
Enforced—System strictly enforces SC version control on AR System objects; for example, out and check-in. Enforced integration causes BMC Remedy
Administrator to prompt developers to check out the object when it is modified. If the system is in Enforced mode, you cannot modify and save an object if you do not check it out from SC first.
Enforced mode extends also to group permissions and bulk update operations. Developers cannot modify objects if they are not first checked out in SC.
Advisory—System warns user when SC version control is not satisfied with respect to check-out and check-in, but still allows a developer to update AR System. When a developer checks in an object, the SC system is updated only if BMC Remedy Administrator gets exclusive access to the SC system. If the system is in Advisory mode, you can modify and save an object without having it checked out from the SC and updating the Checked Out To property on AR System server. The system will prompt you with a warning but still allows you to proceed with your modifications.
Comments Required in Check In
Defines whether comments are needed when checking in system objects.
Comments Required in Check Out
Defines whether comments are needed when checking out system objects.
Provider Name Lists the SC software installed on your system. You can choose different SC software for different projects.
Project Name Opens a project dialog box to select a project and location to enter into SC.
Configuring AR System servers 175
SC comments can be optional with AR System. However, if you select to have comments required, you must enter them each time you check in or check out an object.
d From the Provider Name list, choose your SC system.
WARNING:Choose an SC system and stay with it. Do not mix SC systems.
Otherwise, you run the risk of introducing inconsistencies within the AR System server environment.
e Click Browse to create or open an SC project.
Depending on which SC application you integrate with AR System, different actions occur. For example:
With Microsoft Visual SourceSafe, you must log in to SourceSafe, then open or create a SourceSafe project.
With PVCS Version Manager, you create or open an SC project.
The contents of the read-only Project Name field provide information used only for internal server processes.
The last project opened in the Source Control tab is the current project displayed in the BMC Remedy Administrator client. If you are in an environment with multiple developers, make sure you are all using the correct project.
7 Click Apply.
Your settings are saved to the server. They define the current information for all AR System administrators and AR System application developers connected to the system. You can use the SC features as needed.
When you create an SC project in AR System, you can check into SC any object that appears in the New Server Object dialog box of BMC Remedy Administrator, except for distributed pools, distributed mappings, and groups.