Friday, September 18, 2015

MongoDB

MongoDB is a NoSQL document-oriented database which stores data as BSON (Binary Script Object Notation) documents.

Salient features of MongoDB are:
  1. Document Oriented - aggregates the data in minimal number of documents.
  2. Ad hoc queries - like regular expression search, by ranges or field is supported.
  3. Indexing - any field in the document can be indexed.
  4. Replication - high availability is supported by maintaining replicas of data in more than one replica set member. The data is eventually consistent between the replica members.
  5. Load Balancing - uses sharding (a shard is a master with one or more slaves) to distribute the data split into ranges (based on shard key) between multiple shards.
  6. File storage - supports storing a file not as a single document but split across multiple shards - GridFS feature of MongoDB comes built in and is used by NGNIX and lighthttpd.
  7. Aggregation - is similar to SQL GROUP BY clause.
  8. Capped collections - can be used to store data in insertion order and once specified size is reached, behaves like a circular queue. Similar to RRD.
  9. Server side Javascript execution - is supported.


MongoDB is one of the top performing NoSQL database. Benchmarks have reported MongoDB performance to be better than some other NoSQL DBs by as much as 25x.
Eventual Consistency - eventually all nodes in the cluster of NoSQL DB will have the same data as data may not be propagated if the network breaks down or the node goes down but eventually when node is up and the network is working then data will be consistent across all shards.
Concepts:
1. Collections - set of documents
2. Document - BSON document with dynamic schema - means that documents in the same collection do not need to have the same set of fields or structure, and common fields in a collection's documents may hold different types of data.
Important mongo shell commands:
use DATABASE_NAME
>show dbs
>show collections
>db.movie.insert({"name":"tutorials point"}) --- will insert a movie document in movie collection.
db.dropDatabase()
>db.createCollection("mycollection")
>db.createCollection("mycol", { capped : true, autoIndexID : true, size : 6142800, max : 10000 } )
>db.COLLECTION_NAME.drop()
>db.COLLECTION_NAME.insert(document)
Query:
>db.COLLECTION_NAME.find()
RDBMS Where Clause Equivalents in MongoDB
To query the document on the basis of some condition, you can use following operations
OperationSyntaxExampleRDBMS Equivalent
Equality{:}db.mycol.find({"by":"tutorials point"}).pretty()where by = 'tutorials point'
Less Than{:{$lt:}}db.mycol.find({"likes":{$lt:50}}).pretty()where likes < 50
Less Than Equals{:{$lte:}}db.mycol.find({"likes":{$lte:50}}).pretty()where likes <= 50
Greater Than{:{$gt:}}db.mycol.find({"likes":{$gt:50}}).pretty()where likes > 50
Greater Than Equals{:{$gte:}}db.mycol.find({"likes":{$gte:50}}).pretty()where likes >= 50
Not Equals{:{$ne:}}db.mycol.find({"likes":{$ne:50}}).pretty()where likes != 50
AND condition:
>db.mycol.find({key1:value1, key2:value2}).pretty()
OR condition:
>db.mycol.find(
   {
      $or: [
      {key1: value1}, {key2:value2}
      ]
   }
).pretty()
Example:
'where likes>10 AND (by = 'tutorials point' OR title = 'MongoDB Overview')'
>db.mycol.find("likes": {$gt:10}, $or: [{"by": "tutorials point"}, {"title": "MongoDB Overview"}] }).pretty()
Update:
>db.COLLECTION_NAME.update(SELECTIOIN_CRITERIA, UPDATED_DATA)
>db.mycol.update({'title':'MongoDB Overview'},{$set:{'title':'New MongoDB Tutorial'}})

Replace old document with new data:
>db.COLLECTION_NAME.save({_id:ObjectId(),NEW_DATA})
>db.mycol.save(
   {
      "_id" : ObjectId(5983548781331adf45ec7), "title":"Tutorials Point New Topic", "by":"Tutorials Point"
   }
)
Delete:
>db.COLLECTION_NAME.remove(DELLETION_CRITTERIA)
>db.mycol.remove({'title':'MongoDB Overview'})
>db.COLLECTION_NAME.remove(DELETION_CRITERIA,1) -- removes the first match
>db.mycol.remove() - remove all documents in the collection.

Projection: selectively display fields and not all fields of a document.
>db.COLLECTION_NAME.find({},{KEY:1})
>db.mycol.find({},{"title":1,_id:0}) -- will display title and not _id (which is always displayed otherwise)
Limit:
>db.COLLECTION_NAME.find().limit(NUMBER)
Sort: 1 is used for ascending order while -1 is used for descending order.
>db.COLLECTION_NAME.find().sort({KEY:1})
Index: Here key is the name of filed on which you want to create index and 1 is for ascending order. To create index in descending order you need to use -1.
>db.COLLECTION_NAME.ensureIndex({KEY:1})
Aggregation:
>db.COLLECTION_NAME.aggregate(AGGREGATE_OPERATION)
> db.mycol.aggregate([{$group : {_id : "$by_user", num_tutorial : {$sum : 1}}}])
select by_user, count(*) from mycol group by by_user -- how many tutorials are written by each user (grouped by a user)

