how_to development environment settings ver1.2

37
How To Install Configure Development Environment Step-by-step Instructions To configure Local Development Environment And Database 1

Upload: abyssman-man

Post on 29-Jan-2016

16 views

Category:

Documents


0 download

DESCRIPTION

Environment set up for development

TRANSCRIPT

Page 1: HOW_TO Development Environment Settings Ver1.2

How ToInstall Configure Development Environment

Step-by-step Instructions

To configure

Local Development Environment

And Database

1

Page 2: HOW_TO Development Environment Settings Ver1.2

ContentsCONFIGURATION......................................................................................................................................................3

ESB........................................................................................................................................................................3

Setting the Dev Local Environment..........................................................................................................................3

1. Installation process...........................................................................................................................................3

Java 1.6.0.16.....................................................................................................................................................4

Apache Ant 1.7.1..............................................................................................................................................4

Apache Tomcat 6.0.18......................................................................................................................................4

Eclipse Galileo SDK 3.5.1...................................................................................................................................4

Tomcat plug in for Eclipse – tomcatPluginV321...............................................................................................5

Subversion plug in for Eclipse - site-1.0.6.........................................................................................................6

2. Environment.....................................................................................................................................................6

Environment Variables.....................................................................................................................................6

Setting up Eclipse Environment........................................................................................................................8

3. Generate.........................................................................................................................................................19

Generate Dictionary and Toolkit.....................................................................................................................19

4. Guidewire Studio............................................................................................................................................20

Setting up Guidewire Studio...........................................................................................................................20

5. Build the good ol’ fashion way........................................................................................................................22

6. Build using MasterBuild (or building the fast way).........................................................................................27

7. Database.........................................................................................................................................................30

Database Restore...........................................................................................................................................31

8. Deploy............................................................................................................................................................34

9. What does Bamboo do?.................................................................................................................................34

10. Automate......................................................................................................................................................34

11. Update your local development environment..............................................................................................35

2

Page 3: HOW_TO Development Environment Settings Ver1.2

Setting the Dev Local Environment

1. Installation process

The necessary tools and applications required to complete this process reside in the Group Share under ClaimCenter6/Installers.

Java 1.6.0.16Copy the executable to your local desktop and run it. Change the default installation destination to root:\jdk1.6.0.16

Apache Ant 1.7.1Copy the zipped file to your local desktop and extract it to root:\apache-ant-1.7.1

Apache Tomcat 6.0.18Copy the zipped file to your local desktop and extract it to root:\apache-tomcat-6

Eclipse Galileo SDK 3.5.1- Copy the zipped file to your local desktop and extract it to root:\eclipse- Launch Eclipse

3

Page 4: HOW_TO Development Environment Settings Ver1.2

- Set the workspace to root:\ClaimCenter6 and set it as the default

-

Tomcat plug in for Eclipse – tomcatPluginV321- Copy the zipped file to your local desktop and extract it to root:\eclipse\plugins- Restart eclipse- You should see the below icons on the toolbar

- Click on the Window menu and then click on Preferences

4

Page 5: HOW_TO Development Environment Settings Ver1.2

- Click on Tomcat and configure as below

- Click OK and then click on the Tomcat icon on the toolbar to start server

Subversion plug in for Eclipse - site-1.0.6- Copy the zipped file to your local desktop and extract it to a temporary location- Copy the contents of the subversion\plugins folder to your eclipse\plugins folder-

2. Environment

Environment Variables- Set your desktop environment variables as follow

5

Page 6: HOW_TO Development Environment Settings Ver1.2

JAVA_HOME C:\jdk1.6.0_16

ANT_HOME C:\apache-ant-1.7.1

JAVA_OPTS -Xms512M -Xmx512M -XX:PermSize=128m -XX:MaxPermSize=128m

ANT_OPTS -Xmx512M

CATALINA_HOME C:\apache-tomcat-6

CATALINA_OPTS -Xms1024M -Xmx1024M -XX:PermSize=128m -XX:MaxPermSize=128m

Note to QA: verify that there are no other system variables and/or user variables conflicting. QuickTestPro _JAVA_OPTIONS conflict with these settings.

