IBM WebSphere Integration

From Seapine Labs

Contents 1 Installing the WebSphere plug-in 2 Sharing projects 3 Configuring Surround SCM preferences 4 Surround SCM tasks

[edit] Installing the WebSphere plug-in

1. Start WebSphere.
2. Choose Window > Open Perspective > Install/Update to open the Install/Update Perspective.
3. Right-click in the Features Update pane and select New > Site Bookmark.
4. Enter a name for the new bookmark and set the URL to http://downloads.seapine.com/pub/eclipse/surround/.
5. Select WebSphere update site.
6. Click Finish. The site folder you created is displayed in the Feature Updates window.
7. Expand the site folder and select the Surround SCM WebSphere Team plug-in you want to install.
   The Preview pane displays information about the Surround SCM plug-in.
8. Click Install Now in the Preview pane to begin the installation.
9. Follow the on-screen instructions to install the plug-in.
10. Click Yes when you are prompted to restart WebSphere. The plug-in is installed and ready to use.

[edit] Sharing projects

1. Open the WebSphere project.
2. Select the project and choose Team > Share Project.
3. Select Surround SCM.
4. Click Finish. The Seapine Surround SCM Login dialog box opens.
5. Select the Server you want to connect to.
   Click Setup to configure Surround SCM Servers.
6. Enter your Username and Password.
7. Click Browse to select a branch and repository. The repository browser opens.
8. Select the Branch and Repository you want to point the project to.
   Click Create Repository to create a new repository for the project.
9. Click OK. You return to the Surround SCM Login dialog box.
10. Select Always login with this username and password to automatically log in to Surround SCM.
11. Click Connect. You are now logged in and ready to start using Surround SCM.

[edit] Configuring Surround SCM preferences

You can configure various functional and display options for the Surround SCM integration.

1. Choose Window > Preferences.
2. Expand the Team node and select Surround SCM.
3. Select a Save modified files before Surround SCM actions option.
   This option determines how modified buffers are handled when a Surround SCM action is initiated.
4. Select a When user attempts to edit a read-only file option.
   This option determines what happens when a user tries to edit a local, read-only file in the WebSphere editor.
5. Expand the Surround SCM node and select Label Decorations to set decoration options.
   Label decorations provide visual indicators about a file or project by modifying its label.
6. Click the Icon Decorations tab and select any options.
   Icon decorations decorate nodes with icons based on their Surround SCM status. These options require extra processing by Surround SCM and may slow down performance.
7. Select Decorate projects to decorate project nodes based on their sharing status.
8. Select Decorate files to decorate file nodes based on their existence in Surround SCM.
9. Select Include file check out status to decorate file nodes based on check out status.
10. Select any Text decoration options.
    Text decorations decorate nodes with text based on their Surround SCM status.
11. Select Decorate files to decorate file nodes based on their existence in Surround SCM.
12. Select Include file check out status to decorate file nodes based on check out status.
13. Select Include file's local status to decorate file nodes based on local status compared to repository status.
14. Click OK to save your changes.

[edit] Surround SCM tasks

The following commands can be accessed from the Surround SCM menu or the WebSphere Team shortcut (right-click) menu:

You can also right-click a package or folder to access the following commands: Get, Add, Check In, Check Out, Undo Check Out, Diff (Compare With menu), History, Properties, and Remove. All package-level operations are recursive.