There is a list available aggregation expressions.
ExpressionDescriptionExample
$sumSums up the defined value from all documents in the collection.db.mycol.aggregate([{$group : {_id : "$by_user", num_tutorial : {$sum : "$likes"}}}])
$avgCalculates the average of all given values from all documents in the collection.db.mycol.aggregate([{$group : {_id : "$by_user", num_tutorial : {$avg : "$likes"}}}])
$minGets the minimum of the corresponding values from all documents in the collection.db.mycol.aggregate([{$group : {_id : "$by_user", num_tutorial : {$min : "$likes"}}}])
$maxGets the maximum of the corresponding values from all documents in the collection.db.mycol.aggregate([{$group : {_id : "$by_user", num_tutorial : {$max : "$likes"}}}])
$pushInserts the value to an array in the resulting document.db.mycol.aggregate([{$group : {_id : "$by_user", url : {$push: "$url"}}}])
$addToSetInserts the value to an array in the resulting document but does not create duplicates.db.mycol.aggregate([{$group : {_id : "$by_user", url : {$addToSet : "$url"}}}])
$firstGets the first document from the source documents according to the grouping. Typically this makes only sense together with some previously applied “$sort”-stage.db.mycol.aggregate([{$group : {_id : "$by_user", first_url : {$first : "$url"}}}])
$lastGets the last document from the source documents according to the grouping. Typically this makes only sense together with some previously applied “$sort”-stage.db.mycol.aggregate([{$group : {_id : "$by_user", last_url : {$last : "$url"}}}])
Replication: client application always interact with primary node and primary node then replicate the data to the secondary nodes.
  • All write operations goes to primary
  • Reads can happen from any of primary or secondary nodes.
  • Replication - is keeping multiple copies of the same data for HA and failover. One node is primary and others are secondary. Minimum 3 nodes needed to form a replica set.
  • Writes are always written to primary node in a replica set.
  • Within the replica there will be some delay when the writes to the primary node gets replicated to the secondary. In your application you may want to wait for the writes to be replicated. This is controlled by w flag - or write to replica flag. This is set to w:1 by default in drivers.
  • Mongodb keeps the data in memory and flushes it to disk periodically. If application wants to wait for the data to be written to disk then it can set J:1 (where, j is journal written to disk). W:1, J:1  is default for drivers.
  • Another setting is w:majority, which means write should propagate to majority nodes in the replica set. These w and j settings are called write concerns.
  • An application can set its read preference to read from secondary. Secondary's data may be stale so this is not recommended.

  • Following is how mongodb replica set is created:

    mkdir -p /data/rs1 /data/rs2 /data/rs3
    mongod --replSet m101 --logpath "1.log" --dbpath /data/rs1 --port 27017 --smallfiles --oplogSize 64 --fork

    mongod --replSet m101 --logpath "2.log" --dbpath /data/rs2 --port 27018 --smallfiles --oplogSize 64 --fork
    mongod --replSet m101 --logpath "3.log" --dbpath /data/rs3 --port 27019 --smallfiles --oplogSize 64 --fork
    mongo --port 27017
    Now you will create the replica set. Type the following commands into the mongo shell:
    config = { _id: "m101", members:[
              { _id : 0, host : "localhost:27017"},
              { _id : 1, host : "localhost:27018"},
              { _id : 2, host : "localhost:27019"} ]
    };
    rs.initiate(config);

    rs.status()

    Ps -ef | grep mongod -- will show all the replica sets created on the localhost.
Setting up replica set:
mongod --port "PORT" --dbpath "YOUR_DB_DATA_PATH" --replSet "REPLICA_SET_INSTANCE_NAME"
Backup/Restore MongoDB data: 
>mongodump
>mongorestore

Sharding - is a solution for horizontal scaling of mongodb. More shards (which are in turn made up of replica sets) can be added depending on the load on the system. A shard key needs to be an indexed key in the collection and should be present in all documents. The key need not be unique. It is used to identify the right shard to send the data to for persistence. Within the shard, replica sets will create copies of the data on replica set member nodes. So sharding helps in splitting the data based on a shard key in the document. Its like storing data in a hashmap. The better the key selection, the better the data will be divided among the shards.

Sharding is controlled via mongos router. Application connects to the mongos router which will listen to the 27017 port for example, and will know based on the shard key on which shard to insert the data to. For read/find operation mongos will query the primary node (of the replica set) in each shard and collate the result.

