Integration with Other Applications > Integrated Software Management > Software Configuration Management Integrations > Adapters Management for Site and Organization Administrators > Working with IBM Rational ClearCase Adapters > Creating an Adapter
  
Creating an Adapter
Follow the instructions in this section to create or recreate IBM Rational ClearCase adapters at the site and organization levels.
When Upgrading From Windchill 9.x
Create and manage the IBM Rational ClearCase adapters for your site or organization.
• A Site or Organization administrator must recreate the IBM Rational ClearCase 9.x adapters, including the default adapter, installed for your site or organization at Windchill 9.x. The ClearCase Administration utility has been replaced with the Adapters Administration utility in Windchill. The Site or Organization administrator must use the same IBM Rational ClearCase adapter names and attributes in the Adapters Administration utility as originally created in the old ClearCase Administration utility.
* 
After you have recreated the IBM Rational ClearCase 9.x adapters, including the default adapter; reconfigure the IBM Rational ClearCase adapters associated with the IBM Rational ClearCase 9.x content. Refer to How to Reconfigure the IBM Rational ClearCase Adapter for detailed instructions.
• Create and manage any new IBM Rational ClearCase adapters for your site or organization.
* 
A Site or Organization administrator must create and manage any new IBM Rational ClearCase adapters before using Windchill Integrations for Embedded Software.
When Upgrading from Windchill 10.0x or 10.1x
The IBM Rational ClearCase adapters in the Windchill 10.0x or 10.1x are automatically migrated to the newer version of Windchill.
Create and manage any new IBM Rational ClearCase adapters for your site or organization.
* 
A Site or Organization administrator must create and manage any new IBM Rational ClearCase adapters before using Windchill Integrations for Embedded Software.
When Installing Windchill for the First Time
Create and manage the IBM Rational ClearCase adapters for your site or organization.
* 
A Site or Organization administrator must create and manage IBM Rational ClearCase adapters before using Windchill Integrations for Embedded Software.
Creating an Adapter Procedure
This procedure describes how to create IBM Rational ClearCase adapters at the site and organization levels.
1. From Site > Utilities or Organizations > Utilities select Adapters Administration in the System Administration section of the page to open the Adapter Administration window.
2. From the Adapter Definition table, select Create a new adapter to open the Adapter Definition window.
3. From the Select an Adapter Type pull-down list, select Rational ClearCase (SCM). The Set Adapter Attributes section of the window opens.
4. Enter the adapter attributes as shown in the table.
* 
No field can be left "blank” except for the Display Name field.
Field
Description
Adapter Name
The descriptive and unique name to identify the name of the adapter machine. The adapter name can have alphanumeric, dot, and underscore characters only.
* 
The adapter name cannot contain special characters or spaces. Do not use a dot as the first or last character in the adapter name.
* 
When creating multiple adapters, do not use identical adapter names. This results in not being able to differentiate between multiple adapters in the system.
Display Name
The descriptive and unique name to identify the adapter that is easily understood by users. The adapter display name can have special characters and spaces. This field is optional.
* 
When creating multiple adapters, do not use identical display names for adapters. This results in not being able to differentiate between multiple display names in the system.
Adapter View Host
The host name of the computer where the adapter is installed.
Adapter Port Number
The port number of the adapter. The port number has to be an integer in the 1024–65535 range.
* 
Do not use port numbers that are reserved from other applications.
Adapter View Base Path
The path of the view base on the adapter machine.
* 
The adapter view base path must be created on the same machine as the adapter machine.
Adapter Viewstore Path
The path to the viewstore directory on the adapter machine. On Windows, this can also be the share name for the directory. On Windows, it is mandatory to share the “viewstore” directory and specify it.
* 
The adapter viewstore path must be created on the same machine as the adapter machine.
Adapter View Pool Size
The number of internal views used by this adapter. The adapter view pool size must be a positive integer.
Compressed File Format
The type of file (.ZIP or .JAR) that is created when an adapter primary source or attachment content is uploaded.
Adapter Temporary Files Directory
The location on the adapter machine used for the temporary adapter files.
5. When finished, select one of the following options:
Action
Description
OK
After clicking OK, the Site > System Administration window displays while the system is saving and loading the new adapter in the Adapter Definition table.
On the successful creation of the new adapter, the confirmation message, “You have successfully created the new adapter: <adapter name>” displays.
Click Adapters Administration to return to the Adapters Administration utility to perform other actions, or to view the Adapter Definition information page for the newly created adapter.
Cancel
Exits the Adapter Definition window without creating the adapter.
6. Restart the Windchill server.