Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation...

39
Your Productivity Force Multiplier Go2Group Go2Group, Inc. 138 North Hickory Avenue Bel Air, MD 21014 (877) 442-4669 www.Go2Group.com Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0

Transcript of Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation...

Page 1: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

Your Productivity Force Multiplier

Go2Group

Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669 www.Go2Group.com

Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution

Installation Guide

v2.0

Page 2: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Table of Contents

SECTION 1 – GO2GROUP MASHUP REQUIREMENTS................................................................3

WHAT’S NEEDED .........................................................................................................3 WHERE TO GET HELP ....................................................................................................4

SECTION 2 – GO2GROUP MASHUP OVERVIEW......................................................................5 USE CASES ...............................................................................................................6 USE CASE EXAMPLE.......................................................................................................6 APPLICATION AND ORCHESTRATIONS ......................................................................................6

SECTION 3 – GO2GROUP MASHUP INSTALLATION.................................................................7 INSTALLATION ASSUMPTIONS..............................................................................................7 G2G SCM WEB SERVICES COMPONENT INSTALLATION ....................................................................9 G2G SAT SBM COMPONENT INSTALLATION............................................................................. 14

SECTION 4 – EMBED G2G COMPONENT IN WORKFLOW......................................................... 21 SECTION 5 - G2G WORKFLOW CONFIGURATION ................................................................ 24

ADD TWO TARGET SERVERS TO ENVIRONMENT .......................................................................... 24 ADD ENDPOINTS TO ENVIRONMENT...................................................................................... 26 ADD VALUES FOR THE SVNCONFIG AUXILIARY TABLE.................................................................... 26 CONFIGURE SBM DATABASE ............................................................................................ 29 USE SAMPLE APPLICATION .............................................................................................. 31

SECTION 6 - GO2GROUP MASHUP TIPS AND TROUBLESHOOTING............................................ 37 GENERAL SUGGESTIONS ................................................................................................ 37 UPDATES AND UPGRADES ............................................................................................... 37

SECTION 7 – GO2GROUP MASHUP ADDITIONAL INFORMATION ............................................... 38 TECHNICAL SUPPORT ................................................................................................... 38 SALES SUPPORT ........................................................................................................ 38 LEARN MORE ........................................................................................................... 39

Page 3: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

393 3 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Section 1 – Go2Group Mashup Requirements

What’s Needed To install the Go2Group Subversion add-on for Serena, you will need the following:

• Serena Business Mashup Server

• For more information on Serena’s Business Mashup Solutions, please visit the Serena website at: www.serena.com/mashups.

• Subversion

• Either Tomcat or JBoss on Subversion. If you don’t have either, you will need to install one before beginning installation. Note: it is not required to install Tomcat or JBoss on the same server as the Subversion Server and they can be on separate servers, however, this will take some minor installation assistance form Go2Group.

• For Tomcat, you need version 5.5 or higher. This integration is only test with version 5.5. Go2Group recommends Tomcat.

• For JBoss, you need version 4.0.5 or higher. This integration was only tested with version 4.0.5.

• Java JRE 1.5.12 or higher. This integration was only tested with version 1.5.12.

• The Serena Mashup Server runs on Windows. See www.serena.com/mashups/

• In regards to the Subversion Server, this integration will only run on Windows. This integration can run on a Linux Server but will need some slight modifications in the environment setup. Go2Group can help with this until a Linux version is released.

• The client application (what your developers use on their desktop) only runs in Windows. If a Linux version is needed, please contact Go2Group, this is doable, but will require a little bit of modification on the Subversion Server side, not on the user side.

• Go2Group Subversion add-on for Serena Business Mashup (Go2Group SaT Mashup).

In addition to the technical requirements above, you will need administrator-level permissions on the Serena Business Mashup Server and Subversion when installing the Go2Group Mashup.

Page 4: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

394 4 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Where to Get Help Go2Group provides support for its entire line of products, including Go2Group Mashups. Go2Group support is available by telephone, email, and a Go2Group Mashup specific customer support ticket system:

• By telephone:

For the Americas and EMEA+1 (877) 442-4669

For Japan +81 3 5326 3073

For the rest of APAC and Australia +886 2 2708 8473

• By email: [email protected]

• By ticket: www.Go2Group.com/support

A customer login is required to access the support site above. Please contact Go2Group for your login credentials.

For support with Serena Business Mashup, please contact your Serena representative.

For support with Subversion, please contact your Subversion representative.

