Open Anthem

Workspace Setup

MODULE 1

SETTING UP DEVLEOPMENT ENVIRONMENT IN MACBOOK

Introduction

This module helps to set up the development environment for NIMBUS framework.

Audience

Programmers who needs to do the initial development enviornment set up to work with NIMBUS framework

Technical Pre-requisites

Good Understanding of Java Programming

Installables

Table 1. Development Softwares
Application Name Version

Java

1.8.0_171

Maven

3.5.3

Lombok

1.18.2

STS

3.9.5 RELEASE

VS Code

1.14.2

Robo 3T

1.2.1

Chrome

Version 63.0.3239.108 (Official Build) (64-bit)

Advanced Rest Client

arc-12.1.4

Note
Above s/w versions are compatible with Nimbus f/w version 1.1.x. The versions are subjected to change.

Installations

Installation of Homebrew

  1. We will install the required softwares using Homebrew

    Note
    Homebrew (defintion from wikipedia): A free and open-source software package management system that simplifies the installation of software on Apple’s macOS operating system
  2. Let us begin with the installation of Homebrew

  3. Go to https://brew.sh/

    HB
  4. Copy the script from the website

    H1
  5. Open Terminal

    • Press command+spacebar to open Spotlight Search.

      T1
    • Type Terminal

      T2
    • Terminal will be opened

      T3
  6. Paste the below script in your terminal and press Enter

     /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" 
  7. Terminal will prompt for your password. Enter the password to begin the installation

    HB
  8. Once installed, let us check the version of Homebrew by running the following brew formula on your terminal

    $ brew --version
    HBO
  9. Homebrew is installed!

Installation of JDK

  1. Run the following brew formula in your terminal in the mentioned order

    $ brew update
    
    H3
    
    $ brew tap caskroom/versions
    
    H4
    $ brew cask install java8
    
  2. If the terminal will prompt for your password, enter the password to begin the installation

    JV
  3. Once installed, let us check the version by running the following brew formula on your terminal

     $ java -version 
    JV
  4. Java 1.8.0.171 is installed!

Installation of Maven

  1. Run the following brew formula on your terminal.

     $ brew install maven 
    M1
  2. Once installed, let us check the version by running the following brew formula on your terminal

     $ mvn -v 
    JV
  3. Apache Maven 3.5.4 is installed!

Installation of git

  1. Run the following brew formula on your terminal.

     $ brew install git 
    JV
  2. Once installed, let us check the installation by running the following brew formula on your terminal

     $ git --version 
    GV
  3. Git 2.14.3 is installed!

Installation of Spring Tool Suite

  1. Go to https://spring.io/tools3/sts/all

  2. Click the appropriate dmg file for mac

    sts
  3. You can see the file inside your "/Downloads" folder

  4. Open the dmg file

  5. Drag and drop STS to your "/Applications" folder

  6. STS is installed in your "/Applications" folder

    GV
  7. To run STS, open the "/Applications" folder and click on the "STS" icon. Click Open in the alert window

    GV
  8. Choose a directory as workspace and Launch STS

    GV
  9. STS will be opened

    GV
  10. STS 3.9.5 is installed!

Installation of Drools Plugin

  1. Open STS from "/Applications"

    GV
  2. Click Help → Install new software

    DR5
  3. Enter Work with as http://download.jboss.org/drools/release/5.5.0.Final/org.drools.updatesite/ and click Add

    DR5
  4. Enter Name as Drools and Location as http://download.jboss.org/drools/release/5.5.0.Final/org.drools.updatesite/

    DR5
  5. Select Drools and JBPM and click Next

    GV
  6. Click Next

    GV
  7. Accept the Terms and Conditions and click Finish

    GV
  8. Click Install anyway in the warning message.

    GV
  9. Restart the STS when prompted

  10. Drools is installed!

Installation of Lombok

  1. Goto https://projectlombok.org/setup/eclipse .Click Download

    LK1
  2. Click Download 1.18.2

    LK1
  3. You will get a warning message on the left bottom corner of the page. Click Keep

    LK1
  4. lombok.jar file will be downloaded in your "/Downloads" folder

    LK1
  5. Right click and open lombok.jar file

    LK1
  6. You will get a warning message. Click Open

    LK1
  7. Once opened, your IDE location will be automatically identified by lombok. Click Install/ Update to begin the installation.

    LK1
  8. lombok will be installed successfully, Click Quit Installer

    LK1
  9. We can check the Lombok installation by clicking Spring Tool Suit→About

    LP
  10. We can view the version of Lombok

    LK1
  11. Lombok 1.18.2 is installed!

Install Activiti plugin

  1. Open STS from "/Applications"

    GV
  2. Click Help → Install new software

    DR5
  3. Click Add

    AC
  4. Enter the Name as Activiti designer and Location as http://activiti.org/designer/update and click Add

    AT2
  5. You may/maynot get an "Unable to read from repository" error. This is due to Anthem’s firewall restrictions. You may require external/hotspot connection for this step

    AT2
    AT2
  6. Click OK . Connect to external / hotspot and do Step d

  7. Select Activiti BPMN Designer and click Next

    AT2
  8. Click Next

    AT2
  9. Agree the Terms and Conditions and Click Finish

    AT2
  10. Click Install anyway in the warning message.

    AT2
  11. Restart STS in the warning message.

    AT2
  12. Activiti Eclipse BPMN 2.0 Designer is installed!

Installation of Visual Studio Code

  1. You may require external/hotspot connection for installation of Visual Studio Code

  2. Go to https://code.visualstudio.com/ . Click Download for Mac

    VS
  3. VSCode-darwin-stable.zip would be downloaded.

    VS
  4. Double click VSCode-darwin-stable.zip

    VS
  5. You can view the Visual Studio Code application inside the "\Downloads" folder

    VS
  6. Double click and open Visual Studio Code . Click Open in the warning message.

    VS
  7. Visual Studio Code will be opened.

    VS
  8. VS Code darwin stable is installed!