_JAVA_OPTIONS

-Xrunjvmhook -Xbootclasspath/a:C:\PROGRA~1\HP\QUICKT~1\bin\JAVA_S~1\classes;C:\PROGRA~1\HP\QUICKT~1\bin\JAVA_S~1\classes\jasmine.jar

JAVA_TOOL_OPTIONS

-agentlib:jvmhook

- Verify environment settings:- From command, run java –version and ant –version commands.

Setting up Eclipse Environment- Launch Eclipse

6

Page 7: HOW_TO Development Environment Settings Ver1.2

- Select Window > Show View > Other…- Select SVN Repository

- Right click the lower pan and select New > Repository Location…- Point to https://employersdirect.jira/svn/CCSIX and select Finish

7

Page 8: HOW_TO Development Environment Settings Ver1.2

- Navigate to DEV > Integration

8

Page 9: HOW_TO Development Environment Settings Ver1.2

- Checkout Integration Toolkit to your local environment (ClaimCenter6)- Checkout Integration Utility to your local environment (ClaimCenter6)

- From explorer, access ClaimCenter6- Create two folders: ClaimCenter & ContactCenter- Navigate to \\GroupShare\ClaimCenter6\OOTBDownload- Extract ClaimCenter(xx).zip to C:\ClaimCenter6\ClaimCenter

9

Page 10: HOW_TO Development Environment Settings Ver1.2

- Extract ContactCenter(xx).zip to C:\ClaimCenter6\ContactCenter- Copy C:\ClaimCenter6\ClaimCenter\java-api\lib\*.* to C:\ClaimCenter6\IntegrationToolkit- Copy C:\ClaimCenter6\ClaimCenter\soap-api\lib\*.* to C:\ClaimCenter6\IntegrationToolkit

- While on Eclipse, select IntegrationToolkit Folder

- Select Project > Properties- Verify that there are no libraries in the Libraries view

- Select Add Library…- Select User Library and Next >

10

Page 11: HOW_TO Development Environment Settings Ver1.2

- Select User Libraries… button

11

Page 12: HOW_TO Development Environment Settings Ver1.2

- Select New… button

12

Page 13: HOW_TO Development Environment Settings Ver1.2

- Type ToolKitLib in the User library name: field

- Select Add Jars… button

13

Page 14: HOW_TO Development Environment Settings Ver1.2

- Navigate to C:\ClaimCenter6\IntegrationToolkit- Select all .jar files- Select Open button- All User Libraries are added to the Java Build Path

14

Page 15: HOW_TO Development Environment Settings Ver1.2

- Repeat the steps you created the ToolKitLib and create ReferenceLib- You should have two libraries available

15

Page 16: HOW_TO Development Environment Settings Ver1.2

- Select checkbox to add both libraries to classpath

16

Page 17: HOW_TO Development Environment Settings Ver1.2

- You should have similar view

17

Page 18: HOW_TO Development Environment Settings Ver1.2

- Refresh Eclipse View

-

3. Generate

Generate Dictionary and Toolkit- From command, navigate to C:\ClaimCenter6\ClaimCenter\bin- From command, run qwcc regen-dictionary command (~10 minutes)- From command, run qwcc regen-toolkit command (~10 minutes)

18

Page 19: HOW_TO Development Environment Settings Ver1.2

4. Guidewire Studio

Setting up Guidewire Studio- To launch Studio, point to C:\ClaimCenter6\ClaimCenter\ and execute studio.bat

19

Page 20: HOW_TO Development Environment Settings Ver1.2

- Create a folder called edic under Classes

20

Page 21: HOW_TO Development Environment Settings Ver1.2

- Create a folder called edic under Tests

5. Build the good ol’ fashion wayFollow the steps below to create and run a local build.

- Run Eclipse- Checkout configuration folder- Upon completion, navigate to: C:\ClaimCenter6\ClaimCenter\modules\configuration\config

21

Page 22: HOW_TO Development Environment Settings Ver1.2

- Edit the config.xml in the following places:- In the Database Configuration section, comment the <database> portion for demo purposes