Page 5: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

395 5 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Section 2 – Go2Group Mashup Overview

Go2Group leverages Serena's new process-driven, Mashup approach, allowing Mashup users to view Subversion change history related to specific incidents, without ever having to leave Serena® Business Mashups. Go2Group's Subversion add-on for Serena Mashup (Go2Group SaT Mashup) displays Subversion data within Serena's tabbed interface.

Using Serena Business Mashups, a tester simply logs an incident into the Serena interface. If there is a Subversion change history log associated with the specific incident, the "SCM Change History" tab will provide a description of the changes made. The user can review change history information such as:

• The user who made the change

• The date of the change

• The location of the change

• The change history ID

• The check-in comment

The display of related change history within Serena helps keep the process flowing by providing users the information needed to make timely decisions.

Page 6: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

396 6 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Use Cases Actors - All members of the Test and Development Teams including:

• Test engineers using Serena

• Developers using Subversion

• Code/peer review participants

Products Involved:

• Serena Business Mashup for test environment

• Subversion client for developers change management environment

Questions Being Answered:

• Which source files have been checked in to resolve a specific incident?

• When were source files checked in to resolve a specific incident?

• Who checked in source files to resolve a specific incident?

• What check-in comments are available?

• Who reviewed the changes?

Use Case Example

• Issue logged in Serena

• Developer modifies files and checks them in to Subversion with comments contain a specified issue id

• Developer marks the issue as 'resolved' and transitions the issue to "Peer Review"

• The issue now displays the change history of files changed

Application and Orchestrations The Subversion add-on for Serena Mashup contains the following applications and orchestrations:

• Subversion add-on for Serena Application – Sample workflow, containing the Subversion add-on for Serena Orchestration, that displays Subversion version control history

• Subversion add-on for Serena Orchestration – Communicates with Subversion server to get change history records for specific issues

Page 7: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

397 7 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Section 3 – Go2Group Mashup Installation

This installation wizard is used to install components for the integration between Subversion and the Serena Business Mashup (SBM). The installation includes two separate installation shields, on the Subversion Server and on the Mashup Server. This section covers all two installation shields:

• G2G SCM Web Services Component on the Subversion Server:

This is for the Subversion server to provide web services interface let Business Mashup flow to get Subversion change history records.

• G2G SaT SBM Component on the Serena Business Mashup Server:

This is for the SBM server to provide web services interface to store any change history.

Installation Assumptions The following installation steps assume has completed the following:

• A local copy of the Go2Group Mashup installation file has been downloaded from the Go2Group website (www.Go2Group.com).

• A license key has been requested / received from Go2Group.

• The installer has the appropriate privileges to the Serena and Subversion servers, along with the connected database(s).

• You have coordinated with the SBM, and Subversion admins to obtain support and recycle the servers.

Page 8: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

398 8 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Installation

There are TWO separate install shields needed to install this Mashup.

The G2G SaT SBM Component which are Go2Group jar files and orchestration flow zip file that need to be placed and imported in your application flow on the Mashup Server.

The G2G SCM Web Services Component consists of Go2Group Java war file which need to be placed on the ClearCase Server.

Logically those two components have relationships as the below diagram.

Page 9: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

399 9 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

G2G SCM Web Services Component Installation This step will install the Go2Group g2g-ws.war war file.

To install the component installation, double click the G2GSCMWS_windows_2_0.exe install shield file to launch the installation shield. The installation wizard appears. Click the Next button to continue the installation.

Review the Go2Group End User License Agreement. After agreeing to the EULA, select the I Accept the Agreement option and click the Next button.

Page 10: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3910 10 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Click the Next button to continue. The installer will tell you before install this component please make sure you had installed a Tomcat or JBoss server in your Subversion server. If not, please install Tomcat/JBoss on your Subversion server.

[NOTE] The Tomcat/JBoss server MUST be started by a Subversion administrator account.

The installation location of the Go2Group war files will vary depending upon if you are using JBoss or Tomcat.

• For the G2G ClearCase Component being installed into Tomcat, you should install the war files here: %apache-tomcat-install-root%\webapps

For the G2G Subversion Component to be installed into JBoss, you should install the war files here: %JBoss-install-root%\server\default\deploy

Page 11: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3911 11 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Click the Next button to select a place to install. If the installation root does not exist, the installer will ask to create it automatically, you will need to say yes.

So you need to choose the installation directory.