Experiences:
Liked:
  1. Easy to setup and develop against in multiple languages, like Java, python etc. Good to build POC applications.
  2. Stable enough.
  3. Querying is very powerful.
  4. Pretty performant in querying and inserts. If the schema has embedded documents mostly then it is worth using it.
  5. JSON structures can model quite complex objects.
  6. Schema-less DB can be useful (at least it appears to be so in theory) as it can reduce the pain in migration, though you still need to write the migration scripts nevertheless but not have to worry about alter-ing the schema (as there is no DDL or schema definition in MongoDB, all schema gets realized at runtime and documents within the same collection can be quite dissimilar).

Disliked:

  1. By design, no referential integrity is supported:
    1. So no cascade deletion - we need to handle it in application.
  2. Very hard to design with only embedded documents in the schema. Most of the time we end up with having documents with References or links which is akin to relations in the RDBMS. This comes at a price that to build a transaction with rollback is too much work in the application. MongoDB only guarantees atomicity within a document's boundary. So when you have too most documents having references instead of embedded documents in them then consider using RDBMS.
  3. Hard to model many-to-many relations.

Thursday, September 17, 2015

Amazon Web Services

AWS main components:
  1. S3 (Simple storage service)
  2. SQS (Simple Queue Service)
  3. EC2 (Elastic Compute Cloud)
  4. Elastic Beanstalk - PaaS
  5. EBS (Elastic Block Store) - block storage
    1. Instance store-based AMIs - are similar to ephemeral boot drive of openstack.
  6. CloudFormation - orchestration tool (like puppet) from Amazon similar to Heat for OpenStack
  7. CloudFront - CDN feature of Amazon Web services cloud
  8. ELB (Elastic Load Balancer)
  9. Amazon DynamoDB - NoSQL DB from Amazon

S3 - containers (called buckets) - object storage
For eg. Netflix uses S3 to store movies which are then streamed to their customers.



Using AWS CLI: - 

Installing on Mac/Linux is pretty easy if you already have pip installed:
$ pip install awscli

To get started and create an ubuntu instance all using the CLI:

  1. Create a key pair to use for accessing the VM
$ aws ec2 create-key-pair --key-name watshkeydev --query 'KeyMaterial' --output text > watshkeydev.pem
$ chmod 400 watshkeydev.pem

  1. Create security group and create a rule in the group to allow your CIDR subnet address or single IP to access the VM. With 0.0.0.0/0 we allow any host to be able to connect which is fine for test setup as we still require the private key to be able to ssh to VM.
$ aws ec2 create-security-group --group-name devenv-sg --description "security group for development environment in EC2"
$ aws ec2 authorize-security-group-ingress --group-name devenv-sg --protocol tcp --port 22 --cidr 0.0.0.0/0

  1. Launch the VM instance
$ aws ec2 run-instances --image-id ami-29ebb519 --count 1 --instance-type t2.micro --key-name devenv-key --security-groups devenv-sg --query 'Instances[0].InstanceId'
"i-b0b0ac89"

The image id is that of Ubuntu 14.04.1 Trusty release.
This step will take some time so wait and in between if you want yoy can poll for the VM status with the following command:

 $ aws ec2 describe-instances --instance-ids i-b0b0ac89 --query 'Reservations[0].Instances[0].State.Name'
"running"

Once it is running proceed to the next step.

  1. Connect to the VM
$ aws ec2 describe-instances --instance-ids i-b0b0ac89 --query 'Reservations[0].Instances[0].PublicIpAddress'
"x.y.z.k"

$ ssh -i watshkeydev.pem ubuntu@x.y.z.k

  1. Start/stop the instance remotely
$ aws ec2 stop-instances --instance-ids i-b0b0ac89

$ aws ec2 start-instances --instance-ids i-b0b0ac89

Saturday, September 12, 2015

Maven in short