22

Page 23: HOW_TO Development Environment Settings Ver1.2

- In the MS SQL Server section, update the sqlserver value to point to your database instance.o HOSTNAMEo PORTo USERo PASSWORD

23

Page 24: HOW_TO Development Environment Settings Ver1.2

- Verify environment settings:- From command, run java –version and ant –version commands.

- From command, navigate to C:\ClaimCenter6\ClaimCenter\bin- From command, run qwcc regen-dictionary command (~10 minutes)

24

Page 25: HOW_TO Development Environment Settings Ver1.2

- From command, run qwcc regen-toolkit command (~10 minutes)

- From command, navigate to C:\ClaimCenter6\ClaimCenter\bin- From command, run qwcc build-war command (~2 minutes). Upon successful, it will create a dist

folder in C:\ClaimCenter6\ClaimCenter

25

Page 26: HOW_TO Development Environment Settings Ver1.2

- Navigate to C:\ClaimCenter6\ClaimCenter\dist\war- Copy the cc.war file to tomcat webapps folder C:\apache-tomcat-6\webapps- From command, navigate to C:\apache-tomcat-6\bin- From command, run startup.bat command (~20 minutes on the first time you run).- Wait for prompt ClaimCenter Ready- Launch server http://localhost:8080/cc

CC is up and running on your local environment!

6. Build using MasterBuild (or building the fast way)The MasterBuild was created to include all manual build tasks into a one error-prone free automated task.

The following example uses TurtoiseSVN application as the client to Subversion

