System Developer Startup

TOOLS.md

Java/JDK

• Download JDK 1.7 (JDK!!!)
• Install to C:\opt\java\jdk1.7.xx install your JRE to C:\opt\java\jre1.7.xx
• Update your environment to have JAVA_HOME = C:\opt\java\jdk1.7.xx and update your root to have PATH = ...;%JAVA_HOME%\bin
• Validate you did it right by going to your shell and typing "java -version" You should get java version info.

Maven

• Download and install the latest maven to C:\opt\maven
• Add "MAVEN_HOME" to your path and point it to C:\opt\maven\maven-xxx
• Update your PATH to have ...;%MAVEN_HOME%\bin
• Validate you did it right by going to your shell and typing "mvn -version" you should get maven version info

PATHS AT THE END OF THE DAY

PATH="%JAVA_HOME%\bin;%MAVEN_HOME%\bin;...."

For windows make sure you put these infront of your path not at the end.

Eclipse

• Download latest eclipse into C:\opt\eclipse
• Launch eclipse and select your workspace to be whereever you want
• Update your eclipse MAVEN to point to your local installation by going to windows>preferences>maven and add your installation at C:\opt\maven

Eclipse Packages

• Go to eclipse marketplace and install emma for code coverage
• Go to eclipse marketplace and install runjettyrun for the ability to run a web container within eclipse
• Go to eclipse marketplace and install eclipse color theme if you want to get a better IDE with a dark background to save your eyes

Sublime

Packages

Pretty standard packages for your development pleasure, syntax highlighting, color themes, etc.

• https://packagecontrol.io/installation#st2
• https://packagecontrol.io/packages/Puppet
• https://packagecontrol.io/packages/LESS

Misc

Tools I find useful and why

• http://lockhunter.com/ - Useful for finding what is locking a folder/file in windows and killing it - avoids the whole "some process is using this file" and you cant figure out what it is.

Building

Dependency

We do not have artifactory so there is a single external project we rely on. View this projects readme to understand it, but in short we run and want to migrate to Kafka 0.8. We run 0.7. To allow smooth transition we have a kafka driver which wraps both.

• Download from git kafka-client
• Run mvn clean install under $kafka-client\modules

Build DMP, Ad Server, Proxy, Streaming

• Download from git catalyst-dmp
• Run mvn clean install -DskipTests under $catalyst-dmp\modules
• If that completes, run mvn clean test and verify all tests pass - this will take quite some time considering the number of tests
• Import into eclipse at the $catalyst-dmp\modules directory

Build server

• Build server is located at http://builds.personalization.catalinamarketing.com/jenkins/ youll find a tab called 'builds'.

Puppet

All configuration is managed through puppet which is under source control, you can find it under git.

• Puppet is under git as project catalyst-puppet
• Project uses hiera and vagrant as well as vagrant plugins like vagrant --provider=aws
• See the readme in that project for more information

How to do a deployment

• When you check code in, and it passes unit tests, it will automatically be deployed to SQA. You will recieve an email from the build server upon failed builds, deployments, which includes release notes.

How to promote

• Jenkins will create a build tag for every successful build
• Find the build tag in jenkins by going to the BUILD_API and the console output
• Scroll to the end of console output and you will find S3://....../{BUILD_ID}/*.war
• Copy and paste that BUILD_ID that you want to promote to a UAT environment to puppet under catalina.yaml
• Checkin the puppet with the updated build ID
• Run the deployment UAT_PUPPET_DEPLOY and select HBASE, API, and STREAMING to deploy.