1. Dependency management - can download the transitive dependencies (dependencies of a dependency and this can be infinitely transitive)
2. The main phases in maven lifecycle are:
a. Clean - will clean the target directory
b. Compile
c. Test-compile
d. Test
e. Package 
f. Install
g. Deploy
3. A plugin is bound to a lifecycle phase - for example, compiler plugin is bound to compile phase.
4. We can either execute the mvn <phase-name> or mvn <plugin-name>:<goal-name> for example, mvn compile and mvn compiler:compile do the same thing but when we execute mvn compile any other plugin we have bound to compile phase willl be executed too (together with compiler plugin's compile goal).
5. Maven POM is hierarchical - a project's POM is always inheriting from the base maven's super POM (that comes as part of maven). To see this, execute: mvn help:effective-pom and this will show the plugins that are already part of the super POM we are inheriting from.
6. Within the project too, we can build a hierarchy of POM files. We use the <modules> element to define the sub-modules (which have their own POM files) in the parent module/directory.
In parent pom.xml:
<packaging>pom</packaging>
<modules>
<module>server</module> -- this will build server/pom.xml
<module>client</module>
</modules>
7. All plugins are listed at - http://maven.apache.org/plugins/index.html
8. Maven central repo is - http://search.maven.org/
9. Some important plugins:
a. Clean
b. Jar - mvn package (this is phase and jar plugin in bound to package phase) or run explicitly as mvn jar:jar.
i. -Djava.finalName
ii. -Djar.forceCreation=true - jar created every time.
c. Javadoc 
d. Install - packages and puts the archive in local maven repo so other modules/projects can refer to it.
e. Deploy - deploys to remote maven repo (the remote repo configuration is provided in pom.xml in <distributionManagement> element). This repo could be in cloud (running artifactory server for eg.)
f. Surefire - only one goal (test).
g. War - to package web application 
10. Archetype - to create a project based on an archetype (or template for a project). We can create our own complex setup archetype and make it available as a template for new projects in an organization.
a. Mvn archetype:create-from-project - used to create a new archetype based on existing project. All source files which were there in the original project will be present in the new projects created from that archetype.
b. Mvn archetype:generate - to create a new project 
11. Some commands:
a. mvn archetype:generate  (format is <plugin>:<goal>) - used to generate skeleton for new project.
b. mvn idea:idea or eclipse:eclipse -- to generate project in IDE specific way (run it after archetype:generate)
c. Mvn help:describe -Dcmd=compiler:compile -Ddetail - to see what properties are available for compiler plugin (properties like maven.compiler.verbose)
d. Mvn compiler:compile -Dmaven.compiler.verbose=true -- to debug what is going during compilation
e. Mvn -help
f. Mvn -v
g. Mvn <plugin-name>:help (eg. Mvn compiler:help)
h. Mvn -q compile (quite mode - tidys the o/p)
i. Mvn -X -- gives verbose/debug o/p


Thursday, August 27, 2015

Setting up Ubuntu Linux VM in VirtualBox

1. Download and install Oracle VirtualBox for Windows 10 
https://www.virtualbox.org/download/testcase/VirtualBox-5.0.3-102224-Win.exe
Windows 10 is not officially supported so this test build is available of the most recent stable build of Oracle VirtualBox 5.0.2 with some bug fixes for Windows 10.

2. Download and install Oracle VirtualBox Extension pack 
http://download.virtualbox.org/virtualbox/5.0.2/Oracle_VM_VirtualBox_Extension_Pack-5.0.2-102096.vbox-extpack
Extension pack extends the functionality of VirtualBox  base package (like adding support for USB 2.0, 3.0 devices, RDP, webcam passthrough, PXE boot ROOM support etc).

Note: One can verify that extension pack has installed correctly by checking VirtualBox -> Preferences -> Extensions.

3. Create a new VM in VirtualBox with the following specs:
  • OS – Ubuntu Linux x86-64 (Note: For VirtualBox to show 64 bit OS options you need to ensure that “Virtualization Technology VT-x” option in the system BIOS has been enabled. By default it is disabled and in which case VirtualBox will only show 32 bit OS options for a new VM).
  • CPU – 1
  • Memory – 1024 MB (give more if you want to use the VM for development)
  • Network – Bridge Adapter (instead of NAT so it uses the host OS network interface for internet connection)
  • Virtual HDD – 12 GB (Dynamically allocated – slower but won’t occupy the entire 12 GB from the very beginning and will grow as we install the OS and use the VM). If you want better performance then use Fixed allocation which will take sometime to format and setup).
 4. Download Ubuntu Linux 64 bit Desktop iso image from http://www.ubuntu.com/download/desktop 

5. Associate the iso image as a virtual CD ROM drive to the VM and install OS in the VM. 

When it starts up the resolution of the Ubuntu OS will not be good. To fix that, do the following (excerpted from http://askubuntu.com/questions/451805/screen-resolution-problem-with-ubuntu-14-04-and-virtualbox):
  1. Update Virtualbox to the latest version (currently 4.3.24)
  2. In Terminal in the Guest system type:

    sudo apt-get install dkms
    sudo apt-get install build-essential module-assistant
    sudo m-a prepare
If you have no top menu in the Guest system, it's because you're in scale mode which causes it to be hidden. In that case, press Host + C to toggle scale mode (where Host is Right Control by default)
  1. In the Guest system, go to the top menu, and click Devices->Insert Guest Additions CD Image. This should mount the CD image. Install the guest additions and then a restart the VM. Post the restart the resolution should be 1920x1080 (assuming your monitor supports it). Then you can go full screen mode.

Popular micro services patterns

Here are some popular Microservice design patterns that a programmer should know: Service Registry  pattern provides a  central location  fo...