Click the Next button to install the war file and continue.

Page 12: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3912 12 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Congratulations, you have completed this step.

After you restart the web container, you can use any browser to make sure the component deployed successfully.

Page 13: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3913 13 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Next, you may need to restart Tomcat or JBoss depending upon which one you deployed to.

You can choose to restart using the screen below, or choose to skip it and restart manually later. Before restarting any server, you will need to check with the server admin first.

Page 14: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3914 14 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

G2G SaT SBM Component Installation During this process, you will need to stop the SBM Server (Serena Common JBoss Service). Please coordinate with the SBM Server Admin.

Locate the installation file G2GSaTSBM_2_0.exe to begin the G2G SBM Component installation. Double click the installation file to launch the installation wizard. The installation wizard appears. Click the Next button to continue the installation.

Before continuing install, please stop your SBM JBoss server first.

Page 15: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3915 15 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

If you stop the Serena JBoss server, please click on the Next.

Review the Go2Group End User License Agreement. After agreeing to the EULA, select the I Accept the Agreement option and click the Next button.

After you agree, you will need to click Next in the Select Components screen below. There is only one component is preselected.

Make sure that the SBM Server (Serena Common JBoss Service) is turned off as mentioned above.

Next, decide which folder will be the installation root for each component.

Page 16: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3916 16 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

For the G2G SBM Component, Go2Group recommends using the default directory as the root installation but it must be set to the location of the Serena installation. For example, C:\Program Files\Serena

If the installation root does not exist, the installer will ask to create it automatically. When prompted, say yes.

Click the Next button to continue.

Again, before continuing to install this component, please ensure the SBM Server (Serena JBoss) service has been stopped (on Windows from the Services screen).

To stop the SBM Server (Serena JBoss Server), click Stop in the window below.

Page 17: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3917 17 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

And the windows will help you to stop the service.

After you stop the Serena Common JBoss Service, go back to the installer.

The installer then copies the Mashup files to the destination directory.

Page 18: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3918 18 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Click the Next button to continue.

The component needs to configure some database data in SBM database, so after the installation, deploy application workflows and configure projects, users have to use the G2GSBMConfig_2_0.exe utility to complete all configurations.

Click the Next button to complete the Mashup portion of the installation.

Page 19: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3919 19 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Click the Finish button to complete the Mashup installation portion of the installation. However, you are not finished yet!

Now that the SBM Server (Serena Common JBoss Server) has stopped, and the deployment is completed, you need to restart the SBM Server (Serena Common JBoss Server), see screen below.

Page 20: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3920 20 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

[Note] Before the Mashup will work, you have two more steps to do. You need to embed G2G component in workflow and configure G2G workflow. See the next two sections below.

Page 21: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3921 21 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Section 4 – Embed G2G Component in workflow

This section is to introduce the G2G orchestration flows, workflow designers have to use the Serena Mashup Composer to import the SaTChangeHistoryWorkflow into your own application workflows. The G2G orchestration mashup file will be installed in C:\Program Files\Go2Group Mashups folder.

We provide one orchestration flows to get change history records from the Subversion server and store data into the SBM database.

You may need to refer to Serena’s Mashup Documentation if you need help with workflows. Here is a generic workflow setup that will work for you. We recommend that you have the SBM Admin perform the following steps.

The SaTChangeHistoryWorkflow orchestration flow is provided to let users get change history records from Subversion server and store into SBM database within a Mashup application flow. Users can use the Business Mashup Composer to merge our orchestration flow with their application flow. A sample application flow containing the orchestration flow is also provided. The Go2Group Mashup is in the “IDT SaT.zip” file.

This orchestration flow contains two web services nodes.

• The first web service is to get change history records from the Subversion server based on issue id that users submitted.

• If there is a return value, then we invoke the second web service to store change history

records into the SBM database.

Page 22: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3922 22 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Let us look into each web service’s data mapping:

In the getChangeHistory web service data mapping, in the below picture, fields have value are required fields. And their mapping fields to the event also as the below picture.

Field Value Note

scmInfo/ lastScanDate This last time scan Subversion repository.

scmInfo/ licenseKey The Go2Group SVN License Key.

scmInfo/ password This is a password for the Subversion login account.

scmInfo/ pathOrUrl This is a workspace absolute path which mounts the repository.

scmInfo/ productName SVM This is a constant value

scmInfo/ scmName SVN This is a constant value.

scmInfo/ submitDate This field is the submit date for the issue