- Intsall TurtoiseSVN (found on the group share\installs- Extract the folder svnant-1.3.0 (found on the group share\installs) to your root (C:\ svnant-1.3.0)- Create the folder ClaimCenter6 on the root of your local machine.- Acces the folder and right click to launch the pop-up-menu and select SVN Checkout…

26

Page 27: HOW_TO Development Environment Settings Ver1.2

- Navigate to theMasterBuild on SVN

- Once successfully checked out, modify \MasterBuild\build.properties “svn.lib=C:/Software/svnant/svnant-1.3.0/lib” to point to your local.

- Point to C:\ClaimCenter6\MasterBuild via command prompt- Type ant to start the build. The MasterBuild takes care of the following steps

o Backup current CC, AB and Integration codeo Delete current CC, AB and Integration codeo Checkout OOTB CC & AB zip and expand themo Checkout CC & AB configurations into their modules\configurationo Rebuild toolkit & dictionary for CC & ABo Checkout "Integration"o Invoke every integration points ant buildo Build Tomcat war files for CC & ABo Clean Tomcat old deploymento Copy war files to Tomcat

- This can also be used to do less:o ant rebuild-cc will “build-integrations”, “build-cc-war”, “clean-cc-tomcat” , “deploy-cc-war”o ant rebuild-ab will “build-ab-war”, “clean-ab-tomcat” , “deploy-ab-war”

27

Page 28: HOW_TO Development Environment Settings Ver1.2

Each application equipped with a config.xml (ClaimCenter & ContactCenter).

Each developer has an instance assinged to him/her.

The config.xml file points to the Development Database instance by default.

You must follow one of the following solutions to prevent from jeopardizing the Development database:

1. Modify Machine Environment Variablesa. Access your computer Environment Varialblesb. Locate the Variable CATALINA_OPTS, and select to Edit itc. Append the following to the end of the variable value field.

2. Modify config file for ab and cca. Run tomcat server to extract the ab and cc wars

28

Page 29: HOW_TO Development Environment Settings Ver1.2

<root>:\apache-tomcat-6.0.18\bin\startup.bat

b. Point to your local Tomcat folder:<root>:\apache-tomcat-6.0.18\webapps\ab\modules\configuration\configAND<root>:\apache-tomcat-6.0.18\webapps\cc\modules\configuration\config

Following 2 places require modification on each config file.

7. DatabaseClaimCenter6 requires MS SQL 2008. Make sure you have MS SQL Server Management Studio.

Launch MS SQL Server Management Stdio

Select File > Connect Object Explorer… to establish connection to the database server

Fill out all the information as it displayed

29

Page 30: HOW_TO Development Environment Settings Ver1.2

Best practice at EDIC is to have an instance of the db assigned to each of the developers instead of installing a local db. This way the database is maintained in one location.

Each developer has an instance assinged to him/her.

Each application equipped with a config.xml (ClaimCenter & ContactCenter).

Database RestoreYou may need to restore your db instance at times. Follow these instructions to do so.

1. Login to SQL Server Management Studio Application2. Navigate to the Users folder under Security in ab_prod and cc_prod schemas3. Select and delete the user service-claimcenter

30

Page 31: HOW_TO Development Environment Settings Ver1.2

NOTE: It is a good practice to repeat those steps for cc_prod_integration schema as well.

4. Navigate to Logins folder under your_local_instance/Security schema5. Verify for each schema that the db_owner checkbox is checked

6. Rightclick your_local_instance and select New Query7. Please update the port number (150xx) for your individual instance and execute the query at the

instance level. (not at cc_prod or ab_prod db level)

31

Page 32: HOW_TO Development Environment Settings Ver1.2

SQL Script to restore CC_PROD

EXECUTE master..sqlbackup '-SQL "RESTORE DATABASE [cc_prod] FROM DISK = ''D:\Restores\CC_PROD\CC_PROD_15001.sqb'' WITH RECOVERY, MOVE ''ClaimCenter_Data'' TO ''D:\MSSQL\MSSQL.150xx\MSSQL10.CCDEV150xx\MSSQL\Data\cc_prod.MDF'', MOVE ''ClaimCenter_Log'' TO ''D:\MSSQL\MSSQL.150xx\MSSQL10.CCDEV150xx\MSSQL\Data\cc_prod_log.LDF'', REPLACE, ORPHAN_CHECK"'

SQL Script to restore AB_PROD

EXECUTE master..sqlbackup '-SQL "RESTORE DATABASE [ab_prod] FROM DISK = ''D:\Restores\ab_prod\AB_PROD_15001.sqb'' WITH RECOVERY, MOVE ''ab_prod_Data'' TO ''D:\MSSQL\MSSQL.150xx\MSSQL10.CCDEV150xx\MSSQL\Data\ab_prod_Data.MDF'', MOVE ''ab_prod_Log'' TO ''D:\MSSQL\MSSQL.150xx\MSSQL10.CCDEV150xx\MSSQL\Data\ab_prod_Log.LDF'', REPLACE, ORPHAN_CHECK"'

8. Verify success

8. Deploy

32

Page 33: HOW_TO Development Environment Settings Ver1.2

1. From Command line navigate to C:\apache-tomcat-6.0.18\bin and type startup.bat to start the server.

2.

9. What does Bamboo do? Bamboo application runs scheduled jobs of MasterBuild & Ant. It provides a notification method (email) to notify the build status

10. AutomateClaim Center interacts with various 3rd party and external systems; Anthem (a.k.a wellpoint), ISO, etc.

Claim information arrives daily and is required to be parsed and updated into Claim Center database.

Automate is a scheuling application running on its own server. Its purpose is to schedule and execute scheduled integration jobs between Claim Center and any of the integration points (inbound and outbound calls).

The jobs code is contained in jar files related to the cron job itself. For example; the FNOLClaimImport.jar consists of the code and soapapi to execute the FNOL job.

33

Page 34: HOW_TO Development Environment Settings Ver1.2

11. Update your local development environmentDo the following to Update your local environment and generate the new build locally.

1. Locate the SVN copy on your local box (<root>:\ClaimCenter6\)2. Right click MasterBuild and select SVN Update…

34

Page 35: HOW_TO Development Environment Settings Ver1.2

Confirm the update

3. Start the build: From command, run ant (C:\ClaimCenter6\MasterBuild\ant)

4. Start the web server: From command, run startup (C:\apache-tomcat-6.0.18\bin\startup.bat) 5. Verify that db instance is pointing to your local instance (tail the tomcat log)6. Run the application (http://localhost:8080/cc)7.

35