myriad-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From smare...@apache.org
Subject [05/10] incubator-myriad git commit: Updated API doc with new parameters for flexup/down
Date Thu, 15 Oct 2015 21:00:17 GMT
Updated API doc with new parameters for flexup/down


Project: http://git-wip-us.apache.org/repos/asf/incubator-myriad/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-myriad/commit/14cddf05
Tree: http://git-wip-us.apache.org/repos/asf/incubator-myriad/tree/14cddf05
Diff: http://git-wip-us.apache.org/repos/asf/incubator-myriad/diff/14cddf05

Branch: refs/heads/master
Commit: 14cddf0581f22a4addc001a1d6e15e0be387fd24
Parents: b3d9f0c
Author: Santosh Marella <smarella@maprtech.com>
Authored: Fri Sep 18 12:38:30 2015 -0700
Committer: Santosh Marella <marella@gmail.com>
Committed: Thu Oct 15 12:56:45 2015 -0700

----------------------------------------------------------------------
 docs/API.md | 90 ++++++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 65 insertions(+), 25 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-myriad/blob/14cddf05/docs/API.md
----------------------------------------------------------------------
diff --git a/docs/API.md b/docs/API.md
index c8478d4..be4c3e8 100644
--- a/docs/API.md
+++ b/docs/API.md
@@ -10,33 +10,59 @@
 ## Cluster API
 
 ### PUT /api/cluster/flexup
-Expands the size of the cluster
+Expands the size of the YARN cluster
 
-Request:
+Launch a Node Manager with ```small``` profile on **ANY HOST** in the Mesos cluster:
 ```json
 {
   "instances":1, "profile": "small"
 }
 ```
+Launch 4 Node Managers with ```large``` profile **ONLY on hosts ```host-120 through host-129```**:
+```json
+{
+  "instances":4, "profile": "large", "constraints": ["hostname LIKE host-12[0-9].example.com"]
+}
+```
+
+Launch 2 Node Managers with ```zero``` profile **ONLY on hosts sharing a common Mesos [slave
attribute](http://mesos.apache.org/documentation/attributes-resources)**
+```json
+{
+  "instances":2, "profile": "zero", "constraints": ["hdfs LIKE true"]
+}
+```
 
 Response:
 ```
-200 OK
+202 ACCEPTED
 ```
 
 ### PUT /api/cluster/flexdown
-Shrinks the size of cluster
+Shrinks the size of the YARN cluster
 
-Request:
+Shutdown a Node Manager with ```small``` profile running on **ANY HOST** in the Mesos cluster:
+```json
+{
+  "instances":1, "profile": "small"
+}
+```
+Shutdown 4 Node Managers with ```large``` profile running **ONLY on hosts ```host-120 through
host-129```**:
 ```json
 {
-  "instances":1
+  "instances":4, "profile": "large", "constraints": ["hostname LIKE host-12[0-9].example.com"]
+}
+```
+
+Shutdown 2 Node Managers with ```zero``` profile running **ONLY on hosts sharing a common
Mesos [slave attribute](http://mesos.apache.org/documentation/attributes-resources)**
+```json
+{
+  "instances":2, "profile": "zero", "constraints": ["hdfs LIKE true"]
 }
 ```
 
 Response:
 ```
-200 OK
+202 ACCEPTED
 ```
 
 ## State API
@@ -46,18 +72,18 @@ Response:
 Response:
 ```json
 {
-  "pendingTasks":[
-
-  ],
-  "stagingTasks":[
-
-  ],
-  "activeTasks":[
-
-  ],
-  "killableTasks":[
-
-  ]
+    "pendingTasks": [
+        "nm.zero.e9c65a2a-5b05-4459-ab0d-e9bb12c529d4",
+        "nm.zero.394fe61c-4b42-40d2-8e87-bf199e644d40",
+        "nm.zero.1354e9cc-356a-4dd9-ae1d-d28ee930266c"
+    ],
+    "stagingTasks": [],
+    "activeTasks": [
+        "nm.zero.324592be-b5c5-4a6f-b3de-29602d8d30e8",
+        "nm.zero.849335b7-630d-4652-bf49-f8a3e25f72e0",
+        "nm.medium.f6938f3b-c4e5-476a-b9a8-ce8995d2ef6c"
+    ],
+    "killableTasks": []
 }
 ```
 ## Configuration API
@@ -72,7 +98,17 @@ Sample Response:
     "frameworkFailoverTimeout": 43200000,
     "frameworkName": "MyriadAlpha",
     "frameworkRole": "",
+    "frameworkUser": {
+        "present": true
+    },
+    "frameworkSuperUser": {
+        "present": true
+    },
     "profiles": {
+        "zero": {
+            "cpu": "0",
+            "mem": "0"
+        },
         "small": {
             "cpu": "1",
             "mem": "1100"
@@ -86,24 +122,25 @@ Sample Response:
             "mem": "4096"
         }
     },
+    "nmInstances": {
+        "medium": 1
+    },
     "rebalancer": false,
     "nativeLibrary": "/usr/local/lib/libmesos.so",
     "zkServers": "10.10.30.131:5181",
     "zkTimeout": 20000,
     "restApiPort": 8192,
     "yarnEnvironment": {
-        "YARN_HOME": "/opt/mapr/hadoop/hadoop-2.5.1/",
-        "YARN_NODEMANAGER_OPTS": "-Dyarn.nodemanager.resources.io-spindles=4.0 -Dyarn.resourcemanager.hostname=10.10.30.132"
+        "YARN_HOME": "/opt/mapr/hadoop/hadoop-2.7.0/",
+        "YARN_NODEMANAGER_OPTS": "-Dnodemanager.resource.io-spindles=4.0"
     },
     "mesosAuthenticationPrincipal": "",
     "mesosAuthenticationSecretFilename": "",
+    "haenabled": true,
     "nodeManagerConfiguration": {
         "jvmMaxMemoryMB": {
             "present": true
         },
-        "user": {
-            "present": true
-        },
         "cpus": {
             "present": true
         },
@@ -118,7 +155,10 @@ Sample Response:
         "jvmMaxMemoryMB": {
             "present": true
         },
-        "path": "file:///root/myriad-executor-runnable-0.0.1.jar"
+        "path": "file:///root/myriad-executor-runnable-0.0.1.jar",
+        "nodeManagerUri": {
+            "present": false
+        }
     }
 }
 ```
\ No newline at end of file


Mime
View raw message