scmInfo/ username This is a login account to access the Subversion repository.

issueId Which issue users want to check change history.

Page 23: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3923 23 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

In the storeChangeHistory web service data mapping, in the below picture, fields have value are required fields. And their mapping fields to the event also as the below picture.

Field Value Note

scmName CC This is a constant value

ttInfo / account The SBM account that can use the Application Engine Web Services.

ttInfo / endpoint The SBM Application Engine Web Services Endpoint (aewebservices70).

ttInfo / issueId The issue id that users want to check.

ttInfo / password The SBM account’s password that can use the Application Engine Web Services.

ttInfo / tableId The table id that the project belong to.

changeHistory Change history records from the getChangeHistory Web Services.

Page 24: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3924 24 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Section 5 - G2G Workflow Configuration

This sample Mashup shows users how the Subversion add-on for Serena Orchestration which can be used to get change history records from the Subversion server and store into the SBM database.

Again, we recommend that you read Serena’s documentation and have a Serena Admin perform these steps for you.

Add Two Target Servers to environment In Serena Business Mashup Manager, users need to add two target servers in their environment before deploying the sample application in the SBM server. One server is for the System Event Manager, and the other server is for the BPEL Server.

Click Environments and then Default Environment.

Page 25: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3925 25 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Create Target Servers.

Create one BPEL Server and one System Event Manager Server. Use View Examples to help choose right URL for different type. Leave Authentication option for “none”. For example:

BPEL: http://sbmserver:8085/jbpm-bpel/services/DeployService

System Event Manager: http://sbmserver:8085/eventmanager/services/ALFAdmin

Page 26: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3926 26 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Add Endpoints to Environment In the Serena Mashup Manager, users need to add five endpoints in their environment prior to deploying the sample application. The three endpoints are:

• ALFEventManager endpoint is for the ALF event manager web services.

Example: http://sbmserver:8085/eventmanager/services/ALFEventManager

• SaTChangeHistoryWorkflow endpoint is for the Subversion change history access web services.

Example: http://sbmserver:8085/G2GSaTOrchestration-SaTChangeHistoryWorkflow /satchangehistoryworkflowservlet

• SCMServices endpoint is for the Go2Group Subversion Component on Tomcat or JBoss.

Example: http://ccserver:8080/g2g-ws/services/SCMServices

After we configured target servers and endpoints, we can deploy our own applications into the SBM server now.

[Note] We also have to load the mashup zip file that generated from Section 4, and then deploy the mashup. Please reference to Chapter 5 in the “Serena Mashup Manager Guide”.

Page 27: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3927 27 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Add Values for the SVNConfig Auxiliary table After users deploy the sample flow or users’ application flow to an SBM server and use the Mashup Administrator to add projects to use the flow, about how to add projects by using the Mashup Administrator, please reference to the Mashup Administrator Guide.

And then users need to use the Serena Business Mashup Web Interface to add configurations.

Users login into the web interface, and then they click on their applications, our example application is SaT IDT.

Then click on the “Search” function and click on the “Manage Data” item to open the management page.

Choose the “SVNConfig”, click on the “Lookup” button, and then click on the “Create New SVNConfig” link to open a new page.

Page 28: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3928 28 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

The SVNConfig configuration contains six required fields:.

• SCMName: a constant value “SVN”.

• Workspace: an absolute path that contains Subversion repository data.

• SBMAccount: the SBM account that can access the SBM Application Engine Web Services.

• SBMPassword: the SBM account’s password.

• G2GProdcut: a constant value “SVM”.

• G2GLicense: a license key value for the SVM product.

• SVNUser: account to access Subversion repository.

• SVNPwd: password for the SVNUser.

After completing this configuration, users can start to use the sample flow.

Page 29: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3929 29 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Configure SBM Database After the above steps, the last and important step is to use the G2GSBMConfig_0_3.exe utility to configure data into the SBM database. This utility will be installed in the C:\Program Files\Go2Group Mashups\utils folder. This utility MUST be running on the SBM server.

In this utility, you have to input all fields to create data into the SBM database.

• SBM JBoss Server Root: This is a absolute path to the Serena JBoss server, the default value is C:\Program Files\Serena\Business Mashups\Common\jboss405\server

• SBM JBoss Server IP: This is the server IP for the Serena JBoss server.

• SBM JBoss Server Port: This is the port number for the Serena JBoss server.

• SBM Web Server IP: This is the server IP for the Serena Application Engine.