Installation of Robo 3T (DB Client)

  1. Go to https://robomongo.org/ and click Download Robo 3T

    R1
  2. Click Download Robo 3T

    R2
  3. Choose the appropriate OS and click on the dmg

    R3
  4. Open the downloaded dmg file . Drag and drop Robo 3T to "\Applications" folder

    R4
  5. Open Robo 3T and accept the user agreement. Click Next

    R5
  6. Click Create

    R6
  7. Create a new Local Connection Local and click Save

    R7
  8. Click Connect to establish connection with DB

    R8
  9. Robo 3T 1.2 is installed!

Installation of Advanced Rest Client

  1. Go to https://install.advancedrestclient.com/#/install

    AR
  2. arc-12.1.4.dmg will be downloaded

    AR
  3. You can view the same inside the "\Downloads" folder

    AR
  4. Drag and drop arc-12.1.4.dmg to "\Applications" folder

    AR
  5. You can view the same inside the "\Applications" folder

    AR
  6. Open AdvancedRestClient from "\Applications" folder

    AR
  7. You can mention the required Method and Request URL

    AR
  8. Advanced Rest Client 12.1.4 is installed!

Certificates Required for Development(For using the framework within Anthem)

  1. Download the mentioned certificates:

  2. These files be saved as follows in your "/Downloads" folder:

    1. RootCA_WellPoint Internal Root CA.crt

    2. MOM9P70123.us.ad.wellpoint.com_WellPoint Internal Issuing CA 2.crt

    3. VA10P70803.us.ad.wellpoint.com_WellPoint Internal Issuing CA 1.crt

  3. Rename the extensions from “.crt” to “.der” and replace the spaces with underscore Example: RootCA_WellPoint Internal Root CA.der should be changed as RootCA_WellPoint_Internal_Root_CA.der

  4. Copy these certificates to "/tmp" folder by running the command cp *.der /tmp in terminal

  5. Run these in your command line to add the certificates to your keychain

    1. sudo keytool -import -alias “RootCA_WellPoint_Internal_Root_CA” -storepass changeit -keystore $JAVA_HOME/jre/lib/security/cacerts -file /tmp/RootCA_WellPoint_Internal_Root_CA.der

    2. sudo keytool -import -alias MOM9P70123.us.ad.wellpoint.com_WellPoint_Internal_Issuing_CA_2 -storepass changeit -keystore $JAVA_HOME/jre/lib/security/cacerts -file /tmp/MOM9P70123.us.ad.wellpoint.com_WellPoint_Internal_Issuing_CA_2.der

    3. sudo keytool -import -alias VA10P70803.us.ad.wellpoint.com_WellPoint_Internal_Issuing_CA_1 -storepass changeit -keystore $JAVA_HOME/jre/lib/security/cacerts -file /tmp/VA10P70803.us.ad.wellpoint.com_WellPoint_Internal_Issuing_CA_1.der

Appendix

Installation of Node.js

  1. Open Terminal

  2. Run the following brew formula on your terminal

     $ brew install node 
  3. Once installed, we can check the installation by running the below formulae on your terminal

     $ node -v
    $ npm -v
    
  4. The terminal shows the following output:

    DV1
  5. Node.js is installed!

How to work with MongoDB through Docker

Installation of Docker
  1. Go to https://docs.docker.com/v17.12/docker-for-mac/install/#download-docker-for-mac

  2. Prefer Stable Docker version over Edge.

  3. Double click Docker.dmg and open the installer

  4. Drag Moby the whale to your "/Applications" folder

    DV1
  5. Go to "/Applications" folder and double-click Docker.app to start Docker

    DV2
  6. The docker app(the whale icon) would be shown in your status bar. You can also access the same from your terminal

    DV3
  7. Click the whale icon to see that it is running

    DV4
  8. Check the version from your terminal

    DV5
Installation of MongoDB
  1. Run the following brew formula in your terminal

    
    $ brew install mongodb 
    JV
  2. Once installed, let us check the version by running the following brew formula on your terminal

     $ mongo -version 
    M
  3. Let us start the mongodb by running the following brew formula

     $ brew services start mongodb 
    M
  4. Let us check if the mongodb is running by running the following brew formula

     $ brew services list 
    M
  5. MongoDB v4.0.2 is installed!

Working with MongoDb through Docker
  1. Go to : https://bitbucket.anthem.com/projects/NIM/repos/nimbus/browse?at=refs%2Fheads%2Fdevelop and click on clone

    MD
  2. Copy the link

    MD
  3. Create a temporary folder on the Desktop named "Temp"

  4. Open terminal, go to the Temp location and paste the following command

    git clone -b develop https://AF12345@bitbucket.anthem.com/scm/nim/nimbus.git
  5. We will get the cloning to ‘nimbus’ message on the terminal. We are doing this activity to get the script file which is required to pull the docker images.

    MD
  6. Once we are done with cloning, let’s check the contents by going to "nimbus" folder and listing the files in it

    LC02WN0NMHTDD:Temp AF12345$ cd nimbus/
    LC02WN0NMHTDD:Temp AF12345$ ls
  7. Let’s pull the docker images using the sh dev command

    sh dev-script-p-dep-all-start.sh
  8. The script will run with successful output on the terminal

    MD
  9. Now we can delete the "Temp" folder. Go to Kitematic in Docker

    MD
  10. Click mongo and click Start

    MD

Conclusion

Your are all set! Have a happy coding !

Deployment Setup

Local

TODO

Monolithic

TODO

Cloud

TODO