Integration with Other Applications > Integrated Software Management > Software Configuration Management Integrations > Adapters Management for Site and Organization Administrators > Working with Subversion Adapters > Creating an Adapter
  
Creating an Adapter
Follow the instructions in this section to create local and remote Subversion adapters at the site and organization levels.
Local versus Remote Subversion Adapter
A local Subversion adapter is one that:
• Is installed on the same host machine as Windchill, including Windchill Integrations for Embedded Software.
• Uses a repository URL address.
A remote Subversion adapter is one that:
• Not installed on the same host machine as Windchill, including Windchill Integrations for Embedded Software.
• Runs on a separate Java Virtual Machine (JVM) than the Windchill Method Server.
• Uses a repository URL address
• Uses an adapter view host and port number.
• Used as a remote client.
Creating an Adapter Procedure
This procedure describes how to create local and remote Subversion 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 Subversion (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 remote adapter is installed.
* 
Do not use mixed case letters when creating the adapter view host name.
Adapter Port Number
The port number of the remote 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.
Repository URL
The URL location of the Subversion server. The repository must exist in your directory relative to your naming service search base. Typically this value is your fully qualified host name.
* 
Use the Repository URL field to connect the Subversion adapter with the Subversion server.
When entering values such as URIs and URLs into the Property Administrator, Info*Engine identifies filepaths using the forward slash (/) as the separator in LDAP entries. The back slash (\) character is used as an escape character.
* 
The forward slash (/) is the directory separator used on Windows systems.
User Name
The server authenticates the given username using the corresponding supplied password.
The user name is mandatory only if the Subversion system requires authentication for accessing the files.
If the password is necessary, enter the user’s existing user name from the Subversion system web server.
Password
The server authenticates the given password using the corresponding supplied user name.
The password is mandatory only if the Subversion system requires authentication for accessing the files.
If the password is necessary, enter the user’s existing password from the Subversion system web server.
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 predefined directory in the given host machine for 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.