• SBM Web Server Port: This is the port number for the Serena Application Engine.

• SBM Administrator Account: The Serena Administrator account.

• SBM Administrator Password: Password for the Serena Administrator account.

Page 30: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3930 30 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

• SBM Project Name: This is the project name which contains the SaTChangeHisotryWorkflow, for example, SaT.

• SBM Integration label: This is a label for the “Integration” tab in the SBM web user interface.

After you running this utility, you can use the SBM web user interface to run the flow.

Page 31: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3931 31 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Use Sample Application The following images depict the typical scenario of creating an issue in Serena Business Mashup, assigning it to a developer, using Subversion to check in code changes, then reviewing the changes within Serena Business Mashup.

Begin by launching Serena Business Mashup and clicking on the IDT SaT Project.

Next, fill in the required fields (those marked in Red), then click the OK button.

Page 32: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3932 32 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

The item is now in the Triage stage.

Copy the Issue ID. Then use any Subversion client to check out files, modify them, and check the files back in. The Comments field must contain the Issue ID. We use the TortoiseSVN as our Subversion client.

Press the OK button to check the file back in.

Page 33: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3933 33 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Once the modified file has been checked back in, return to Serena Business Mashup. Click the Fast Track button. Next, click the Find button to assign the issue to an Engineer. A resulting list of engineers is populated in the Engineer field. Select the proper engineer to assign the issue. Then click the OK button.

Once assigned, the user can then request a review by clicking the Request Peer Review button.

Page 34: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3934 34 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Next, fill all required fields. Then, press the OK button, which will trigger the Go2Group Mashup workflow to query change history logs in Subversion.

Then click on the “Integration” tab. The logs will be displayed for the specific issue.

Page 35: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3935 35 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

If you can not see the change history records in Integrations tab, you can use the “Search by Keyword(s)” function in “Search” tab and the search that issue.

Page 36: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3936 36 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Then click the issue, and you can see the change history records in the Integrations tab.

Page 37: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3937 37 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Section 6 - Go2Group Mashup Tips and Troubleshooting

General Suggestions Go2Group provides technical support for its entire line of products, including Go2Group Mashups. If you run into any issues when installing or configuring the Go2Group Mashups, please contact us.

Updates and Upgrades Go2Group provides regular updates to Go2Group Mashups. These updates include performance enhancements and minor bug fixes.

Go2Group provides regular upgrades to Go2Group Mashups. These upgrades include new features, performance enhancements, and bug fixes.

To review previous, current, and upcoming updates and upgrades, please visit the Go2Group support site at:

www.Go2Group.com/support

A customer login is required to access the support site above. Please contact Go2Group for your login credentials.

Page 38: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3938 38 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Section 7 – Go2Group Mashup Additional Information

The Go2Group Mashup contains a sample application flow. The basic flow is the “SaT IDT”. Go2Group includes an Action in submit transition. The action invokes an orchestration flow which is the G2GSaTOrchestration. In this sample flow, we use an auxiliary table to store workspaces and license key values.

Users can deploy this sample flow to see how the orchestration flow works.

Technical Support Go2Group provides technical support for its entire line of products, including Go2Group Mashups. Go2Group technical support is available by telephone, email, and a Go2Group Mashup specific customer support ticket system:

• By telephone: (877) 442-4669

• By email: [email protected]

• By ticket: www.Go2Group.com/support

A customer login is required to access the support site above. Please contact Go2Group for your login credentials.

Sales Support Go2Group provides sales support for its entire line of products, including Go2Group Mashups. Go2Group sales support is available by telephone, email, and a Go2Group Mashup specific customer support ticket system:

• By telephone: (877) 442-4669

• By email: [email protected]

• By ticket: www.Go2Group.com/support

A customer login is required to access the support site above. Please contact Go2Group for your login credentials.

Page 39: Go2Group Mashup...Go2Group Mashup Subversion Mashup for Serena Business Mashup Solution Installation Guide v2.0 . 392 2 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD

3939 39 Go2Group, Inc. • 138 North Hickory Avenue • Bel Air, MD 21014 • (877) 442-4669

www.Go2Group.com

Your Productivity Force Multiplier

Go2Group

Learn More For more information on Go2Group, its products, and its services, please visit our website at:

www.Go2Group.com

For more information on Serena, please visit the Serena website at:

www.Serena.com

For more information on Subversion, please visit the Subversion website at:

subversion.tigris.org