diff --git a/.docz/.cache/async-requires.js b/.docz/.cache/async-requires.js index 2857f94..786103c 100644 --- a/.docz/.cache/async-requires.js +++ b/.docz/.cache/async-requires.js @@ -2,11 +2,12 @@ const preferDefault = m => m && m.default || m exports.components = { + "component---cache-dev-404-page-js": () => import("./dev-404-page.js" /* webpackChunkName: "component---cache-dev-404-page-js" */), "component---src-architectures-mdx": () => import("./../../src/architectures.mdx" /* webpackChunkName: "component---src-architectures-mdx" */), "component---src-how-mdx": () => import("./../../src/how.mdx" /* webpackChunkName: "component---src-how-mdx" */), "component---src-index-mdx": () => import("./../../src/index.mdx" /* webpackChunkName: "component---src-index-mdx" */), - "component---src-enterprise-index-mdx": () => import("./../../src/enterprise/index.mdx" /* webpackChunkName: "component---src-enterprise-index-mdx" */), "component---src-enterprise-installation-cloud-mdx": () => import("./../../src/enterprise/installation-cloud.mdx" /* webpackChunkName: "component---src-enterprise-installation-cloud-mdx" */), + "component---src-enterprise-index-mdx": () => import("./../../src/enterprise/index.mdx" /* webpackChunkName: "component---src-enterprise-index-mdx" */), "component---src-enterprise-installation-mdx": () => import("./../../src/enterprise/installation.mdx" /* webpackChunkName: "component---src-enterprise-installation-mdx" */), "component---src-enterprise-releases-mdx": () => import("./../../src/enterprise/releases.mdx" /* webpackChunkName: "component---src-enterprise-releases-mdx" */), "component---src-open-source-get-started-mdx": () => import("./../../src/open-source/get-started.mdx" /* webpackChunkName: "component---src-open-source-get-started-mdx" */), @@ -14,10 +15,10 @@ exports.components = { "component---src-open-source-upgrade-mdx": () => import("./../../src/open-source/upgrade.mdx" /* webpackChunkName: "component---src-open-source-upgrade-mdx" */), "component---src-open-source-web-mdx": () => import("./../../src/open-source/web.mdx" /* webpackChunkName: "component---src-open-source-web-mdx" */), "component---src-storage-get-started-mdx": () => import("./../../src/storage/get-started.mdx" /* webpackChunkName: "component---src-storage-get-started-mdx" */), + "component---src-storage-index-mdx": () => import("./../../src/storage/index.mdx" /* webpackChunkName: "component---src-storage-index-mdx" */), "component---src-storage-installation-cloud-mdx": () => import("./../../src/storage/installation-cloud.mdx" /* webpackChunkName: "component---src-storage-installation-cloud-mdx" */), "component---src-storage-installation-edge-mdx": () => import("./../../src/storage/installation-edge.mdx" /* webpackChunkName: "component---src-storage-installation-edge-mdx" */), "component---src-storage-installation-providers-md": () => import("./../../src/storage/installation-providers.md" /* webpackChunkName: "component---src-storage-installation-providers-md" */), - "component---src-storage-index-mdx": () => import("./../../src/storage/index.mdx" /* webpackChunkName: "component---src-storage-index-mdx" */), "component---src-storage-installation-recycle-md": () => import("./../../src/storage/installation-recycle.md" /* webpackChunkName: "component---src-storage-installation-recycle-md" */), "component---src-storage-installation-mdx": () => import("./../../src/storage/installation.mdx" /* webpackChunkName: "component---src-storage-installation-mdx" */), "component---src-cloud-index-mdx": () => import("./../../src/cloud/index.mdx" /* webpackChunkName: "component---src-cloud-index-mdx" */), diff --git a/.docz/.cache/babelState.json b/.docz/.cache/babelState.json index 4c286d2..c6b7b2b 100644 --- a/.docz/.cache/babelState.json +++ b/.docz/.cache/babelState.json @@ -17,8 +17,8 @@ { "name": "/Users/i353408/Vagrant/www/repos/documentation/node_modules/@emotion/babel-preset-css-prop/dist/babel-preset-css-prop.cjs.js", "options": { - "sourceMap": false, - "autoLabel": false, + "sourceMap": true, + "autoLabel": true, "plugins": [] } } @@ -45,8 +45,8 @@ { "name": "/Users/i353408/Vagrant/www/repos/documentation/node_modules/@emotion/babel-preset-css-prop/dist/babel-preset-css-prop.cjs.js", "options": { - "sourceMap": false, - "autoLabel": false, + "sourceMap": true, + "autoLabel": true, "plugins": [] } } @@ -73,8 +73,8 @@ { "name": "/Users/i353408/Vagrant/www/repos/documentation/node_modules/@emotion/babel-preset-css-prop/dist/babel-preset-css-prop.cjs.js", "options": { - "sourceMap": false, - "autoLabel": false, + "sourceMap": true, + "autoLabel": true, "plugins": [] } } @@ -101,8 +101,8 @@ { "name": "/Users/i353408/Vagrant/www/repos/documentation/node_modules/@emotion/babel-preset-css-prop/dist/babel-preset-css-prop.cjs.js", "options": { - "sourceMap": false, - "autoLabel": false, + "sourceMap": true, + "autoLabel": true, "plugins": [] } } diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0055382652fbcfd9456eb9d65d693ef6.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0055382652fbcfd9456eb9d65d693ef6.json index 934bea9..4823d17 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0055382652fbcfd9456eb9d65d693ef6.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0055382652fbcfd9456eb9d65d693ef6.json @@ -1 +1 @@ -{"expireTime":9007200861747683000,"key":"gatsby-plugin-mdx-entire-payload-075bca8de4f2859b0a642423fa5bedd2-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Welcome to the Kerberos Storage Edge installation. This is the way to go if you want to install Kerberos Storage on your Baremetal infrastructure or inside your Private Cloud.","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":176,"offset":410},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":176,"offset":410},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":14,"column":1,"offset":412},"end":{"line":14,"column":98,"offset":509},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":412},"end":{"line":14,"column":98,"offset":509},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before we can actual start installing the different deployments in our cluster, we need to make sure we have one available.","position":{"start":{"line":16,"column":1,"offset":511},"end":{"line":16,"column":124,"offset":634},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":511},"end":{"line":16,"column":124,"offset":634},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":18,"column":3,"offset":638},"end":{"line":18,"column":16,"offset":651},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":636},"end":{"line":18,"column":16,"offset":651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is the storage component for Kerberos Enterprise. It is used to store your recordings at a central place, in the storage system you prefer. Next to that it can be used for extension and integration capabilities. Learn more about ","position":{"start":{"line":20,"column":1,"offset":653},"end":{"line":20,"column":247,"offset":899},"indent":[]}},{"type":"link","title":null,"url":"/storage","children":[{"type":"text","value":"Kerberos Storage here","position":{"start":{"line":20,"column":248,"offset":900},"end":{"line":20,"column":269,"offset":921},"indent":[]}}],"position":{"start":{"line":20,"column":247,"offset":899},"end":{"line":20,"column":280,"offset":932},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":20,"column":280,"offset":932},"end":{"line":20,"column":281,"offset":933},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":653},"end":{"line":20,"column":281,"offset":933},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To use Kerberos Storage, you will need to have Kerberos Enterprise installed, and deployments running. Independent from that one can also use the Kerberos Storage API ","position":{"start":{"line":22,"column":1,"offset":935},"end":{"line":22,"column":168,"offset":1102},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":22,"column":168,"offset":1102},"end":{"line":22,"column":189,"offset":1123},"indent":[]}},{"type":"text","value":" to send recordings from a custom build VMS.","position":{"start":{"line":22,"column":189,"offset":1123},"end":{"line":22,"column":233,"offset":1167},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":935},"end":{"line":22,"column":233,"offset":1167},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":24,"column":3,"offset":1171},"end":{"line":24,"column":15,"offset":1183},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1169},"end":{"line":24,"column":15,"offset":1183},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to Kerberos Enterprise, Kerberos Storage, requires some initial components to be installed. If you will run Kerberos Storage in the same cluster as where you have Kerberos Enterprise running, there is not much to do.","position":{"start":{"line":26,"column":1,"offset":1185},"end":{"line":26,"column":225,"offset":1409},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1185},"end":{"line":26,"column":225,"offset":1409},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"However if you plan to run Kerberos Storage in a different cluster (which is perfectly possible), you will need to make sure you complete the initial setup of ","position":{"start":{"line":28,"column":1,"offset":1411},"end":{"line":28,"column":160,"offset":1570},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/installation-edge","children":[{"type":"text","value":"Kerberos Enterprise Edge","position":{"start":{"line":28,"column":161,"offset":1571},"end":{"line":28,"column":185,"offset":1595},"indent":[]}}],"position":{"start":{"line":28,"column":160,"offset":1570},"end":{"line":28,"column":217,"offset":1627},"indent":[]}},{"type":"text","value":" installation. To be more specific you will need the following components running:","position":{"start":{"line":28,"column":217,"offset":1627},"end":{"line":28,"column":299,"offset":1709},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1411},"end":{"line":28,"column":299,"offset":1709},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Helm","position":{"start":{"line":30,"column":3,"offset":1713},"end":{"line":30,"column":7,"offset":1717},"indent":[]}}],"position":{"start":{"line":30,"column":3,"offset":1713},"end":{"line":30,"column":7,"offset":1717},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1711},"end":{"line":30,"column":7,"offset":1717},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Calico","position":{"start":{"line":31,"column":3,"offset":1720},"end":{"line":31,"column":9,"offset":1726},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1720},"end":{"line":31,"column":9,"offset":1726},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1718},"end":{"line":31,"column":9,"offset":1726},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MetalLB","position":{"start":{"line":32,"column":3,"offset":1729},"end":{"line":32,"column":10,"offset":1736},"indent":[]}}],"position":{"start":{"line":32,"column":3,"offset":1729},"end":{"line":32,"column":10,"offset":1736},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1727},"end":{"line":32,"column":10,"offset":1736},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":33,"column":3,"offset":1739},"end":{"line":33,"column":10,"offset":1746},"indent":[]}}],"position":{"start":{"line":33,"column":3,"offset":1739},"end":{"line":33,"column":10,"offset":1746},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1737},"end":{"line":33,"column":10,"offset":1746},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":34,"column":3,"offset":1749},"end":{"line":34,"column":10,"offset":1756},"indent":[]}}],"position":{"start":{"line":34,"column":3,"offset":1749},"end":{"line":34,"column":10,"offset":1756},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":1747},"end":{"line":34,"column":10,"offset":1756},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1711},"end":{"line":34,"column":10,"offset":1756},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once this is done start by cloning the configurations from our ","position":{"start":{"line":36,"column":1,"offset":1758},"end":{"line":36,"column":64,"offset":1821},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/storage","children":[{"type":"text","value":"Github repo","position":{"start":{"line":36,"column":65,"offset":1822},"end":{"line":36,"column":76,"offset":1833},"indent":[]}}],"position":{"start":{"line":36,"column":64,"offset":1821},"end":{"line":36,"column":117,"offset":1874},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":36,"column":117,"offset":1874},"end":{"line":36,"column":118,"offset":1875},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":1758},"end":{"line":36,"column":118,"offset":1875},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/storage","position":{"start":{"line":38,"column":1,"offset":1877},"end":{"line":38,"column":53,"offset":1929},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage","position":{"start":{"line":40,"column":4,"offset":1934},"end":{"line":40,"column":11,"offset":1941},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1931},"end":{"line":40,"column":11,"offset":1941},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to Kerberos Enterprise, Kerberos Storage is managed through a web app. It allows you to add storage providers (S3, minio, etc), add queues for messaging, accounts for security and much more. It also comes with API's, which you can use to interact and retrieve information from Kerberos Storage. All is documented in the form of Swagger APIs ","position":{"start":{"line":42,"column":1,"offset":1943},"end":{"line":42,"column":350,"offset":2292},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":42,"column":350,"offset":2292},"end":{"line":42,"column":371,"offset":2313},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":42,"column":371,"offset":2313},"end":{"line":42,"column":372,"offset":2314},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":1943},"end":{"line":42,"column":372,"offset":2314},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing Kerberos Storage, open the ","position":{"start":{"line":44,"column":1,"offset":2316},"end":{"line":44,"column":46,"offset":2361},"indent":[]}},{"type":"inlineCode","value":"./storage/yaml/deployment.yaml","position":{"start":{"line":44,"column":46,"offset":2361},"end":{"line":44,"column":78,"offset":2393},"indent":[]}},{"type":"text","value":" configuration file. At the bottom file you will find two endpoints, similar to the Traefik config file below. Update the domain names to your own domain, and add these to your DNS server or ","position":{"start":{"line":44,"column":78,"offset":2393},"end":{"line":44,"column":269,"offset":2584},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":44,"column":269,"offset":2584},"end":{"line":44,"column":281,"offset":2596},"indent":[]}},{"type":"text","value":" file (and point to the same IP as the Traefik EXTERNAL-IP).","position":{"start":{"line":44,"column":281,"offset":2596},"end":{"line":44,"column":341,"offset":2656},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":2316},"end":{"line":44,"column":341,"offset":2656},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: storage.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: kerberos-storage\n servicePort: 80\n--> - host: api.storage.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: kerberos-storage\n servicePort: 8081","position":{"start":{"line":46,"column":1,"offset":2658},"end":{"line":61,"column":36,"offset":3108},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":63,"column":1,"offset":3110},"end":{"line":63,"column":112,"offset":3221},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3110},"end":{"line":63,"column":112,"offset":3221},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":65,"column":1,"offset":3223},"end":{"line":68,"column":30,"offset":3342},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names and MongoDB credentials, install Kerberos Storage inside your cluster.","position":{"start":{"line":70,"column":1,"offset":3344},"end":{"line":70,"column":109,"offset":3452},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":3344},"end":{"line":70,"column":109,"offset":3452},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./storage/yaml/deployment.yaml","position":{"start":{"line":72,"column":1,"offset":3454},"end":{"line":72,"column":52,"offset":3505},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":74,"column":4,"offset":3510},"end":{"line":74,"column":26,"offset":3532},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":3507},"end":{"line":74,"column":26,"offset":3532},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":76,"column":1,"offset":3534},"end":{"line":76,"column":94,"offset":3627},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":3534},"end":{"line":76,"column":94,"offset":3627},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":78,"column":5,"offset":3633},"end":{"line":78,"column":12,"offset":3640},"indent":[]}}],"position":{"start":{"line":78,"column":5,"offset":3633},"end":{"line":78,"column":12,"offset":3640},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":3629},"end":{"line":78,"column":12,"offset":3640},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":79,"column":5,"offset":3645},"end":{"line":79,"column":12,"offset":3652},"indent":[]}}],"position":{"start":{"line":79,"column":5,"offset":3645},"end":{"line":79,"column":12,"offset":3652},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3641},"end":{"line":79,"column":12,"offset":3652},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Storage","position":{"start":{"line":80,"column":5,"offset":3657},"end":{"line":80,"column":12,"offset":3664},"indent":[]}}],"position":{"start":{"line":80,"column":5,"offset":3657},"end":{"line":80,"column":12,"offset":3664},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":3653},"end":{"line":80,"column":12,"offset":3664},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Enterprise (optional)","position":{"start":{"line":81,"column":5,"offset":3669},"end":{"line":81,"column":26,"offset":3690},"indent":[]}}],"position":{"start":{"line":81,"column":5,"offset":3669},"end":{"line":81,"column":26,"offset":3690},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3665},"end":{"line":81,"column":26,"offset":3690},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":3629},"end":{"line":81,"column":26,"offset":3690},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":83,"column":1,"offset":3692},"end":{"line":83,"column":26,"offset":3717},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":3692},"end":{"line":83,"column":26,"offset":3717},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nkerberos-storage-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-55566dc65c-xgmns 2/2 Running 0 4d13h\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":85,"column":1,"offset":3719},"end":{"line":89,"column":73,"offset":4031},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":91,"column":4,"offset":4036},"end":{"line":91,"column":21,"offset":4053},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4033},"end":{"line":91,"column":21,"offset":4053},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS or ","position":{"start":{"line":93,"column":1,"offset":4055},"end":{"line":93,"column":65,"offset":4119},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":93,"column":65,"offset":4119},"end":{"line":93,"column":77,"offset":4131},"indent":[]}},{"type":"text","value":" file, you should be able to access the Storage application. By navigating to the Storage domain ","position":{"start":{"line":93,"column":77,"offset":4131},"end":{"line":93,"column":174,"offset":4228},"indent":[]}},{"type":"inlineCode","value":"storage.domain.com","position":{"start":{"line":93,"column":174,"offset":4228},"end":{"line":93,"column":194,"offset":4248},"indent":[]}},{"type":"text","value":" in your browser you will see the Storage login page showing up.","position":{"start":{"line":93,"column":194,"offset":4248},"end":{"line":93,"column":258,"offset":4312},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4055},"end":{"line":93,"column":258,"offset":4312},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Storage","position":{"start":{"line":95,"column":1,"offset":4314},"end":{"line":95,"column":71,"offset":4384},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4314},"end":{"line":95,"column":71,"offset":4384},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":98,"column":1,"offset":4387},"end":{"line":98,"column":31,"offset":4417},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":98,"column":31,"offset":4417}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Introduction`}

\n

{`Welcome to the Kerberos Storage Edge installation. This is the way to go if you want to install Kerberos Storage on your Baremetal infrastructure or inside your Private Cloud.`}

\n

\"architecture

\n

{`Before we can actual start installing the different deployments in our cluster, we need to make sure we have one available.`}

\n

{`Prerequisites`}

\n

{`Kerberos Storage is the storage component for Kerberos Enterprise. It is used to store your recordings at a central place, in the storage system you prefer. Next to that it can be used for extension and integration capabilities. Learn more about `}{`Kerberos Storage here`}{`.`}

\n

{`To use Kerberos Storage, you will need to have Kerberos Enterprise installed, and deployments running. Independent from that one can also use the Kerberos Storage API `}{`/swagger/index.html`}{` to send recordings from a custom build VMS.`}

\n

{`Installation`}

\n

{`Similar to Kerberos Enterprise, Kerberos Storage, requires some initial components to be installed. If you will run Kerberos Storage in the same cluster as where you have Kerberos Enterprise running, there is not much to do.`}

\n

{`However if you plan to run Kerberos Storage in a different cluster (which is perfectly possible), you will need to make sure you complete the initial setup of `}{`Kerberos Enterprise Edge`}{` installation. To be more specific you will need the following components running:`}

\n \n

{`Once this is done start by cloning the configurations from our `}{`Github repo`}{`.`}

\n 
{`git clone https://github.com/kerberos-io/storage`}
\n

{`Storage`}

\n

{`Similar to Kerberos Enterprise, Kerberos Storage is managed through a web app. It allows you to add storage providers (S3, minio, etc), add queues for messaging, accounts for security and much more. It also comes with API's, which you can use to interact and retrieve information from Kerberos Storage. All is documented in the form of Swagger APIs `}{`/swagger/index.html`}{`.`}

\n

{`Before installing Kerberos Storage, open the `}{`./storage/yaml/deployment.yaml`}{` configuration file. At the bottom file you will find two endpoints, similar to the Traefik config file below. Update the domain names to your own domain, and add these to your DNS server or `}{`/etc/hosts`}{` file (and point to the same IP as the Traefik EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: storage.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: kerberos-storage`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.storage.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: kerberos-storage`}{`\n`}{`              servicePort: 8081`}
\n

{`Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names and MongoDB credentials, install Kerberos Storage inside your cluster.`}

\n 
{`kubectl apply -f ./storage/yaml/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n \n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`kerberos-storage-6f5c877d7c-hf77p 1/1     Running   0          2d11h`}{`\n`}{`mongodb-55566dc65c-xgmns          2/2     Running   0          4d13h`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS or `}{`/etc/hosts`}{` file, you should be able to access the Storage application. By navigating to the Storage domain `}{`storage.domain.com`}{` in your browser you will see the Storage login page showing up.`}

\n

\"Storage\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750186000,"key":"gatsby-plugin-mdx-entire-payload-075bca8de4f2859b0a642423fa5bedd2-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Welcome to the Kerberos Storage Edge installation. This is the way to go if you want to install Kerberos Storage on your Baremetal infrastructure or inside your Private Cloud.","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":176,"offset":410},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":176,"offset":410},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":14,"column":1,"offset":412},"end":{"line":14,"column":98,"offset":509},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":412},"end":{"line":14,"column":98,"offset":509},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before we can actual start installing the different deployments in our cluster, we need to make sure we have one available.","position":{"start":{"line":16,"column":1,"offset":511},"end":{"line":16,"column":124,"offset":634},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":511},"end":{"line":16,"column":124,"offset":634},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":18,"column":3,"offset":638},"end":{"line":18,"column":16,"offset":651},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":636},"end":{"line":18,"column":16,"offset":651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is the storage component for Kerberos Enterprise. It is used to store your recordings at a central place, in the storage system you prefer. Next to that it can be used for extension and integration capabilities. Learn more about ","position":{"start":{"line":20,"column":1,"offset":653},"end":{"line":20,"column":247,"offset":899},"indent":[]}},{"type":"link","title":null,"url":"/storage","children":[{"type":"text","value":"Kerberos Storage here","position":{"start":{"line":20,"column":248,"offset":900},"end":{"line":20,"column":269,"offset":921},"indent":[]}}],"position":{"start":{"line":20,"column":247,"offset":899},"end":{"line":20,"column":280,"offset":932},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":20,"column":280,"offset":932},"end":{"line":20,"column":281,"offset":933},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":653},"end":{"line":20,"column":281,"offset":933},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To use Kerberos Storage, you will need to have Kerberos Enterprise installed, and deployments running. Independent from that one can also use the Kerberos Storage API ","position":{"start":{"line":22,"column":1,"offset":935},"end":{"line":22,"column":168,"offset":1102},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":22,"column":168,"offset":1102},"end":{"line":22,"column":189,"offset":1123},"indent":[]}},{"type":"text","value":" to send recordings from a custom build VMS.","position":{"start":{"line":22,"column":189,"offset":1123},"end":{"line":22,"column":233,"offset":1167},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":935},"end":{"line":22,"column":233,"offset":1167},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":24,"column":3,"offset":1171},"end":{"line":24,"column":15,"offset":1183},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1169},"end":{"line":24,"column":15,"offset":1183},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to Kerberos Enterprise, Kerberos Storage, requires some initial components to be installed. If you will run Kerberos Storage in the same cluster as where you have Kerberos Enterprise running, there is not much to do.","position":{"start":{"line":26,"column":1,"offset":1185},"end":{"line":26,"column":225,"offset":1409},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1185},"end":{"line":26,"column":225,"offset":1409},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"However if you plan to run Kerberos Storage in a different cluster (which is perfectly possible), you will need to make sure you complete the initial setup of ","position":{"start":{"line":28,"column":1,"offset":1411},"end":{"line":28,"column":160,"offset":1570},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/installation-edge","children":[{"type":"text","value":"Kerberos Enterprise Edge","position":{"start":{"line":28,"column":161,"offset":1571},"end":{"line":28,"column":185,"offset":1595},"indent":[]}}],"position":{"start":{"line":28,"column":160,"offset":1570},"end":{"line":28,"column":217,"offset":1627},"indent":[]}},{"type":"text","value":" installation. To be more specific you will need the following components running:","position":{"start":{"line":28,"column":217,"offset":1627},"end":{"line":28,"column":299,"offset":1709},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1411},"end":{"line":28,"column":299,"offset":1709},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Helm","position":{"start":{"line":30,"column":3,"offset":1713},"end":{"line":30,"column":7,"offset":1717},"indent":[]}}],"position":{"start":{"line":30,"column":3,"offset":1713},"end":{"line":30,"column":7,"offset":1717},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1711},"end":{"line":30,"column":7,"offset":1717},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Calico","position":{"start":{"line":31,"column":3,"offset":1720},"end":{"line":31,"column":9,"offset":1726},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1720},"end":{"line":31,"column":9,"offset":1726},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1718},"end":{"line":31,"column":9,"offset":1726},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MetalLB","position":{"start":{"line":32,"column":3,"offset":1729},"end":{"line":32,"column":10,"offset":1736},"indent":[]}}],"position":{"start":{"line":32,"column":3,"offset":1729},"end":{"line":32,"column":10,"offset":1736},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1727},"end":{"line":32,"column":10,"offset":1736},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":33,"column":3,"offset":1739},"end":{"line":33,"column":10,"offset":1746},"indent":[]}}],"position":{"start":{"line":33,"column":3,"offset":1739},"end":{"line":33,"column":10,"offset":1746},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1737},"end":{"line":33,"column":10,"offset":1746},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":34,"column":3,"offset":1749},"end":{"line":34,"column":10,"offset":1756},"indent":[]}}],"position":{"start":{"line":34,"column":3,"offset":1749},"end":{"line":34,"column":10,"offset":1756},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":1747},"end":{"line":34,"column":10,"offset":1756},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1711},"end":{"line":34,"column":10,"offset":1756},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once this is done start by cloning the configurations from our ","position":{"start":{"line":36,"column":1,"offset":1758},"end":{"line":36,"column":64,"offset":1821},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/storage","children":[{"type":"text","value":"Github repo","position":{"start":{"line":36,"column":65,"offset":1822},"end":{"line":36,"column":76,"offset":1833},"indent":[]}}],"position":{"start":{"line":36,"column":64,"offset":1821},"end":{"line":36,"column":117,"offset":1874},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":36,"column":117,"offset":1874},"end":{"line":36,"column":118,"offset":1875},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":1758},"end":{"line":36,"column":118,"offset":1875},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/storage","position":{"start":{"line":38,"column":1,"offset":1877},"end":{"line":38,"column":53,"offset":1929},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage","position":{"start":{"line":40,"column":4,"offset":1934},"end":{"line":40,"column":11,"offset":1941},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1931},"end":{"line":40,"column":11,"offset":1941},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to Kerberos Enterprise, Kerberos Storage is managed through a web app. It allows you to add storage providers (S3, minio, etc), add queues for messaging, accounts for security and much more. It also comes with API's, which you can use to interact and retrieve information from Kerberos Storage. All is documented in the form of Swagger APIs ","position":{"start":{"line":42,"column":1,"offset":1943},"end":{"line":42,"column":350,"offset":2292},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":42,"column":350,"offset":2292},"end":{"line":42,"column":371,"offset":2313},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":42,"column":371,"offset":2313},"end":{"line":42,"column":372,"offset":2314},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":1943},"end":{"line":42,"column":372,"offset":2314},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing Kerberos Storage, open the ","position":{"start":{"line":44,"column":1,"offset":2316},"end":{"line":44,"column":46,"offset":2361},"indent":[]}},{"type":"inlineCode","value":"./storage/yaml/deployment.yaml","position":{"start":{"line":44,"column":46,"offset":2361},"end":{"line":44,"column":78,"offset":2393},"indent":[]}},{"type":"text","value":" configuration file. At the bottom file you will find two endpoints, similar to the Traefik config file below. Update the domain names to your own domain, and add these to your DNS server or ","position":{"start":{"line":44,"column":78,"offset":2393},"end":{"line":44,"column":269,"offset":2584},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":44,"column":269,"offset":2584},"end":{"line":44,"column":281,"offset":2596},"indent":[]}},{"type":"text","value":" file (and point to the same IP as the Traefik EXTERNAL-IP).","position":{"start":{"line":44,"column":281,"offset":2596},"end":{"line":44,"column":341,"offset":2656},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":2316},"end":{"line":44,"column":341,"offset":2656},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: storage.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: kerberos-storage\n servicePort: 80\n--> - host: api.storage.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: kerberos-storage\n servicePort: 8081","position":{"start":{"line":46,"column":1,"offset":2658},"end":{"line":61,"column":36,"offset":3108},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":63,"column":1,"offset":3110},"end":{"line":63,"column":112,"offset":3221},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3110},"end":{"line":63,"column":112,"offset":3221},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":65,"column":1,"offset":3223},"end":{"line":68,"column":30,"offset":3342},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names and MongoDB credentials, install Kerberos Storage inside your cluster.","position":{"start":{"line":70,"column":1,"offset":3344},"end":{"line":70,"column":109,"offset":3452},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":3344},"end":{"line":70,"column":109,"offset":3452},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./storage/yaml/deployment.yaml","position":{"start":{"line":72,"column":1,"offset":3454},"end":{"line":72,"column":52,"offset":3505},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":74,"column":4,"offset":3510},"end":{"line":74,"column":26,"offset":3532},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":3507},"end":{"line":74,"column":26,"offset":3532},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":76,"column":1,"offset":3534},"end":{"line":76,"column":94,"offset":3627},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":3534},"end":{"line":76,"column":94,"offset":3627},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":78,"column":5,"offset":3633},"end":{"line":78,"column":12,"offset":3640},"indent":[]}}],"position":{"start":{"line":78,"column":5,"offset":3633},"end":{"line":78,"column":12,"offset":3640},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":3629},"end":{"line":78,"column":12,"offset":3640},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":79,"column":5,"offset":3645},"end":{"line":79,"column":12,"offset":3652},"indent":[]}}],"position":{"start":{"line":79,"column":5,"offset":3645},"end":{"line":79,"column":12,"offset":3652},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3641},"end":{"line":79,"column":12,"offset":3652},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Storage","position":{"start":{"line":80,"column":5,"offset":3657},"end":{"line":80,"column":12,"offset":3664},"indent":[]}}],"position":{"start":{"line":80,"column":5,"offset":3657},"end":{"line":80,"column":12,"offset":3664},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":3653},"end":{"line":80,"column":12,"offset":3664},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Enterprise (optional)","position":{"start":{"line":81,"column":5,"offset":3669},"end":{"line":81,"column":26,"offset":3690},"indent":[]}}],"position":{"start":{"line":81,"column":5,"offset":3669},"end":{"line":81,"column":26,"offset":3690},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3665},"end":{"line":81,"column":26,"offset":3690},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":3629},"end":{"line":81,"column":26,"offset":3690},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":83,"column":1,"offset":3692},"end":{"line":83,"column":26,"offset":3717},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":3692},"end":{"line":83,"column":26,"offset":3717},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nkerberos-storage-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-55566dc65c-xgmns 2/2 Running 0 4d13h\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":85,"column":1,"offset":3719},"end":{"line":89,"column":73,"offset":4031},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":91,"column":4,"offset":4036},"end":{"line":91,"column":21,"offset":4053},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4033},"end":{"line":91,"column":21,"offset":4053},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS or ","position":{"start":{"line":93,"column":1,"offset":4055},"end":{"line":93,"column":65,"offset":4119},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":93,"column":65,"offset":4119},"end":{"line":93,"column":77,"offset":4131},"indent":[]}},{"type":"text","value":" file, you should be able to access the Storage application. By navigating to the Storage domain ","position":{"start":{"line":93,"column":77,"offset":4131},"end":{"line":93,"column":174,"offset":4228},"indent":[]}},{"type":"inlineCode","value":"storage.domain.com","position":{"start":{"line":93,"column":174,"offset":4228},"end":{"line":93,"column":194,"offset":4248},"indent":[]}},{"type":"text","value":" in your browser you will see the Storage login page showing up.","position":{"start":{"line":93,"column":194,"offset":4248},"end":{"line":93,"column":258,"offset":4312},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4055},"end":{"line":93,"column":258,"offset":4312},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Storage","position":{"start":{"line":95,"column":1,"offset":4314},"end":{"line":95,"column":71,"offset":4384},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4314},"end":{"line":95,"column":71,"offset":4384},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":98,"column":1,"offset":4387},"end":{"line":98,"column":31,"offset":4417},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":98,"column":31,"offset":4417}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Introduction`}

\n

{`Welcome to the Kerberos Storage Edge installation. This is the way to go if you want to install Kerberos Storage on your Baremetal infrastructure or inside your Private Cloud.`}

\n

\"architecture

\n

{`Before we can actual start installing the different deployments in our cluster, we need to make sure we have one available.`}

\n

{`Prerequisites`}

\n

{`Kerberos Storage is the storage component for Kerberos Enterprise. It is used to store your recordings at a central place, in the storage system you prefer. Next to that it can be used for extension and integration capabilities. Learn more about `}{`Kerberos Storage here`}{`.`}

\n

{`To use Kerberos Storage, you will need to have Kerberos Enterprise installed, and deployments running. Independent from that one can also use the Kerberos Storage API `}{`/swagger/index.html`}{` to send recordings from a custom build VMS.`}

\n

{`Installation`}

\n

{`Similar to Kerberos Enterprise, Kerberos Storage, requires some initial components to be installed. If you will run Kerberos Storage in the same cluster as where you have Kerberos Enterprise running, there is not much to do.`}

\n

{`However if you plan to run Kerberos Storage in a different cluster (which is perfectly possible), you will need to make sure you complete the initial setup of `}{`Kerberos Enterprise Edge`}{` installation. To be more specific you will need the following components running:`}

\n
    \n
  • {`Helm`}
    • \n
  • {`Calico`}
    • \n
  • {`MetalLB`}
    • \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
\n

{`Once this is done start by cloning the configurations from our `}{`Github repo`}{`.`}

\n 
{`git clone https://github.com/kerberos-io/storage`}
\n

{`Storage`}

\n

{`Similar to Kerberos Enterprise, Kerberos Storage is managed through a web app. It allows you to add storage providers (S3, minio, etc), add queues for messaging, accounts for security and much more. It also comes with API's, which you can use to interact and retrieve information from Kerberos Storage. All is documented in the form of Swagger APIs `}{`/swagger/index.html`}{`.`}

\n

{`Before installing Kerberos Storage, open the `}{`./storage/yaml/deployment.yaml`}{` configuration file. At the bottom file you will find two endpoints, similar to the Traefik config file below. Update the domain names to your own domain, and add these to your DNS server or `}{`/etc/hosts`}{` file (and point to the same IP as the Traefik EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: storage.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: kerberos-storage`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.storage.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: kerberos-storage`}{`\n`}{`              servicePort: 8081`}
\n

{`Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names and MongoDB credentials, install Kerberos Storage inside your cluster.`}

\n 
{`kubectl apply -f ./storage/yaml/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Storage`}
    • \n
  • {`Enterprise (optional)`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`kerberos-storage-6f5c877d7c-hf77p 1/1     Running   0          2d11h`}{`\n`}{`mongodb-55566dc65c-xgmns          2/2     Running   0          4d13h`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS or `}{`/etc/hosts`}{` file, you should be able to access the Storage application. By navigating to the Storage domain `}{`storage.domain.com`}{` in your browser you will see the Storage login page showing up.`}

\n

\"Storage\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-01f43fd811b44491e63b67d790a0fc75.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-01f43fd811b44491e63b67d790a0fc75.json new file mode 100644 index 0000000..fc29032 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-01f43fd811b44491e63b67d790a0fc75.json @@ -0,0 +1 @@ +{"expireTime":9007200861829584000,"key":"gatsby-plugin-mdx-entire-payload-fc07109551f5cea87c706a9fed3cf6a0-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":610,"offset":1263},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":610,"offset":1263},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":20,"column":4,"offset":1268},"end":{"line":20,"column":18,"offset":1282},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1265},"end":{"line":20,"column":18,"offset":1282},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":22,"column":1,"offset":1284},"end":{"line":22,"column":291,"offset":1574},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":22,"column":292,"offset":1575},"end":{"line":22,"column":309,"offset":1592},"indent":[]}}],"position":{"start":{"line":22,"column":291,"offset":1574},"end":{"line":22,"column":318,"offset":1601},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":22,"column":318,"offset":1601},"end":{"line":22,"column":319,"offset":1602},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1284},"end":{"line":22,"column":319,"offset":1602},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":24,"column":1,"offset":1604},"end":{"line":24,"column":56,"offset":1659},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1604},"end":{"line":24,"column":56,"offset":1659},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":26,"column":4,"offset":1664},"end":{"line":26,"column":20,"offset":1680},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1661},"end":{"line":26,"column":20,"offset":1680},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":28,"column":1,"offset":1682},"end":{"line":28,"column":253,"offset":1934},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1682},"end":{"line":28,"column":253,"offset":1934},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":30,"column":6,"offset":1941},"end":{"line":30,"column":35,"offset":1970},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1940},"end":{"line":30,"column":70,"offset":2005},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1940},"end":{"line":30,"column":70,"offset":2005},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1936},"end":{"line":30,"column":70,"offset":2005},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":31,"column":6,"offset":2011},"end":{"line":31,"column":29,"offset":2034},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2010},"end":{"line":31,"column":83,"offset":2088},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2010},"end":{"line":31,"column":83,"offset":2088},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":2006},"end":{"line":31,"column":83,"offset":2088},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":32,"column":6,"offset":2094},"end":{"line":32,"column":28,"offset":2116},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2093},"end":{"line":32,"column":57,"offset":2145},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2093},"end":{"line":32,"column":57,"offset":2145},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2089},"end":{"line":32,"column":57,"offset":2145},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":33,"column":6,"offset":2151},"end":{"line":33,"column":11,"offset":2156},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2150},"end":{"line":33,"column":29,"offset":2174},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2150},"end":{"line":33,"column":29,"offset":2174},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2146},"end":{"line":33,"column":29,"offset":2174},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1936},"end":{"line":33,"column":29,"offset":2174},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":35,"column":1,"offset":2176},"end":{"line":35,"column":190,"offset":2365},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2176},"end":{"line":35,"column":190,"offset":2365},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":37,"column":1,"offset":2367},"end":{"line":37,"column":99,"offset":2465},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2367},"end":{"line":37,"column":99,"offset":2465},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":39,"column":1,"offset":2467},"end":{"line":39,"column":220,"offset":2686},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2467},"end":{"line":39,"column":220,"offset":2686},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":41,"column":1,"offset":2688},"end":{"line":41,"column":98,"offset":2785},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2688},"end":{"line":41,"column":98,"offset":2785},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":43,"column":5,"offset":2791},"end":{"line":43,"column":11,"offset":2797},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2787},"end":{"line":43,"column":11,"offset":2797},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":45,"column":1,"offset":2799},"end":{"line":45,"column":303,"offset":3101},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2799},"end":{"line":45,"column":303,"offset":3101},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":47,"column":6,"offset":3108},"end":{"line":47,"column":18,"offset":3120},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3107},"end":{"line":47,"column":46,"offset":3148},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3107},"end":{"line":47,"column":46,"offset":3148},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3103},"end":{"line":47,"column":46,"offset":3148},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":48,"column":6,"offset":3154},"end":{"line":48,"column":29,"offset":3177},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3153},"end":{"line":48,"column":59,"offset":3207},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3153},"end":{"line":48,"column":59,"offset":3207},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":3149},"end":{"line":48,"column":59,"offset":3207},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3103},"end":{"line":48,"column":59,"offset":3207},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":50,"column":1,"offset":3209},"end":{"line":50,"column":368,"offset":3576},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3209},"end":{"line":50,"column":368,"offset":3576},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":52,"column":1,"offset":3578},"end":{"line":52,"column":66,"offset":3643},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3578},"end":{"line":52,"column":66,"offset":3643},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":54,"column":5,"offset":3649},"end":{"line":54,"column":21,"offset":3665},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3645},"end":{"line":54,"column":21,"offset":3665},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":56,"column":1,"offset":3667},"end":{"line":56,"column":237,"offset":3903},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3667},"end":{"line":56,"column":237,"offset":3903},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":58,"column":1,"offset":3905},"end":{"line":58,"column":105,"offset":4009},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3905},"end":{"line":58,"column":105,"offset":4009},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":60,"column":1,"offset":4011},"end":{"line":60,"column":45,"offset":4055},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4011},"end":{"line":60,"column":45,"offset":4055},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":62,"column":3,"offset":4059},"end":{"line":62,"column":380,"offset":4436},"indent":[]}}],"position":{"start":{"line":62,"column":3,"offset":4059},"end":{"line":62,"column":380,"offset":4436},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4057},"end":{"line":63,"column":1,"offset":4437},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":64,"column":3,"offset":4440},"end":{"line":65,"column":49,"offset":4754},"indent":[2]}}],"position":{"start":{"line":64,"column":3,"offset":4440},"end":{"line":65,"column":49,"offset":4754},"indent":[2]}}],"position":{"start":{"line":64,"column":1,"offset":4438},"end":{"line":65,"column":49,"offset":4754},"indent":[1]}}],"position":{"start":{"line":62,"column":1,"offset":4057},"end":{"line":65,"column":49,"offset":4754},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":67,"column":5,"offset":4760},"end":{"line":67,"column":13,"offset":4768},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":4756},"end":{"line":67,"column":13,"offset":4768},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":69,"column":1,"offset":4770},"end":{"line":69,"column":156,"offset":4925},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":69,"column":156,"offset":4925},"end":{"line":69,"column":177,"offset":4946},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":69,"column":177,"offset":4946},"end":{"line":69,"column":188,"offset":4957},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":69,"column":188,"offset":4957},"end":{"line":69,"column":193,"offset":4962},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":69,"column":193,"offset":4962},"end":{"line":69,"column":379,"offset":5148},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4770},"end":{"line":69,"column":379,"offset":5148},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":71,"column":1,"offset":5150},"end":{"line":71,"column":68,"offset":5217},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":5150},"end":{"line":71,"column":68,"offset":5217},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":73,"column":4,"offset":5222},"end":{"line":73,"column":13,"offset":5231},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5219},"end":{"line":73,"column":13,"offset":5231},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":75,"column":1,"offset":5233},"end":{"line":75,"column":44,"offset":5276},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":75,"column":46,"offset":5278},"end":{"line":75,"column":68,"offset":5300},"indent":[]}}],"position":{"start":{"line":75,"column":44,"offset":5276},"end":{"line":75,"column":70,"offset":5302},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":75,"column":70,"offset":5302},"end":{"line":75,"column":106,"offset":5338},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":75,"column":108,"offset":5340},"end":{"line":75,"column":129,"offset":5361},"indent":[]}}],"position":{"start":{"line":75,"column":106,"offset":5338},"end":{"line":75,"column":131,"offset":5363},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":75,"column":131,"offset":5363},"end":{"line":75,"column":159,"offset":5391},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5233},"end":{"line":75,"column":159,"offset":5391},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":78,"column":1,"offset":5394},"end":{"line":78,"column":31,"offset":5424},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":78,"column":31,"offset":5424}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-06fb0375a1ffe37a3f5fc7731f40e5b8.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-06fb0375a1ffe37a3f5fc7731f40e5b8.json new file mode 100644 index 0000000..e39fda3 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-06fb0375a1ffe37a3f5fc7731f40e5b8.json @@ -0,0 +1 @@ +{"expireTime":9007200861829464000,"key":"gatsby-plugin-mdx-entire-payload-429e8ce9ed061412c1cb08806fe96358-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":642,"offset":1295},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":642,"offset":1295},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":20,"column":4,"offset":1300},"end":{"line":20,"column":18,"offset":1314},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1297},"end":{"line":20,"column":18,"offset":1314},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":22,"column":1,"offset":1316},"end":{"line":22,"column":291,"offset":1606},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":22,"column":292,"offset":1607},"end":{"line":22,"column":309,"offset":1624},"indent":[]}}],"position":{"start":{"line":22,"column":291,"offset":1606},"end":{"line":22,"column":318,"offset":1633},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":22,"column":318,"offset":1633},"end":{"line":22,"column":319,"offset":1634},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1316},"end":{"line":22,"column":319,"offset":1634},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":24,"column":1,"offset":1636},"end":{"line":24,"column":56,"offset":1691},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1636},"end":{"line":24,"column":56,"offset":1691},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":26,"column":4,"offset":1696},"end":{"line":26,"column":20,"offset":1712},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1693},"end":{"line":26,"column":20,"offset":1712},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":28,"column":1,"offset":1714},"end":{"line":28,"column":253,"offset":1966},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1714},"end":{"line":28,"column":253,"offset":1966},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":30,"column":6,"offset":1973},"end":{"line":30,"column":35,"offset":2002},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1972},"end":{"line":30,"column":70,"offset":2037},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1972},"end":{"line":30,"column":70,"offset":2037},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1968},"end":{"line":30,"column":70,"offset":2037},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":31,"column":6,"offset":2043},"end":{"line":31,"column":29,"offset":2066},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2042},"end":{"line":31,"column":83,"offset":2120},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2042},"end":{"line":31,"column":83,"offset":2120},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":2038},"end":{"line":31,"column":83,"offset":2120},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":32,"column":6,"offset":2126},"end":{"line":32,"column":28,"offset":2148},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2125},"end":{"line":32,"column":57,"offset":2177},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2125},"end":{"line":32,"column":57,"offset":2177},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2121},"end":{"line":32,"column":57,"offset":2177},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":33,"column":6,"offset":2183},"end":{"line":33,"column":11,"offset":2188},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2182},"end":{"line":33,"column":29,"offset":2206},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2182},"end":{"line":33,"column":29,"offset":2206},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2178},"end":{"line":33,"column":29,"offset":2206},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1968},"end":{"line":33,"column":29,"offset":2206},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":35,"column":1,"offset":2208},"end":{"line":35,"column":190,"offset":2397},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2208},"end":{"line":35,"column":190,"offset":2397},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":37,"column":1,"offset":2399},"end":{"line":37,"column":99,"offset":2497},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2399},"end":{"line":37,"column":99,"offset":2497},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":39,"column":1,"offset":2499},"end":{"line":39,"column":220,"offset":2718},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2499},"end":{"line":39,"column":220,"offset":2718},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":41,"column":1,"offset":2720},"end":{"line":41,"column":98,"offset":2817},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2720},"end":{"line":41,"column":98,"offset":2817},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":43,"column":5,"offset":2823},"end":{"line":43,"column":11,"offset":2829},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2819},"end":{"line":43,"column":11,"offset":2829},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":45,"column":1,"offset":2831},"end":{"line":45,"column":303,"offset":3133},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2831},"end":{"line":45,"column":303,"offset":3133},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":47,"column":6,"offset":3140},"end":{"line":47,"column":18,"offset":3152},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3139},"end":{"line":47,"column":46,"offset":3180},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3139},"end":{"line":47,"column":46,"offset":3180},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3135},"end":{"line":47,"column":46,"offset":3180},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":48,"column":6,"offset":3186},"end":{"line":48,"column":29,"offset":3209},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3185},"end":{"line":48,"column":59,"offset":3239},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3185},"end":{"line":48,"column":59,"offset":3239},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":3181},"end":{"line":48,"column":59,"offset":3239},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3135},"end":{"line":48,"column":59,"offset":3239},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":50,"column":1,"offset":3241},"end":{"line":50,"column":368,"offset":3608},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3241},"end":{"line":50,"column":368,"offset":3608},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":52,"column":1,"offset":3610},"end":{"line":52,"column":66,"offset":3675},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3610},"end":{"line":52,"column":66,"offset":3675},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":54,"column":5,"offset":3681},"end":{"line":54,"column":21,"offset":3697},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3677},"end":{"line":54,"column":21,"offset":3697},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":56,"column":1,"offset":3699},"end":{"line":56,"column":237,"offset":3935},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3699},"end":{"line":56,"column":237,"offset":3935},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":58,"column":1,"offset":3937},"end":{"line":58,"column":105,"offset":4041},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3937},"end":{"line":58,"column":105,"offset":4041},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":60,"column":1,"offset":4043},"end":{"line":60,"column":45,"offset":4087},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4043},"end":{"line":60,"column":45,"offset":4087},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":62,"column":3,"offset":4091},"end":{"line":62,"column":380,"offset":4468},"indent":[]}}],"position":{"start":{"line":62,"column":3,"offset":4091},"end":{"line":62,"column":380,"offset":4468},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4089},"end":{"line":63,"column":1,"offset":4469},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":64,"column":3,"offset":4472},"end":{"line":65,"column":49,"offset":4786},"indent":[2]}}],"position":{"start":{"line":64,"column":3,"offset":4472},"end":{"line":65,"column":49,"offset":4786},"indent":[2]}}],"position":{"start":{"line":64,"column":1,"offset":4470},"end":{"line":65,"column":49,"offset":4786},"indent":[1]}}],"position":{"start":{"line":62,"column":1,"offset":4089},"end":{"line":65,"column":49,"offset":4786},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":67,"column":5,"offset":4792},"end":{"line":67,"column":13,"offset":4800},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":4788},"end":{"line":67,"column":13,"offset":4800},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":69,"column":1,"offset":4802},"end":{"line":69,"column":156,"offset":4957},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":69,"column":156,"offset":4957},"end":{"line":69,"column":177,"offset":4978},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":69,"column":177,"offset":4978},"end":{"line":69,"column":188,"offset":4989},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":69,"column":188,"offset":4989},"end":{"line":69,"column":193,"offset":4994},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":69,"column":193,"offset":4994},"end":{"line":69,"column":379,"offset":5180},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4802},"end":{"line":69,"column":379,"offset":5180},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":71,"column":1,"offset":5182},"end":{"line":71,"column":68,"offset":5249},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":5182},"end":{"line":71,"column":68,"offset":5249},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":73,"column":4,"offset":5254},"end":{"line":73,"column":13,"offset":5263},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5251},"end":{"line":73,"column":13,"offset":5263},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":75,"column":1,"offset":5265},"end":{"line":75,"column":44,"offset":5308},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":75,"column":46,"offset":5310},"end":{"line":75,"column":68,"offset":5332},"indent":[]}}],"position":{"start":{"line":75,"column":44,"offset":5308},"end":{"line":75,"column":70,"offset":5334},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":75,"column":70,"offset":5334},"end":{"line":75,"column":106,"offset":5370},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":75,"column":108,"offset":5372},"end":{"line":75,"column":129,"offset":5393},"indent":[]}}],"position":{"start":{"line":75,"column":106,"offset":5370},"end":{"line":75,"column":131,"offset":5395},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":75,"column":131,"offset":5395},"end":{"line":75,"column":159,"offset":5423},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5265},"end":{"line":75,"column":159,"offset":5423},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":78,"column":1,"offset":5426},"end":{"line":78,"column":31,"offset":5456},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":78,"column":31,"offset":5456}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0804caaf1dc811eb13aa70b34e37fe32.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0804caaf1dc811eb13aa70b34e37fe32.json new file mode 100644 index 0000000..afd045d --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0804caaf1dc811eb13aa70b34e37fe32.json @@ -0,0 +1 @@ +{"expireTime":9007200861824946000,"key":"gatsby-plugin-mdx-entire-payload-fd5dab7565e5d17e916d52f2b78e6ee6-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import SettingsIcon from '@material-ui/icons/Settings';","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":56,"offset":214},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Get Started","position":{"start":{"line":10,"column":3,"offset":218},"end":{"line":10,"column":14,"offset":229},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":216},"end":{"line":10,"column":14,"offset":229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.","position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known ","position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":169,"offset":679},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":14,"column":169,"offset":679},"end":{"line":14,"column":178,"offset":688},"indent":[]}},{"type":"text","value":" command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.","position":{"start":{"line":14,"column":178,"offset":688},"end":{"line":14,"column":314,"offset":824},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":314,"offset":824},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":16,"column":1,"offset":826},"end":{"line":18,"column":11,"offset":1028},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Login page","position":{"start":{"line":20,"column":4,"offset":1033},"end":{"line":20,"column":14,"offset":1043},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1030},"end":{"line":20,"column":14,"offset":1043},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.","position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/login.gif","alt":"Factory","position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The default username password of the Factory web applications is:","position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"username: ","position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":13,"offset":1310},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":28,"column":15,"offset":1312},"end":{"line":28,"column":19,"offset":1316},"indent":[]}}],"position":{"start":{"line":28,"column":13,"offset":1310},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":28,"column":21,"offset":1318},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"password: ","position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":13,"offset":1331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"kerberos","position":{"start":{"line":29,"column":15,"offset":1333},"end":{"line":29,"column":23,"offset":1341},"indent":[]}}],"position":{"start":{"line":29,"column":13,"offset":1331},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1319},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":29,"column":25,"offset":1343},"indent":[1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"The username and password ","position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":29,"offset":1373},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/enterprise/blob/master/yaml/factory/deployment.yaml#L54","children":[{"type":"text","value":"can be changed in the ","position":{"start":{"line":31,"column":30,"offset":1374},"end":{"line":31,"column":52,"offset":1396},"indent":[]}},{"type":"inlineCode","value":"deploment.yaml","position":{"start":{"line":31,"column":52,"offset":1396},"end":{"line":31,"column":68,"offset":1412},"indent":[]}},{"type":"text","value":" file","position":{"start":{"line":31,"column":68,"offset":1412},"end":{"line":31,"column":73,"offset":1417},"indent":[]}}],"position":{"start":{"line":31,"column":29,"offset":1373},"end":{"line":31,"column":162,"offset":1506},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":162,"offset":1506},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1345},"end":{"line":31,"column":163,"offset":1507},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Overview","position":{"start":{"line":33,"column":4,"offset":1512},"end":{"line":33,"column":12,"offset":1520},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1509},"end":{"line":33,"column":12,"offset":1520},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: ","position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":146,"offset":1667},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Docker","position":{"start":{"line":35,"column":148,"offset":1669},"end":{"line":35,"column":154,"offset":1675},"indent":[]}}],"position":{"start":{"line":35,"column":146,"offset":1667},"end":{"line":35,"column":156,"offset":1677},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":35,"column":156,"offset":1677},"end":{"line":35,"column":161,"offset":1682},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":35,"column":163,"offset":1684},"end":{"line":35,"column":173,"offset":1694},"indent":[]}}],"position":{"start":{"line":35,"column":161,"offset":1682},"end":{"line":35,"column":175,"offset":1696},"indent":[]}},{"type":"text","value":". Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.","position":{"start":{"line":35,"column":175,"offset":1696},"end":{"line":35,"column":317,"offset":1838},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":317,"offset":1838},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.","position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/docker-Kubernetes.gif","alt":"Factory","position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":41,"column":4,"offset":2094},"end":{"line":41,"column":14,"offset":2104},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2091},"end":{"line":41,"column":14,"offset":2104},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:","position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Nodes: a list of all the nodes in your cluster.","position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":45,"column":50,"offset":2255},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Deployments: a list of all the Kerberos Enterprise agents running in your cluster.","position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":2256},"end":{"line":46,"column":85,"offset":2340},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pods: all the pods running in your cluster.","position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2341},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":47,"column":46,"offset":2386},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Nodes","position":{"start":{"line":49,"column":4,"offset":2391},"end":{"line":49,"column":9,"offset":2396},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":2388},"end":{"line":49,"column":9,"offset":2396},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.","position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-nodes.png","alt":"Factory","position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Deployments","position":{"start":{"line":55,"column":4,"offset":2700},"end":{"line":55,"column":15,"offset":2711},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2697},"end":{"line":55,"column":15,"offset":2711},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.","position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-deployments.png","alt":"Factory","position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Adding a new deployment","position":{"start":{"line":61,"column":5,"offset":3201},"end":{"line":61,"column":28,"offset":3224},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3197},"end":{"line":61,"column":28,"offset":3224},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"There are two options to add a new deployment, single deployments and bulk deployment.","position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/single-bulk-deployment.gif","alt":"Factory","position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"single deployment","position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.","position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"in bulk deployment.","position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By importing an Excel file, deployments can be created in bulk.","position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.","position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-add-bulk-deployment-excel.png","alt":"Factory","position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Configuring a deployment","position":{"start":{"line":79,"column":5,"offset":3855},"end":{"line":79,"column":29,"offset":3879},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3851},"end":{"line":79,"column":29,"offset":3879},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the ","position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":200,"offset":4080},"indent":[]}},{"type":"jsx","value":"","position":{"start":{"line":81,"column":200,"offset":4080},"end":{"line":81,"column":235,"offset":4115},"indent":[]}},{"type":"text","value":" icon. This will open a popup, allowing you to change some settings.","position":{"start":{"line":81,"column":235,"offset":4115},"end":{"line":81,"column":303,"offset":4183},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":303,"offset":4183},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/deployment-configuration.gif","alt":"Factory","position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Following settings can be changed:","position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more regions of interest,","position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":87,"column":35,"offset":4325},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Time based conditions,","position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":4326},"end":{"line":88,"column":25,"offset":4350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pre- and postrecording","position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4351},"end":{"line":89,"column":25,"offset":4375},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording","position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4376},"end":{"line":90,"column":23,"offset":4398},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Linking to ","position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":14,"offset":4412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":91,"column":15,"offset":4413},"end":{"line":91,"column":29,"offset":4427},"indent":[]}}],"position":{"start":{"line":91,"column":14,"offset":4412},"end":{"line":91,"column":38,"offset":4436},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":91,"column":38,"offset":4436},"end":{"line":91,"column":42,"offset":4440},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":91,"column":43,"offset":4441},"end":{"line":91,"column":59,"offset":4457},"indent":[]}}],"position":{"start":{"line":91,"column":42,"offset":4440},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4399},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":91,"column":83,"offset":4481},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Global configuration","position":{"start":{"line":93,"column":5,"offset":4487},"end":{"line":93,"column":25,"offset":4507},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4483},"end":{"line":93,"column":25,"offset":4507},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.","position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.","position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/global-configuration.gif","alt":"Factory Global Config","position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Upgrade or reboot a Kerberos Enterprise agent","position":{"start":{"line":101,"column":5,"offset":5046},"end":{"line":101,"column":50,"offset":5091},"indent":[]}}],"position":{"start":{"line":101,"column":1,"offset":5042},"end":{"line":101,"column":50,"offset":5091},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, ","position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":373,"offset":5465},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"a zero downtime upgrade will take place","position":{"start":{"line":103,"column":375,"offset":5467},"end":{"line":103,"column":414,"offset":5506},"indent":[]}}],"position":{"start":{"line":103,"column":373,"offset":5465},"end":{"line":103,"column":416,"offset":5508},"indent":[]}},{"type":"text","value":". Kubernetes will download the new release, create a new pod, and destroy the old one.","position":{"start":{"line":103,"column":416,"offset":5508},"end":{"line":103,"column":502,"offset":5594},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":502,"offset":5594},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.","position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}}],"position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/upgrade-reboot.gif","alt":"Upgrade and reboot","position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}}],"position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Pods","position":{"start":{"line":110,"column":4,"offset":5965},"end":{"line":110,"column":8,"offset":5969},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":5962},"end":{"line":110,"column":8,"offset":5969},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.","position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-pods.png","alt":"Factory","position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage and video management","position":{"start":{"line":117,"column":4,"offset":6482},"end":{"line":117,"column":32,"offset":6510},"indent":[]}}],"position":{"start":{"line":117,"column":1,"offset":6479},"end":{"line":117,"column":32,"offset":6510},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).","position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also ","position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":169,"offset":7035},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":121,"column":171,"offset":7037},"end":{"line":121,"column":179,"offset":7045},"indent":[]}}],"position":{"start":{"line":121,"column":169,"offset":7035},"end":{"line":121,"column":181,"offset":7047},"indent":[]}},{"type":"text","value":" have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed ","position":{"start":{"line":121,"column":181,"offset":7047},"end":{"line":121,"column":419,"offset":7285},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":121,"column":420,"offset":7286},"end":{"line":121,"column":436,"offset":7302},"indent":[]}}],"position":{"start":{"line":121,"column":419,"offset":7285},"end":{"line":121,"column":460,"offset":7326},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":121,"column":460,"offset":7326},"end":{"line":121,"column":465,"offset":7331},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":121,"column":466,"offset":7332},"end":{"line":121,"column":480,"offset":7346},"indent":[]}}],"position":{"start":{"line":121,"column":465,"offset":7331},"end":{"line":121,"column":489,"offset":7355},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":121,"column":489,"offset":7355},"end":{"line":121,"column":490,"offset":7356},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":490,"offset":7356},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":123,"column":5,"offset":7362},"end":{"line":123,"column":21,"offset":7378},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":7358},"end":{"line":123,"column":21,"offset":7378},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":125,"column":2,"offset":7381},"end":{"line":125,"column":18,"offset":7397},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":42,"offset":7421},"indent":[]}},{"type":"text","value":" is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).","position":{"start":{"line":125,"column":42,"offset":7421},"end":{"line":125,"column":328,"offset":7707},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":328,"offset":7707},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).","position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}}],"position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the ","position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":147,"offset":8189},"indent":[]}},{"type":"inlineCode","value":"cloud","position":{"start":{"line":131,"column":147,"offset":8189},"end":{"line":131,"column":154,"offset":8196},"indent":[]}},{"type":"text","value":" tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.","position":{"start":{"line":131,"column":154,"offset":8196},"end":{"line":131,"column":245,"offset":8287},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":245,"offset":8287},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Storage URI: this is the API endpoint of your Kerberos Storage instance. Typically this is in the following format: ","position":{"start":{"line":133,"column":3,"offset":8291},"end":{"line":133,"column":119,"offset":8407},"indent":[]}},{"type":"inlineCode","value":"http(s)://api.yourdomain.com/storage","position":{"start":{"line":133,"column":119,"offset":8407},"end":{"line":133,"column":157,"offset":8445},"indent":[]}},{"type":"text","value":". Where ","position":{"start":{"line":133,"column":157,"offset":8445},"end":{"line":133,"column":165,"offset":8453},"indent":[]}},{"type":"inlineCode","value":"api.yourdomain.com","position":{"start":{"line":133,"column":165,"offset":8453},"end":{"line":133,"column":185,"offset":8473},"indent":[]}},{"type":"text","value":" should match your Kerberos Storage API endpoint.","position":{"start":{"line":133,"column":185,"offset":8473},"end":{"line":133,"column":234,"offset":8522},"indent":[]}}],"position":{"start":{"line":133,"column":3,"offset":8291},"end":{"line":133,"column":234,"offset":8522},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":8289},"end":{"line":134,"column":1,"offset":8523},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Provider: the name of the provider, which you created on the Kerberos Storage providers page, to which you want to send your recordings to.","position":{"start":{"line":135,"column":3,"offset":8526},"end":{"line":135,"column":142,"offset":8665},"indent":[]}}],"position":{"start":{"line":135,"column":3,"offset":8526},"end":{"line":135,"column":142,"offset":8665},"indent":[]}}],"position":{"start":{"line":135,"column":1,"offset":8524},"end":{"line":136,"column":1,"offset":8666},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Directory: this is the subdirectory in which your files will be stored. At the time of writing this should also equal your Kerberos Cloud username, if you plan to upload to Kerberos Cloud.","position":{"start":{"line":137,"column":3,"offset":8669},"end":{"line":137,"column":191,"offset":8857},"indent":[]}}],"position":{"start":{"line":137,"column":3,"offset":8669},"end":{"line":137,"column":191,"offset":8857},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":8667},"end":{"line":138,"column":1,"offset":8858},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Access Key: this should match the access key of one of your Kerberos Storage accounts.","position":{"start":{"line":139,"column":3,"offset":8861},"end":{"line":139,"column":89,"offset":8947},"indent":[]}}],"position":{"start":{"line":139,"column":3,"offset":8861},"end":{"line":139,"column":89,"offset":8947},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":8859},"end":{"line":140,"column":1,"offset":8948},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secret Access Key: this should match the secret access key of one of your Kerberos Storage accounts.","position":{"start":{"line":141,"column":3,"offset":8951},"end":{"line":141,"column":103,"offset":9051},"indent":[]}}],"position":{"start":{"line":141,"column":3,"offset":8951},"end":{"line":141,"column":103,"offset":9051},"indent":[]}}],"position":{"start":{"line":141,"column":1,"offset":8949},"end":{"line":141,"column":103,"offset":9051},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":8289},"end":{"line":141,"column":103,"offset":9051},"indent":[1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-enterprise-storage-setup.gif","alt":"kerberos storage configuration","position":{"start":{"line":144,"column":1,"offset":9054},"end":{"line":144,"column":101,"offset":9154},"indent":[]}}],"position":{"start":{"line":144,"column":1,"offset":9054},"end":{"line":144,"column":101,"offset":9154},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":146,"column":5,"offset":9160},"end":{"line":146,"column":19,"offset":9174},"indent":[]}}],"position":{"start":{"line":146,"column":1,"offset":9156},"end":{"line":146,"column":19,"offset":9174},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more ","position":{"start":{"line":148,"column":1,"offset":9176},"end":{"line":148,"column":219,"offset":9394},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"about the features and functions here","position":{"start":{"line":148,"column":220,"offset":9395},"end":{"line":148,"column":257,"offset":9432},"indent":[]}}],"position":{"start":{"line":148,"column":219,"offset":9394},"end":{"line":148,"column":266,"offset":9441},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":148,"column":266,"offset":9441},"end":{"line":148,"column":267,"offset":9442},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":9176},"end":{"line":148,"column":267,"offset":9442},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the ","position":{"start":{"line":150,"column":1,"offset":9444},"end":{"line":150,"column":285,"offset":9728},"indent":[]}},{"type":"link","title":null,"url":"/storage/get-started","children":[{"type":"text","value":"Kerberos Storage page","position":{"start":{"line":150,"column":286,"offset":9729},"end":{"line":150,"column":307,"offset":9750},"indent":[]}}],"position":{"start":{"line":150,"column":285,"offset":9728},"end":{"line":150,"column":330,"offset":9773},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":150,"column":330,"offset":9773},"end":{"line":150,"column":331,"offset":9774},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":9444},"end":{"line":150,"column":331,"offset":9774},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.","position":{"start":{"line":152,"column":1,"offset":9776},"end":{"line":152,"column":104,"offset":9879},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":9776},"end":{"line":152,"column":104,"offset":9879},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-enterprise-to-cloud.gif","alt":"kerberos storage configuration","position":{"start":{"line":154,"column":1,"offset":9881},"end":{"line":154,"column":96,"offset":9976},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":9881},"end":{"line":154,"column":96,"offset":9976},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Region: this is the region where your recordings will be stored. Only ","position":{"start":{"line":157,"column":3,"offset":9981},"end":{"line":157,"column":73,"offset":10051},"indent":[]}},{"type":"inlineCode","value":"eu-west-1","position":{"start":{"line":157,"column":73,"offset":10051},"end":{"line":157,"column":84,"offset":10062},"indent":[]}},{"type":"text","value":" for now (will change, on the roadmap).","position":{"start":{"line":157,"column":84,"offset":10062},"end":{"line":157,"column":123,"offset":10101},"indent":[]}}],"position":{"start":{"line":157,"column":3,"offset":9981},"end":{"line":157,"column":123,"offset":10101},"indent":[]}}],"position":{"start":{"line":157,"column":1,"offset":9979},"end":{"line":158,"column":1,"offset":10102},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Bucket: the name of the Kerberos Cloud bucket. Only ","position":{"start":{"line":159,"column":3,"offset":10105},"end":{"line":159,"column":56,"offset":10158},"indent":[]}},{"type":"inlineCode","value":"kerberosaccept","position":{"start":{"line":159,"column":56,"offset":10158},"end":{"line":159,"column":72,"offset":10174},"indent":[]}},{"type":"text","value":" for now (will change, on the roadmap).","position":{"start":{"line":159,"column":72,"offset":10174},"end":{"line":159,"column":111,"offset":10213},"indent":[]}}],"position":{"start":{"line":159,"column":3,"offset":10105},"end":{"line":159,"column":111,"offset":10213},"indent":[]}}],"position":{"start":{"line":159,"column":1,"offset":10103},"end":{"line":160,"column":1,"offset":10214},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Directory: this is your personal directory, and matches your Kerberos Cloud username.","position":{"start":{"line":161,"column":3,"offset":10217},"end":{"line":161,"column":88,"offset":10302},"indent":[]}}],"position":{"start":{"line":161,"column":3,"offset":10217},"end":{"line":161,"column":88,"offset":10302},"indent":[]}}],"position":{"start":{"line":161,"column":1,"offset":10215},"end":{"line":162,"column":1,"offset":10303},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Access Key: this should match the access key of one of your Kerberos Storage accounts.","position":{"start":{"line":163,"column":3,"offset":10306},"end":{"line":163,"column":89,"offset":10392},"indent":[]}}],"position":{"start":{"line":163,"column":3,"offset":10306},"end":{"line":163,"column":89,"offset":10392},"indent":[]}}],"position":{"start":{"line":163,"column":1,"offset":10304},"end":{"line":164,"column":1,"offset":10393},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secret Access Key: this should match the secret access key of one of your Kerberos Storage accounts.","position":{"start":{"line":165,"column":3,"offset":10396},"end":{"line":165,"column":103,"offset":10496},"indent":[]}}],"position":{"start":{"line":165,"column":3,"offset":10396},"end":{"line":165,"column":103,"offset":10496},"indent":[]}}],"position":{"start":{"line":165,"column":1,"offset":10394},"end":{"line":165,"column":103,"offset":10496},"indent":[]}}],"position":{"start":{"line":157,"column":1,"offset":9979},"end":{"line":165,"column":103,"offset":10496},"indent":[1,1,1,1,1,1,1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":168,"column":1,"offset":10499},"end":{"line":168,"column":31,"offset":10529},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":168,"column":31,"offset":10529}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport SettingsIcon from '@material-ui/icons/Settings';\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Get Started`}

\n

{`Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.`}

\n

{`Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known `}{`kubectl`}{` command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.`}

\n
\n
\n

\n

{`Login page`}

\n

{`Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.`}

\n

\"Factory\"

\n

{`The default username password of the Factory web applications is:`}

\n
    \n
  • {`username: `}{`root`}
    • \n
  • {`password: `}{`kerberos`}
    • \n
\n
\n

{`The username and password `}{`can be changed in the `}{`deploment.yaml`}{` file`}{`.`}

\n
\n

{`Overview`}

\n

{`On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: `}{`Docker`}{` and `}{`Kubernetes`}{`. Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.`}

\n

{`When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.`}

\n

\"Factory\"

\n

{`Kubernetes`}

\n

{`On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:`}

\n
    \n
  • {`Nodes: a list of all the nodes in your cluster.`}
    • \n
  • {`Deployments: a list of all the Kerberos Enterprise agents running in your cluster.`}
    • \n
  • {`Pods: all the pods running in your cluster.`}
    • \n
\n

{`Nodes`}

\n

{`The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.`}

\n

\"Factory\"

\n

{`Deployments`}

\n

{`The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.`}

\n

\"Factory\"

\n

{`Adding a new deployment`}

\n

{`There are two options to add a new deployment, single deployments and bulk deployment.`}

\n

\"Factory\"

\n
    \n
  • {`single deployment`}
    • \n
\n

{`By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.`}

\n
    \n
  • {`in bulk deployment.`}
    • \n
\n

{`By importing an Excel file, deployments can be created in bulk.`}

\n

{`By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.`}

\n

\"Factory\"

\n

{`Configuring a deployment`}

\n

{`Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the `}{` icon. This will open a popup, allowing you to change some settings.`}

\n

\"Factory\"

\n

{`Following settings can be changed:`}

\n
    \n
  • {`One or more regions of interest,`}
    • \n
  • {`Time based conditions,`}
    • \n
  • {`Pre- and postrecording`}
    • \n
  • {`Continious recording`}
    • \n
  • {`Linking to `}{`Kerberos Cloud`}{` or `}{`Kerberos Storage`}
    • \n
\n

{`Global configuration`}

\n

{`Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.`}

\n

{`By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.`}

\n

\"Factory

\n

{`Upgrade or reboot a Kerberos Enterprise agent`}

\n

{`At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, `}{`a zero downtime upgrade will take place`}{`. Kubernetes will download the new release, create a new pod, and destroy the old one.`}

\n

{`At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.`}

\n

\"Upgrade

\n

{`Pods`}

\n

{`When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.`}

\n

\"Factory\"

\n

{`Storage and video management`}

\n

{`Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).`}

\n

{`Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also `}{`does not`}{` have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed `}{`Kerberos Storage`}{` and `}{`Kerberos Cloud`}{`.`}

\n

{`Kerberos Storage`}

\n

{`Kerberos Storage`}{` is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).`}

\n

{`On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).`}

\n

\"architecture

\n

{`To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the `}{`cloud`}{` tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.`}

\n
    \n
  • \n

    {`Storage URI: this is the API endpoint of your Kerberos Storage instance. Typically this is in the following format: `}{`http(s)://api.yourdomain.com/storage`}{`. Where `}{`api.yourdomain.com`}{` should match your Kerberos Storage API endpoint.`}

    \n
    • \n
  • \n

    {`Provider: the name of the provider, which you created on the Kerberos Storage providers page, to which you want to send your recordings to.`}

    \n
    • \n
  • \n

    {`Directory: this is the subdirectory in which your files will be stored. At the time of writing this should also equal your Kerberos Cloud username, if you plan to upload to Kerberos Cloud.`}

    \n
    • \n
  • \n

    {`Access Key: this should match the access key of one of your Kerberos Storage accounts.`}

    \n
    • \n
  • \n

    {`Secret Access Key: this should match the secret access key of one of your Kerberos Storage accounts.`}

    \n
    • \n
\n

\"kerberos

\n

{`Kerberos Cloud`}

\n

{`For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more `}{`about the features and functions here`}{`.`}

\n

{`You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the `}{`Kerberos Storage page`}{`.`}

\n

{`Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.`}

\n

\"kerberos

\n
    \n
  • \n

    {`Region: this is the region where your recordings will be stored. Only `}{`eu-west-1`}{` for now (will change, on the roadmap).`}

    \n
    • \n
  • \n

    {`Bucket: the name of the Kerberos Cloud bucket. Only `}{`kerberosaccept`}{` for now (will change, on the roadmap).`}

    \n
    • \n
  • \n

    {`Directory: this is your personal directory, and matches your Kerberos Cloud username.`}

    \n
    • \n
  • \n

    {`Access Key: this should match the access key of one of your Kerberos Storage accounts.`}

    \n
    • \n
  • \n

    {`Secret Access Key: this should match the secret access key of one of your Kerberos Storage accounts.`}

    \n
    • \n
\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0aba6c9a0ad3957e6773e032a84a2399.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0aba6c9a0ad3957e6773e032a84a2399.json index 684fdff..81af3b0 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0aba6c9a0ad3957e6773e032a84a2399.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0aba6c9a0ad3957e6773e032a84a2399.json @@ -1 +1 @@ -{"expireTime":9007200861747685000,"key":"gatsby-plugin-mdx-entire-payload-e2342ab6842f8987168b840f99e28360-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Web interface","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":16,"offset":174},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":16,"offset":174},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The web is responsible for the visualization. It's a GUI which helps the user to find activity at a specific period, configure the machinery, view a live stream, see system information and much more.","position":{"start":{"line":10,"column":1,"offset":176},"end":{"line":10,"column":200,"offset":375},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":176},"end":{"line":10,"column":200,"offset":375},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"It's written in PHP using the extremely popular PHP Framework Laravel, and Javascript using the client-side framework BackboneJS. We will discuss the different pages and functionality briefly. Please check out ","position":{"start":{"line":12,"column":1,"offset":377},"end":{"line":12,"column":211,"offset":587},"indent":[]}},{"type":"link","title":null,"url":"https://demo.kerberos.io","children":[{"type":"text","value":"the demo environment","position":{"start":{"line":12,"column":212,"offset":588},"end":{"line":12,"column":232,"offset":608},"indent":[]}}],"position":{"start":{"line":12,"column":211,"offset":587},"end":{"line":12,"column":259,"offset":635},"indent":[]}},{"type":"text","value":" if you want to see a real life example.","position":{"start":{"line":12,"column":259,"offset":635},"end":{"line":12,"column":299,"offset":675},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":377},"end":{"line":12,"column":299,"offset":675},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Overview","position":{"start":{"line":14,"column":4,"offset":680},"end":{"line":14,"column":12,"offset":688},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":677},"end":{"line":14,"column":12,"offset":688},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"We will shortly discuss the different pages that make up the web interface of Kerberos Open Source.","position":{"start":{"line":16,"column":1,"offset":690},"end":{"line":16,"column":100,"offset":789},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":690},"end":{"line":16,"column":100,"offset":789},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Dashboard","position":{"start":{"line":18,"column":5,"offset":795},"end":{"line":18,"column":14,"offset":804},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":791},"end":{"line":18,"column":14,"offset":804},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The landing page of the web is the dashboard. On the dashboard a user will see some statistics: activity per hour, activity per day, a live stream, the latest activity and a heatmap.","position":{"start":{"line":20,"column":1,"offset":806},"end":{"line":20,"column":183,"offset":988},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":806},"end":{"line":20,"column":183,"offset":988},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/web/dashboard.png","alt":"web dashboard","position":{"start":{"line":22,"column":1,"offset":990},"end":{"line":22,"column":56,"offset":1045},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":990},"end":{"line":22,"column":56,"offset":1045},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Overview","position":{"start":{"line":24,"column":5,"offset":1051},"end":{"line":24,"column":13,"offset":1059},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1047},"end":{"line":24,"column":13,"offset":1059},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When selecting a specific day, you'll will get a timeline and overview. By using the timeline you can navigate through a day; the timeline highlights the amount of activity, from gray to red.","position":{"start":{"line":26,"column":1,"offset":1061},"end":{"line":26,"column":192,"offset":1252},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1061},"end":{"line":26,"column":192,"offset":1252},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/web/overview.png","alt":"web overview","position":{"start":{"line":28,"column":1,"offset":1254},"end":{"line":28,"column":54,"offset":1307},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1254},"end":{"line":28,"column":54,"offset":1307},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Settings","position":{"start":{"line":30,"column":5,"offset":1313},"end":{"line":30,"column":13,"offset":1321},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1309},"end":{"line":30,"column":13,"offset":1321},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The settings page allows you to configure the machinery. You can define the type of camera, post-processes, conditions and much more; it's highly configurable.","position":{"start":{"line":32,"column":1,"offset":1323},"end":{"line":32,"column":160,"offset":1482},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1323},"end":{"line":32,"column":160,"offset":1482},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/web/settings.png","alt":"web settings","position":{"start":{"line":36,"column":1,"offset":1486},"end":{"line":36,"column":54,"offset":1539},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":1486},"end":{"line":36,"column":54,"offset":1539},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"System","position":{"start":{"line":38,"column":5,"offset":1545},"end":{"line":38,"column":11,"offset":1551},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1541},"end":{"line":38,"column":11,"offset":1551},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The system page allows you to monitor the system. On this page you'll get an overview of the system specifications (CPU, Memory, Network, etc). Several actions are available: you can download system information (for debugging purposes) and download or remove your images.","position":{"start":{"line":40,"column":1,"offset":1553},"end":{"line":40,"column":272,"offset":1824},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1553},"end":{"line":40,"column":272,"offset":1824},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/web/system.png","alt":"web system","position":{"start":{"line":42,"column":1,"offset":1826},"end":{"line":42,"column":50,"offset":1875},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":1826},"end":{"line":42,"column":50,"offset":1875},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Project structure","position":{"start":{"line":44,"column":4,"offset":1880},"end":{"line":44,"column":21,"offset":1897},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":1877},"end":{"line":44,"column":21,"offset":1897},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The web interface is using the Laravel framework (version 5.4). There is a lot of documentation related to Laravel, please review ","position":{"start":{"line":46,"column":1,"offset":1899},"end":{"line":46,"column":131,"offset":2029},"indent":[]}},{"type":"link","title":null,"url":"https://laravel.com/docs/5.4","children":[{"type":"text","value":"their documentation website here","position":{"start":{"line":46,"column":132,"offset":2030},"end":{"line":46,"column":164,"offset":2062},"indent":[]}}],"position":{"start":{"line":46,"column":131,"offset":2029},"end":{"line":46,"column":195,"offset":2093},"indent":[]}},{"type":"text","value":". In a nutshell this is how the web is organised.","position":{"start":{"line":46,"column":195,"offset":2093},"end":{"line":46,"column":244,"offset":2142},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":1899},"end":{"line":46,"column":244,"offset":2142},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Back-end","position":{"start":{"line":48,"column":5,"offset":2148},"end":{"line":48,"column":13,"offset":2156},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":2144},"end":{"line":48,"column":13,"offset":2156},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"config/app.php - general application settings.","position":{"start":{"line":50,"column":3,"offset":2160},"end":{"line":50,"column":49,"offset":2206},"indent":[]}}],"position":{"start":{"line":50,"column":3,"offset":2160},"end":{"line":50,"column":49,"offset":2206},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2158},"end":{"line":50,"column":49,"offset":2206},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"config/kerberos.php - this file contains web specific parameters; the user credentials to sign in, etc.","position":{"start":{"line":51,"column":3,"offset":2209},"end":{"line":51,"column":106,"offset":2312},"indent":[]}}],"position":{"start":{"line":51,"column":3,"offset":2209},"end":{"line":51,"column":106,"offset":2312},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2207},"end":{"line":51,"column":106,"offset":2312},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"app/Http/Controllers - MVC controllers","position":{"start":{"line":52,"column":3,"offset":2315},"end":{"line":52,"column":41,"offset":2353},"indent":[]}}],"position":{"start":{"line":52,"column":3,"offset":2315},"end":{"line":52,"column":41,"offset":2353},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":2313},"end":{"line":52,"column":41,"offset":2353},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"app/Http/Repositories -repositories are injected into the controller.","position":{"start":{"line":53,"column":3,"offset":2356},"end":{"line":53,"column":72,"offset":2425},"indent":[]}}],"position":{"start":{"line":53,"column":3,"offset":2356},"end":{"line":53,"column":72,"offset":2425},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2354},"end":{"line":53,"column":72,"offset":2425},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"app/Providers/AppServiceProvider.php - bind repositories to a specific interface - dependency injection.","position":{"start":{"line":54,"column":3,"offset":2428},"end":{"line":54,"column":107,"offset":2532},"indent":[]}}],"position":{"start":{"line":54,"column":3,"offset":2428},"end":{"line":54,"column":107,"offset":2532},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":2426},"end":{"line":54,"column":107,"offset":2532},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"routes/api.php - contains all the URI endpoints for Ajax calls.","position":{"start":{"line":55,"column":3,"offset":2535},"end":{"line":55,"column":66,"offset":2598},"indent":[]}}],"position":{"start":{"line":55,"column":3,"offset":2535},"end":{"line":55,"column":66,"offset":2598},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2533},"end":{"line":55,"column":66,"offset":2598},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"routes/web.php - url routing for pages.","position":{"start":{"line":56,"column":3,"offset":2601},"end":{"line":56,"column":42,"offset":2640},"indent":[]}}],"position":{"start":{"line":56,"column":3,"offset":2601},"end":{"line":56,"column":42,"offset":2640},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":2599},"end":{"line":56,"column":42,"offset":2640},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2158},"end":{"line":56,"column":42,"offset":2640},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Front-end","position":{"start":{"line":58,"column":5,"offset":2646},"end":{"line":58,"column":14,"offset":2655},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":2642},"end":{"line":58,"column":14,"offset":2655},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/css/less - LESS is used for the CSS.","position":{"start":{"line":60,"column":3,"offset":2659},"end":{"line":60,"column":46,"offset":2702},"indent":[]}}],"position":{"start":{"line":60,"column":3,"offset":2659},"end":{"line":60,"column":46,"offset":2702},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":2657},"end":{"line":60,"column":46,"offset":2702},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/js/app - BackboneJS and RequireJS is used for building modular JS classes.","position":{"start":{"line":61,"column":3,"offset":2705},"end":{"line":61,"column":84,"offset":2786},"indent":[]}}],"position":{"start":{"line":61,"column":3,"offset":2705},"end":{"line":61,"column":84,"offset":2786},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":2703},"end":{"line":61,"column":84,"offset":2786},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/js/mustache - Mustache is used for the client-side view rendering.","position":{"start":{"line":62,"column":3,"offset":2789},"end":{"line":62,"column":76,"offset":2862},"indent":[]}}],"position":{"start":{"line":62,"column":3,"offset":2789},"end":{"line":62,"column":76,"offset":2862},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":2787},"end":{"line":62,"column":76,"offset":2862},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/js/vendor - This is where the bower extensions are installed.","position":{"start":{"line":63,"column":3,"offset":2865},"end":{"line":63,"column":71,"offset":2933},"indent":[]}}],"position":{"start":{"line":63,"column":3,"offset":2865},"end":{"line":63,"column":71,"offset":2933},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":2863},"end":{"line":63,"column":71,"offset":2933},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/capture - A directory where images are written to by default.","position":{"start":{"line":64,"column":3,"offset":2936},"end":{"line":64,"column":71,"offset":3004},"indent":[]}}],"position":{"start":{"line":64,"column":3,"offset":2936},"end":{"line":64,"column":71,"offset":3004},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":2934},"end":{"line":64,"column":71,"offset":3004},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/bower.json - The bower extensions used in the web repository.","position":{"start":{"line":65,"column":3,"offset":3007},"end":{"line":65,"column":71,"offset":3075},"indent":[]}}],"position":{"start":{"line":65,"column":3,"offset":3007},"end":{"line":65,"column":71,"offset":3075},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":3005},"end":{"line":65,"column":71,"offset":3075},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/Gruntfile.js - We are using Grunt for our task manager.","position":{"start":{"line":66,"column":3,"offset":3078},"end":{"line":66,"column":65,"offset":3140},"indent":[]}}],"position":{"start":{"line":66,"column":3,"offset":3078},"end":{"line":66,"column":65,"offset":3140},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":3076},"end":{"line":66,"column":65,"offset":3140},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":2657},"end":{"line":66,"column":65,"offset":3140},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"API","position":{"start":{"line":68,"column":4,"offset":3145},"end":{"line":68,"column":7,"offset":3148},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":3142},"end":{"line":68,"column":7,"offset":3148},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to integrate the Kerberos agent with your own application, you're at the right place! The web interface comes with a RESTfull API, that allows you to retrieve and modify information from the Kerberos agent.","position":{"start":{"line":70,"column":1,"offset":3150},"end":{"line":70,"column":219,"offset":3368},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":3150},"end":{"line":70,"column":219,"offset":3368},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Disable the machinery","position":{"start":{"line":72,"column":3,"offset":3372},"end":{"line":72,"column":24,"offset":3393},"indent":[]}}],"position":{"start":{"line":72,"column":3,"offset":3372},"end":{"line":72,"column":24,"offset":3393},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3370},"end":{"line":72,"column":24,"offset":3393},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Health check","position":{"start":{"line":73,"column":3,"offset":3396},"end":{"line":73,"column":15,"offset":3408},"indent":[]}}],"position":{"start":{"line":73,"column":3,"offset":3396},"end":{"line":73,"column":15,"offset":3408},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":3394},"end":{"line":73,"column":15,"offset":3408},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Enable or disable output devices","position":{"start":{"line":74,"column":3,"offset":3411},"end":{"line":74,"column":35,"offset":3443},"indent":[]}}],"position":{"start":{"line":74,"column":3,"offset":3411},"end":{"line":74,"column":35,"offset":3443},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":3409},"end":{"line":74,"column":35,"offset":3443},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"etc.","position":{"start":{"line":75,"column":3,"offset":3446},"end":{"line":75,"column":7,"offset":3450},"indent":[]}}],"position":{"start":{"line":75,"column":3,"offset":3446},"end":{"line":75,"column":7,"offset":3450},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3444},"end":{"line":75,"column":7,"offset":3450},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3370},"end":{"line":75,"column":7,"offset":3450},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Authentication","position":{"start":{"line":77,"column":5,"offset":3456},"end":{"line":77,"column":19,"offset":3470},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3452},"end":{"line":77,"column":19,"offset":3470},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To use the RESTfull API of your Kerberos agent you need to define an Authorization header with each request. We use Basic Authentication to secure the different endpoints.","position":{"start":{"line":79,"column":1,"offset":3472},"end":{"line":79,"column":172,"offset":3643},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3472},"end":{"line":79,"column":172,"offset":3643},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"\"Authorization\": \"Basic root:root\"","position":{"start":{"line":81,"column":1,"offset":3645},"end":{"line":83,"column":4,"offset":3691},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"An example with Python looks like this.","position":{"start":{"line":85,"column":1,"offset":3693},"end":{"line":85,"column":40,"offset":3732},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":3693},"end":{"line":85,"column":40,"offset":3732},"indent":[]}},{"type":"code","lang":"python","meta":null,"value":"import requests\nimport json\nimport base64\nurl = \"http://ip-of-pi/api/v1/condition/enabled\"\nusername = \"user\"\npassword = \"passw\"\nbasicAuth = base64.b64encode('%s:%s' % (username, password))\nheaders = {\"Authorization\": \"Basic \" + basicAuth, \"Content-Type\": \"application/json\"}\ndata = '{\"active\": \"true\"}'\n#Call REST API\nresponse = requests.put(url, data=data, headers=headers)\nprint(response.text)","position":{"start":{"line":87,"column":1,"offset":3734},"end":{"line":100,"column":4,"offset":4143},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"If you're using the wrong credentials, the web will return following error message.","position":{"start":{"line":102,"column":1,"offset":4145},"end":{"line":102,"column":84,"offset":4228},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":4145},"end":{"line":102,"column":84,"offset":4228},"indent":[]}},{"type":"code","lang":"text","meta":null,"value":"Invalid credentials.","position":{"start":{"line":104,"column":1,"offset":4230},"end":{"line":106,"column":4,"offset":4262},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Endpoints","position":{"start":{"line":108,"column":5,"offset":4268},"end":{"line":108,"column":14,"offset":4277},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":4264},"end":{"line":108,"column":14,"offset":4277},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"All endpoints are prefixed with api/v","position":{"start":{"line":110,"column":1,"offset":4279},"end":{"line":110,"column":38,"offset":4316},"indent":[]}},{"type":"linkReference","identifier":"version","label":"version","referenceType":"shortcut","children":[{"type":"text","value":"version","position":{"start":{"line":110,"column":39,"offset":4317},"end":{"line":110,"column":46,"offset":4324},"indent":[]}}],"position":{"start":{"line":110,"column":38,"offset":4316},"end":{"line":110,"column":47,"offset":4325},"indent":[]}},{"type":"text","value":"/, in which the last part defines the API version number. Below you will find all the available endpoints with there signature and response. Note that when you call an endpoint which doesn't exists, the web will throw an 404.","position":{"start":{"line":110,"column":47,"offset":4325},"end":{"line":110,"column":272,"offset":4550},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":4279},"end":{"line":110,"column":272,"offset":4550},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n\t\"error\": \"API method does not exists\"\n}","position":{"start":{"line":112,"column":1,"offset":4552},"end":{"line":116,"column":4,"offset":4606},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Version 1","position":{"start":{"line":118,"column":5,"offset":4612},"end":{"line":118,"column":14,"offset":4621},"indent":[]}}],"position":{"start":{"line":118,"column":1,"offset":4608},"end":{"line":118,"column":14,"offset":4621},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Below you'll find a list of all API methods which are available for version 1.","position":{"start":{"line":120,"column":1,"offset":4623},"end":{"line":120,"column":79,"offset":4701},"indent":[]}}],"position":{"start":{"line":120,"column":1,"offset":4623},"end":{"line":120,"column":79,"offset":4701},"indent":[]}},{"type":"paragraph","children":[{"type":"inlineCode","value":"GET api/v1/name","position":{"start":{"line":122,"column":1,"offset":4703},"end":{"line":122,"column":18,"offset":4720},"indent":[]}}],"position":{"start":{"line":122,"column":1,"offset":4703},"end":{"line":122,"column":18,"offset":4720},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Description","position":{"start":{"line":124,"column":3,"offset":4724},"end":{"line":124,"column":14,"offset":4735},"indent":[]}}],"position":{"start":{"line":124,"column":1,"offset":4722},"end":{"line":124,"column":16,"offset":4737},"indent":[]}}],"position":{"start":{"line":124,"column":1,"offset":4722},"end":{"line":124,"column":16,"offset":4737},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Retrieve the name of your instance.","position":{"start":{"line":126,"column":1,"offset":4739},"end":{"line":126,"column":36,"offset":4774},"indent":[]}}],"position":{"start":{"line":126,"column":1,"offset":4739},"end":{"line":126,"column":36,"offset":4774},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Response","position":{"start":{"line":128,"column":3,"offset":4778},"end":{"line":128,"column":11,"offset":4786},"indent":[]}}],"position":{"start":{"line":128,"column":1,"offset":4776},"end":{"line":128,"column":13,"offset":4788},"indent":[]}}],"position":{"start":{"line":128,"column":1,"offset":4776},"end":{"line":128,"column":13,"offset":4788},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n\t\"name\": \"frontdoor\"\n}","position":{"start":{"line":129,"column":1,"offset":4789},"end":{"line":133,"column":4,"offset":4825},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"inlineCode","value":"PUT api/v1/name","position":{"start":{"line":135,"column":1,"offset":4827},"end":{"line":135,"column":18,"offset":4844},"indent":[]}}],"position":{"start":{"line":135,"column":1,"offset":4827},"end":{"line":135,"column":18,"offset":4844},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Description","position":{"start":{"line":137,"column":3,"offset":4848},"end":{"line":137,"column":14,"offset":4859},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":4846},"end":{"line":137,"column":16,"offset":4861},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":4846},"end":{"line":137,"column":16,"offset":4861},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Change the name of your instance.","position":{"start":{"line":139,"column":1,"offset":4863},"end":{"line":139,"column":34,"offset":4896},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":4863},"end":{"line":139,"column":34,"offset":4896},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Payload","position":{"start":{"line":141,"column":3,"offset":4900},"end":{"line":141,"column":10,"offset":4907},"indent":[]}}],"position":{"start":{"line":141,"column":1,"offset":4898},"end":{"line":141,"column":12,"offset":4909},"indent":[]}}],"position":{"start":{"line":141,"column":1,"offset":4898},"end":{"line":141,"column":12,"offset":4909},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n\t\"name\": \"frontdoor-changed\"\n}","position":{"start":{"line":142,"column":1,"offset":4910},"end":{"line":146,"column":4,"offset":4954},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Response","position":{"start":{"line":148,"column":3,"offset":4958},"end":{"line":148,"column":11,"offset":4966},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":4956},"end":{"line":148,"column":13,"offset":4968},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":4956},"end":{"line":148,"column":13,"offset":4968},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n\t\"name\": \"frontdoor-changed\"\n}","position":{"start":{"line":149,"column":1,"offset":4969},"end":{"line":153,"column":4,"offset":5013},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"inlineCode","value":"GET api/v1/images/latest_sequence","position":{"start":{"line":155,"column":1,"offset":5015},"end":{"line":155,"column":36,"offset":5050},"indent":[]}}],"position":{"start":{"line":155,"column":1,"offset":5015},"end":{"line":155,"column":36,"offset":5050},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Description","position":{"start":{"line":157,"column":3,"offset":5054},"end":{"line":157,"column":14,"offset":5065},"indent":[]}}],"position":{"start":{"line":157,"column":1,"offset":5052},"end":{"line":157,"column":16,"offset":5067},"indent":[]}}],"position":{"start":{"line":157,"column":1,"offset":5052},"end":{"line":157,"column":16,"offset":5067},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Retrieve the latest sequence detected.","position":{"start":{"line":159,"column":1,"offset":5069},"end":{"line":159,"column":39,"offset":5107},"indent":[]}}],"position":{"start":{"line":159,"column":1,"offset":5069},"end":{"line":159,"column":39,"offset":5107},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Response","position":{"start":{"line":161,"column":3,"offset":5111},"end":{"line":161,"column":11,"offset":5119},"indent":[]}}],"position":{"start":{"line":161,"column":1,"offset":5109},"end":{"line":161,"column":13,"offset":5121},"indent":[]}}],"position":{"start":{"line":161,"column":1,"offset":5109},"end":{"line":161,"column":13,"offset":5121},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"[\n {\n time: \"10:59:57\",\n src: \"https://demo.kerberos.io/capture/1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\",\n local_src: \"/var/www/web/public/capture/1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\",\n metadata: {\n key: \"1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\",\n user: \"1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\",\n timestamp: 1501491597,\n microseconds: \"6-310145\",\n instanceName: \"frontdoor\",\n regionCoordinates: \"722-691-873-926\",\n numberOfChanges: \"703\",\n token: \"511\"\n },\n type: \"video\"\n }\n]","position":{"start":{"line":162,"column":1,"offset":5122},"end":{"line":181,"column":4,"offset":5823},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"inlineCode","value":"GET api/v1/condition/enabled","position":{"start":{"line":183,"column":1,"offset":5825},"end":{"line":183,"column":31,"offset":5855},"indent":[]}}],"position":{"start":{"line":183,"column":1,"offset":5825},"end":{"line":183,"column":31,"offset":5855},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Description","position":{"start":{"line":185,"column":3,"offset":5859},"end":{"line":185,"column":14,"offset":5870},"indent":[]}}],"position":{"start":{"line":185,"column":1,"offset":5857},"end":{"line":185,"column":16,"offset":5872},"indent":[]}}],"position":{"start":{"line":185,"column":1,"offset":5857},"end":{"line":185,"column":16,"offset":5872},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Check if enabled or disabled.","position":{"start":{"line":187,"column":1,"offset":5874},"end":{"line":187,"column":30,"offset":5903},"indent":[]}}],"position":{"start":{"line":187,"column":1,"offset":5874},"end":{"line":187,"column":30,"offset":5903},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Response","position":{"start":{"line":189,"column":3,"offset":5907},"end":{"line":189,"column":11,"offset":5915},"indent":[]}}],"position":{"start":{"line":189,"column":1,"offset":5905},"end":{"line":189,"column":13,"offset":5917},"indent":[]}}],"position":{"start":{"line":189,"column":1,"offset":5905},"end":{"line":189,"column":13,"offset":5917},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n \t\"active\": \"true\",\n \t\"delay\": \"5000\"\n}","position":{"start":{"line":190,"column":1,"offset":5918},"end":{"line":195,"column":4,"offset":5971},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"inlineCode","value":"PUT api/v1/condition/enabled","position":{"start":{"line":197,"column":1,"offset":5973},"end":{"line":197,"column":31,"offset":6003},"indent":[]}}],"position":{"start":{"line":197,"column":1,"offset":5973},"end":{"line":197,"column":31,"offset":6003},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Description","position":{"start":{"line":199,"column":3,"offset":6007},"end":{"line":199,"column":14,"offset":6018},"indent":[]}}],"position":{"start":{"line":199,"column":1,"offset":6005},"end":{"line":199,"column":16,"offset":6020},"indent":[]}}],"position":{"start":{"line":199,"column":1,"offset":6005},"end":{"line":199,"column":16,"offset":6020},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Activate or disable the system.","position":{"start":{"line":201,"column":1,"offset":6022},"end":{"line":201,"column":32,"offset":6053},"indent":[]}}],"position":{"start":{"line":201,"column":1,"offset":6022},"end":{"line":201,"column":32,"offset":6053},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Payload","position":{"start":{"line":203,"column":3,"offset":6057},"end":{"line":203,"column":10,"offset":6064},"indent":[]}}],"position":{"start":{"line":203,"column":1,"offset":6055},"end":{"line":203,"column":12,"offset":6066},"indent":[]}}],"position":{"start":{"line":203,"column":1,"offset":6055},"end":{"line":203,"column":12,"offset":6066},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n \t\"active\": \"false\"\n}","position":{"start":{"line":204,"column":1,"offset":6067},"end":{"line":208,"column":4,"offset":6102},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Response","position":{"start":{"line":210,"column":3,"offset":6106},"end":{"line":210,"column":11,"offset":6114},"indent":[]}}],"position":{"start":{"line":210,"column":1,"offset":6104},"end":{"line":210,"column":13,"offset":6116},"indent":[]}}],"position":{"start":{"line":210,"column":1,"offset":6104},"end":{"line":210,"column":13,"offset":6116},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n \t\"active\": \"false\",\n \t\"delay\": \"5000\"\n}","position":{"start":{"line":211,"column":1,"offset":6117},"end":{"line":216,"column":4,"offset":6171},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"inlineCode","value":"GET api/v1/system/health","position":{"start":{"line":218,"column":1,"offset":6173},"end":{"line":218,"column":27,"offset":6199},"indent":[]}}],"position":{"start":{"line":218,"column":1,"offset":6173},"end":{"line":218,"column":27,"offset":6199},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Description","position":{"start":{"line":220,"column":3,"offset":6203},"end":{"line":220,"column":14,"offset":6214},"indent":[]}}],"position":{"start":{"line":220,"column":1,"offset":6201},"end":{"line":220,"column":16,"offset":6216},"indent":[]}}],"position":{"start":{"line":220,"column":1,"offset":6201},"end":{"line":220,"column":16,"offset":6216},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Check if the machinery is running (the stream is connected).","position":{"start":{"line":222,"column":1,"offset":6218},"end":{"line":222,"column":61,"offset":6278},"indent":[]}}],"position":{"start":{"line":222,"column":1,"offset":6218},"end":{"line":222,"column":61,"offset":6278},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Response","position":{"start":{"line":224,"column":3,"offset":6282},"end":{"line":224,"column":11,"offset":6290},"indent":[]}}],"position":{"start":{"line":224,"column":1,"offset":6280},"end":{"line":224,"column":13,"offset":6292},"indent":[]}}],"position":{"start":{"line":224,"column":1,"offset":6280},"end":{"line":224,"column":13,"offset":6292},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n \t\"status\": \"false\"\n}","position":{"start":{"line":225,"column":1,"offset":6293},"end":{"line":229,"column":4,"offset":6328},"indent":[1,1,1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":232,"column":1,"offset":6331},"end":{"line":232,"column":31,"offset":6361},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":232,"column":31,"offset":6361}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Web interface`}

\n

{`The web is responsible for the visualization. It's a GUI which helps the user to find activity at a specific period, configure the machinery, view a live stream, see system information and much more.`}

\n

{`It's written in PHP using the extremely popular PHP Framework Laravel, and Javascript using the client-side framework BackboneJS. We will discuss the different pages and functionality briefly. Please check out `}{`the demo environment`}{` if you want to see a real life example.`}

\n

{`Overview`}

\n

{`We will shortly discuss the different pages that make up the web interface of Kerberos Open Source.`}

\n

{`Dashboard`}

\n

{`The landing page of the web is the dashboard. On the dashboard a user will see some statistics: activity per hour, activity per day, a live stream, the latest activity and a heatmap.`}

\n

\"web

\n

{`Overview`}

\n

{`When selecting a specific day, you'll will get a timeline and overview. By using the timeline you can navigate through a day; the timeline highlights the amount of activity, from gray to red.`}

\n

\"web

\n

{`Settings`}

\n

{`The settings page allows you to configure the machinery. You can define the type of camera, post-processes, conditions and much more; it's highly configurable.`}

\n

\"web

\n

{`System`}

\n

{`The system page allows you to monitor the system. On this page you'll get an overview of the system specifications (CPU, Memory, Network, etc). Several actions are available: you can download system information (for debugging purposes) and download or remove your images.`}

\n

\"web

\n

{`Project structure`}

\n

{`The web interface is using the Laravel framework (version 5.4). There is a lot of documentation related to Laravel, please review `}{`their documentation website here`}{`. In a nutshell this is how the web is organised.`}

\n

{`Back-end`}

\n
    \n
  • {`config/app.php - general application settings.`}
    • \n
  • {`config/kerberos.php - this file contains web specific parameters; the user credentials to sign in, etc.`}
    • \n
  • {`app/Http/Controllers - MVC controllers`}
    • \n
  • {`app/Http/Repositories -repositories are injected into the controller.`}
    • \n
  • {`app/Providers/AppServiceProvider.php - bind repositories to a specific interface - dependency injection.`}
    • \n
  • {`routes/api.php - contains all the URI endpoints for Ajax calls.`}
    • \n
  • {`routes/web.php - url routing for pages.`}
    • \n
\n

{`Front-end`}

\n
    \n
  • {`public/css/less - LESS is used for the CSS.`}
    • \n
  • {`public/js/app - BackboneJS and RequireJS is used for building modular JS classes.`}
    • \n
  • {`public/js/mustache - Mustache is used for the client-side view rendering.`}
    • \n
  • {`public/js/vendor - This is where the bower extensions are installed.`}
    • \n
  • {`public/capture - A directory where images are written to by default.`}
    • \n
  • {`public/bower.json - The bower extensions used in the web repository.`}
    • \n
  • {`public/Gruntfile.js - We are using Grunt for our task manager.`}
    • \n
\n

{`API`}

\n

{`If you want to integrate the Kerberos agent with your own application, you're at the right place! The web interface comes with a RESTfull API, that allows you to retrieve and modify information from the Kerberos agent.`}

\n
    \n
  • {`Disable the machinery`}
    • \n
  • {`Health check`}
    • \n
  • {`Enable or disable output devices`}
    • \n
  • {`etc.`}
    • \n
\n

{`Authentication`}

\n

{`To use the RESTfull API of your Kerberos agent you need to define an Authorization header with each request. We use Basic Authentication to secure the different endpoints.`}

\n 
{`\"Authorization\"`}{`: `}{`\"Basic root:root\"`}
\n

{`An example with Python looks like this.`}

\n 
{`import`}{` requests`}{`\n`}{`import`}{` json`}{`\n`}{`import`}{` base64`}{`\n`}{`url = `}{`\"http://ip-of-pi/api/v1/condition/enabled\"`}{`\n`}{`username = `}{`\"user\"`}{`\n`}{`password = `}{`\"passw\"`}{`\n`}{`basicAuth = base64.b64encode(`}{`'`}{`%s`}{`:`}{`%s`}{`'`}{` % (username, password))`}{`\n`}{`headers = {`}{`\"Authorization\"`}{`: `}{`\"Basic \"`}{` + basicAuth, `}{`\"Content-Type\"`}{`: `}{`\"application/json\"`}{`}`}{`\n`}{`data = `}{`'{\"active\": \"true\"}'`}{`\n`}{`#Call REST API`}{`\n`}{`response = requests.put(url, `}{`data`}{`=data, `}{`headers`}{`=headers)`}{`\n`}{`print`}{`(response.text)`}
\n

{`If you're using the wrong credentials, the web will return following error message.`}

\n 
{`Invalid credentials.`}
\n

{`Endpoints`}

\n

{`All endpoints are prefixed with api/v`}{`[version]`}{`/, in which the last part defines the API version number. Below you will find all the available endpoints with there signature and response. Note that when you call an endpoint which doesn't exists, the web will throw an 404.`}

\n 
{`{`}{`\n`}{`\t`}{`\"error\"`}{`: `}{`\"API method does not exists\"`}{`\n`}{`}`}
\n

{`Version 1`}

\n

{`Below you'll find a list of all API methods which are available for version 1.`}

\n

{`GET api/v1/name`}

\n

{`Description`}

\n

{`Retrieve the name of your instance.`}

\n

{`Response`}

\n 
{`{`}{`\n`}{`\t`}{`\"name\"`}{`: `}{`\"frontdoor\"`}{`\n`}{`}`}
\n

{`PUT api/v1/name`}

\n

{`Description`}

\n

{`Change the name of your instance.`}

\n

{`Payload`}

\n 
{`{`}{`\n`}{`\t`}{`\"name\"`}{`: `}{`\"frontdoor-changed\"`}{`\n`}{`}`}
\n

{`Response`}

\n 
{`{`}{`\n`}{`\t`}{`\"name\"`}{`: `}{`\"frontdoor-changed\"`}{`\n`}{`}`}
\n

{`GET api/v1/images/latest_sequence`}

\n

{`Description`}

\n

{`Retrieve the latest sequence detected.`}

\n

{`Response`}

\n 
{`[`}{`\n`}{`    {`}{`\n`}{`        `}{`time`}{`: `}{`\"10:59:57\"`}{`,`}{`\n`}{`        `}{`src`}{`: `}{`\"https://demo.kerberos.io/capture/1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\"`}{`,`}{`\n`}{`        `}{`local_src`}{`: `}{`\"/var/www/web/public/capture/1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\"`}{`,`}{`\n`}{`        `}{`metadata`}{`: {`}{`\n`}{`            `}{`key`}{`: `}{`\"1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\"`}{`,`}{`\n`}{`            `}{`user`}{`: `}{`\"1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\"`}{`,`}{`\n`}{`            `}{`timestamp`}{`: `}{`1501491597`}{`,`}{`\n`}{`            `}{`microseconds`}{`: `}{`\"6-310145\"`}{`,`}{`\n`}{`            `}{`instanceName`}{`: `}{`\"frontdoor\"`}{`,`}{`\n`}{`            `}{`regionCoordinates`}{`: `}{`\"722-691-873-926\"`}{`,`}{`\n`}{`            `}{`numberOfChanges`}{`: `}{`\"703\"`}{`,`}{`\n`}{`            `}{`token`}{`: `}{`\"511\"`}{`\n`}{`        },`}{`\n`}{`        `}{`type`}{`: `}{`\"video\"`}{`\n`}{`    }`}{`\n`}{`]`}
\n

{`GET api/v1/condition/enabled`}

\n

{`Description`}

\n

{`Check if enabled or disabled.`}

\n

{`Response`}

\n 
{`{`}{`\n`}{` \t`}{`\"active\"`}{`: `}{`\"true\"`}{`,`}{`\n`}{` \t`}{`\"delay\"`}{`: `}{`\"5000\"`}{`\n`}{`}`}
\n

{`PUT api/v1/condition/enabled`}

\n

{`Description`}

\n

{`Activate or disable the system.`}

\n

{`Payload`}

\n 
{`{`}{`\n`}{` \t`}{`\"active\"`}{`: `}{`\"false\"`}{`\n`}{`}`}
\n

{`Response`}

\n 
{`{`}{`\n`}{` \t`}{`\"active\"`}{`: `}{`\"false\"`}{`,`}{`\n`}{` \t`}{`\"delay\"`}{`: `}{`\"5000\"`}{`\n`}{`}`}
\n

{`GET api/v1/system/health`}

\n

{`Description`}

\n

{`Check if the machinery is running (the stream is connected).`}

\n

{`Response`}

\n 
{`{`}{`\n`}{` \t`}{`\"status\"`}{`: `}{`\"false\"`}{`\n`}{`}`}
\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750188000,"key":"gatsby-plugin-mdx-entire-payload-e2342ab6842f8987168b840f99e28360-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Web interface","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":16,"offset":174},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":16,"offset":174},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The web is responsible for the visualization. It's a GUI which helps the user to find activity at a specific period, configure the machinery, view a live stream, see system information and much more.","position":{"start":{"line":10,"column":1,"offset":176},"end":{"line":10,"column":200,"offset":375},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":176},"end":{"line":10,"column":200,"offset":375},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"It's written in PHP using the extremely popular PHP Framework Laravel, and Javascript using the client-side framework BackboneJS. We will discuss the different pages and functionality briefly. Please check out ","position":{"start":{"line":12,"column":1,"offset":377},"end":{"line":12,"column":211,"offset":587},"indent":[]}},{"type":"link","title":null,"url":"https://demo.kerberos.io","children":[{"type":"text","value":"the demo environment","position":{"start":{"line":12,"column":212,"offset":588},"end":{"line":12,"column":232,"offset":608},"indent":[]}}],"position":{"start":{"line":12,"column":211,"offset":587},"end":{"line":12,"column":259,"offset":635},"indent":[]}},{"type":"text","value":" if you want to see a real life example.","position":{"start":{"line":12,"column":259,"offset":635},"end":{"line":12,"column":299,"offset":675},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":377},"end":{"line":12,"column":299,"offset":675},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Overview","position":{"start":{"line":14,"column":4,"offset":680},"end":{"line":14,"column":12,"offset":688},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":677},"end":{"line":14,"column":12,"offset":688},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"We will shortly discuss the different pages that make up the web interface of Kerberos Open Source.","position":{"start":{"line":16,"column":1,"offset":690},"end":{"line":16,"column":100,"offset":789},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":690},"end":{"line":16,"column":100,"offset":789},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Dashboard","position":{"start":{"line":18,"column":5,"offset":795},"end":{"line":18,"column":14,"offset":804},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":791},"end":{"line":18,"column":14,"offset":804},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The landing page of the web is the dashboard. On the dashboard a user will see some statistics: activity per hour, activity per day, a live stream, the latest activity and a heatmap.","position":{"start":{"line":20,"column":1,"offset":806},"end":{"line":20,"column":183,"offset":988},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":806},"end":{"line":20,"column":183,"offset":988},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/web/dashboard.png","alt":"web dashboard","position":{"start":{"line":22,"column":1,"offset":990},"end":{"line":22,"column":56,"offset":1045},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":990},"end":{"line":22,"column":56,"offset":1045},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Overview","position":{"start":{"line":24,"column":5,"offset":1051},"end":{"line":24,"column":13,"offset":1059},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1047},"end":{"line":24,"column":13,"offset":1059},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When selecting a specific day, you'll will get a timeline and overview. By using the timeline you can navigate through a day; the timeline highlights the amount of activity, from gray to red.","position":{"start":{"line":26,"column":1,"offset":1061},"end":{"line":26,"column":192,"offset":1252},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1061},"end":{"line":26,"column":192,"offset":1252},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/web/overview.png","alt":"web overview","position":{"start":{"line":28,"column":1,"offset":1254},"end":{"line":28,"column":54,"offset":1307},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1254},"end":{"line":28,"column":54,"offset":1307},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Settings","position":{"start":{"line":30,"column":5,"offset":1313},"end":{"line":30,"column":13,"offset":1321},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1309},"end":{"line":30,"column":13,"offset":1321},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The settings page allows you to configure the machinery. You can define the type of camera, post-processes, conditions and much more; it's highly configurable.","position":{"start":{"line":32,"column":1,"offset":1323},"end":{"line":32,"column":160,"offset":1482},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1323},"end":{"line":32,"column":160,"offset":1482},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/web/settings.png","alt":"web settings","position":{"start":{"line":36,"column":1,"offset":1486},"end":{"line":36,"column":54,"offset":1539},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":1486},"end":{"line":36,"column":54,"offset":1539},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"System","position":{"start":{"line":38,"column":5,"offset":1545},"end":{"line":38,"column":11,"offset":1551},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1541},"end":{"line":38,"column":11,"offset":1551},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The system page allows you to monitor the system. On this page you'll get an overview of the system specifications (CPU, Memory, Network, etc). Several actions are available: you can download system information (for debugging purposes) and download or remove your images.","position":{"start":{"line":40,"column":1,"offset":1553},"end":{"line":40,"column":272,"offset":1824},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1553},"end":{"line":40,"column":272,"offset":1824},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/web/system.png","alt":"web system","position":{"start":{"line":42,"column":1,"offset":1826},"end":{"line":42,"column":50,"offset":1875},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":1826},"end":{"line":42,"column":50,"offset":1875},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Project structure","position":{"start":{"line":44,"column":4,"offset":1880},"end":{"line":44,"column":21,"offset":1897},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":1877},"end":{"line":44,"column":21,"offset":1897},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The web interface is using the Laravel framework (version 5.4). There is a lot of documentation related to Laravel, please review ","position":{"start":{"line":46,"column":1,"offset":1899},"end":{"line":46,"column":131,"offset":2029},"indent":[]}},{"type":"link","title":null,"url":"https://laravel.com/docs/5.4","children":[{"type":"text","value":"their documentation website here","position":{"start":{"line":46,"column":132,"offset":2030},"end":{"line":46,"column":164,"offset":2062},"indent":[]}}],"position":{"start":{"line":46,"column":131,"offset":2029},"end":{"line":46,"column":195,"offset":2093},"indent":[]}},{"type":"text","value":". In a nutshell this is how the web is organised.","position":{"start":{"line":46,"column":195,"offset":2093},"end":{"line":46,"column":244,"offset":2142},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":1899},"end":{"line":46,"column":244,"offset":2142},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Back-end","position":{"start":{"line":48,"column":5,"offset":2148},"end":{"line":48,"column":13,"offset":2156},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":2144},"end":{"line":48,"column":13,"offset":2156},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"config/app.php - general application settings.","position":{"start":{"line":50,"column":3,"offset":2160},"end":{"line":50,"column":49,"offset":2206},"indent":[]}}],"position":{"start":{"line":50,"column":3,"offset":2160},"end":{"line":50,"column":49,"offset":2206},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2158},"end":{"line":50,"column":49,"offset":2206},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"config/kerberos.php - this file contains web specific parameters; the user credentials to sign in, etc.","position":{"start":{"line":51,"column":3,"offset":2209},"end":{"line":51,"column":106,"offset":2312},"indent":[]}}],"position":{"start":{"line":51,"column":3,"offset":2209},"end":{"line":51,"column":106,"offset":2312},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2207},"end":{"line":51,"column":106,"offset":2312},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"app/Http/Controllers - MVC controllers","position":{"start":{"line":52,"column":3,"offset":2315},"end":{"line":52,"column":41,"offset":2353},"indent":[]}}],"position":{"start":{"line":52,"column":3,"offset":2315},"end":{"line":52,"column":41,"offset":2353},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":2313},"end":{"line":52,"column":41,"offset":2353},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"app/Http/Repositories -repositories are injected into the controller.","position":{"start":{"line":53,"column":3,"offset":2356},"end":{"line":53,"column":72,"offset":2425},"indent":[]}}],"position":{"start":{"line":53,"column":3,"offset":2356},"end":{"line":53,"column":72,"offset":2425},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2354},"end":{"line":53,"column":72,"offset":2425},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"app/Providers/AppServiceProvider.php - bind repositories to a specific interface - dependency injection.","position":{"start":{"line":54,"column":3,"offset":2428},"end":{"line":54,"column":107,"offset":2532},"indent":[]}}],"position":{"start":{"line":54,"column":3,"offset":2428},"end":{"line":54,"column":107,"offset":2532},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":2426},"end":{"line":54,"column":107,"offset":2532},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"routes/api.php - contains all the URI endpoints for Ajax calls.","position":{"start":{"line":55,"column":3,"offset":2535},"end":{"line":55,"column":66,"offset":2598},"indent":[]}}],"position":{"start":{"line":55,"column":3,"offset":2535},"end":{"line":55,"column":66,"offset":2598},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2533},"end":{"line":55,"column":66,"offset":2598},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"routes/web.php - url routing for pages.","position":{"start":{"line":56,"column":3,"offset":2601},"end":{"line":56,"column":42,"offset":2640},"indent":[]}}],"position":{"start":{"line":56,"column":3,"offset":2601},"end":{"line":56,"column":42,"offset":2640},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":2599},"end":{"line":56,"column":42,"offset":2640},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2158},"end":{"line":56,"column":42,"offset":2640},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Front-end","position":{"start":{"line":58,"column":5,"offset":2646},"end":{"line":58,"column":14,"offset":2655},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":2642},"end":{"line":58,"column":14,"offset":2655},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/css/less - LESS is used for the CSS.","position":{"start":{"line":60,"column":3,"offset":2659},"end":{"line":60,"column":46,"offset":2702},"indent":[]}}],"position":{"start":{"line":60,"column":3,"offset":2659},"end":{"line":60,"column":46,"offset":2702},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":2657},"end":{"line":60,"column":46,"offset":2702},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/js/app - BackboneJS and RequireJS is used for building modular JS classes.","position":{"start":{"line":61,"column":3,"offset":2705},"end":{"line":61,"column":84,"offset":2786},"indent":[]}}],"position":{"start":{"line":61,"column":3,"offset":2705},"end":{"line":61,"column":84,"offset":2786},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":2703},"end":{"line":61,"column":84,"offset":2786},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/js/mustache - Mustache is used for the client-side view rendering.","position":{"start":{"line":62,"column":3,"offset":2789},"end":{"line":62,"column":76,"offset":2862},"indent":[]}}],"position":{"start":{"line":62,"column":3,"offset":2789},"end":{"line":62,"column":76,"offset":2862},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":2787},"end":{"line":62,"column":76,"offset":2862},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/js/vendor - This is where the bower extensions are installed.","position":{"start":{"line":63,"column":3,"offset":2865},"end":{"line":63,"column":71,"offset":2933},"indent":[]}}],"position":{"start":{"line":63,"column":3,"offset":2865},"end":{"line":63,"column":71,"offset":2933},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":2863},"end":{"line":63,"column":71,"offset":2933},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/capture - A directory where images are written to by default.","position":{"start":{"line":64,"column":3,"offset":2936},"end":{"line":64,"column":71,"offset":3004},"indent":[]}}],"position":{"start":{"line":64,"column":3,"offset":2936},"end":{"line":64,"column":71,"offset":3004},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":2934},"end":{"line":64,"column":71,"offset":3004},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/bower.json - The bower extensions used in the web repository.","position":{"start":{"line":65,"column":3,"offset":3007},"end":{"line":65,"column":71,"offset":3075},"indent":[]}}],"position":{"start":{"line":65,"column":3,"offset":3007},"end":{"line":65,"column":71,"offset":3075},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":3005},"end":{"line":65,"column":71,"offset":3075},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"public/Gruntfile.js - We are using Grunt for our task manager.","position":{"start":{"line":66,"column":3,"offset":3078},"end":{"line":66,"column":65,"offset":3140},"indent":[]}}],"position":{"start":{"line":66,"column":3,"offset":3078},"end":{"line":66,"column":65,"offset":3140},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":3076},"end":{"line":66,"column":65,"offset":3140},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":2657},"end":{"line":66,"column":65,"offset":3140},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"API","position":{"start":{"line":68,"column":4,"offset":3145},"end":{"line":68,"column":7,"offset":3148},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":3142},"end":{"line":68,"column":7,"offset":3148},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to integrate the Kerberos agent with your own application, you're at the right place! The web interface comes with a RESTfull API, that allows you to retrieve and modify information from the Kerberos agent.","position":{"start":{"line":70,"column":1,"offset":3150},"end":{"line":70,"column":219,"offset":3368},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":3150},"end":{"line":70,"column":219,"offset":3368},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Disable the machinery","position":{"start":{"line":72,"column":3,"offset":3372},"end":{"line":72,"column":24,"offset":3393},"indent":[]}}],"position":{"start":{"line":72,"column":3,"offset":3372},"end":{"line":72,"column":24,"offset":3393},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3370},"end":{"line":72,"column":24,"offset":3393},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Health check","position":{"start":{"line":73,"column":3,"offset":3396},"end":{"line":73,"column":15,"offset":3408},"indent":[]}}],"position":{"start":{"line":73,"column":3,"offset":3396},"end":{"line":73,"column":15,"offset":3408},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":3394},"end":{"line":73,"column":15,"offset":3408},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Enable or disable output devices","position":{"start":{"line":74,"column":3,"offset":3411},"end":{"line":74,"column":35,"offset":3443},"indent":[]}}],"position":{"start":{"line":74,"column":3,"offset":3411},"end":{"line":74,"column":35,"offset":3443},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":3409},"end":{"line":74,"column":35,"offset":3443},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"etc.","position":{"start":{"line":75,"column":3,"offset":3446},"end":{"line":75,"column":7,"offset":3450},"indent":[]}}],"position":{"start":{"line":75,"column":3,"offset":3446},"end":{"line":75,"column":7,"offset":3450},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3444},"end":{"line":75,"column":7,"offset":3450},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3370},"end":{"line":75,"column":7,"offset":3450},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Authentication","position":{"start":{"line":77,"column":5,"offset":3456},"end":{"line":77,"column":19,"offset":3470},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3452},"end":{"line":77,"column":19,"offset":3470},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To use the RESTfull API of your Kerberos agent you need to define an Authorization header with each request. We use Basic Authentication to secure the different endpoints.","position":{"start":{"line":79,"column":1,"offset":3472},"end":{"line":79,"column":172,"offset":3643},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3472},"end":{"line":79,"column":172,"offset":3643},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"\"Authorization\": \"Basic root:root\"","position":{"start":{"line":81,"column":1,"offset":3645},"end":{"line":83,"column":4,"offset":3691},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"An example with Python looks like this.","position":{"start":{"line":85,"column":1,"offset":3693},"end":{"line":85,"column":40,"offset":3732},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":3693},"end":{"line":85,"column":40,"offset":3732},"indent":[]}},{"type":"code","lang":"python","meta":null,"value":"import requests\nimport json\nimport base64\nurl = \"http://ip-of-pi/api/v1/condition/enabled\"\nusername = \"user\"\npassword = \"passw\"\nbasicAuth = base64.b64encode('%s:%s' % (username, password))\nheaders = {\"Authorization\": \"Basic \" + basicAuth, \"Content-Type\": \"application/json\"}\ndata = '{\"active\": \"true\"}'\n#Call REST API\nresponse = requests.put(url, data=data, headers=headers)\nprint(response.text)","position":{"start":{"line":87,"column":1,"offset":3734},"end":{"line":100,"column":4,"offset":4143},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"If you're using the wrong credentials, the web will return following error message.","position":{"start":{"line":102,"column":1,"offset":4145},"end":{"line":102,"column":84,"offset":4228},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":4145},"end":{"line":102,"column":84,"offset":4228},"indent":[]}},{"type":"code","lang":"text","meta":null,"value":"Invalid credentials.","position":{"start":{"line":104,"column":1,"offset":4230},"end":{"line":106,"column":4,"offset":4262},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Endpoints","position":{"start":{"line":108,"column":5,"offset":4268},"end":{"line":108,"column":14,"offset":4277},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":4264},"end":{"line":108,"column":14,"offset":4277},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"All endpoints are prefixed with api/v","position":{"start":{"line":110,"column":1,"offset":4279},"end":{"line":110,"column":38,"offset":4316},"indent":[]}},{"type":"linkReference","identifier":"version","label":"version","referenceType":"shortcut","children":[{"type":"text","value":"version","position":{"start":{"line":110,"column":39,"offset":4317},"end":{"line":110,"column":46,"offset":4324},"indent":[]}}],"position":{"start":{"line":110,"column":38,"offset":4316},"end":{"line":110,"column":47,"offset":4325},"indent":[]}},{"type":"text","value":"/, in which the last part defines the API version number. Below you will find all the available endpoints with there signature and response. Note that when you call an endpoint which doesn't exists, the web will throw an 404.","position":{"start":{"line":110,"column":47,"offset":4325},"end":{"line":110,"column":272,"offset":4550},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":4279},"end":{"line":110,"column":272,"offset":4550},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n\t\"error\": \"API method does not exists\"\n}","position":{"start":{"line":112,"column":1,"offset":4552},"end":{"line":116,"column":4,"offset":4606},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Version 1","position":{"start":{"line":118,"column":5,"offset":4612},"end":{"line":118,"column":14,"offset":4621},"indent":[]}}],"position":{"start":{"line":118,"column":1,"offset":4608},"end":{"line":118,"column":14,"offset":4621},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Below you'll find a list of all API methods which are available for version 1.","position":{"start":{"line":120,"column":1,"offset":4623},"end":{"line":120,"column":79,"offset":4701},"indent":[]}}],"position":{"start":{"line":120,"column":1,"offset":4623},"end":{"line":120,"column":79,"offset":4701},"indent":[]}},{"type":"paragraph","children":[{"type":"inlineCode","value":"GET api/v1/name","position":{"start":{"line":122,"column":1,"offset":4703},"end":{"line":122,"column":18,"offset":4720},"indent":[]}}],"position":{"start":{"line":122,"column":1,"offset":4703},"end":{"line":122,"column":18,"offset":4720},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Description","position":{"start":{"line":124,"column":3,"offset":4724},"end":{"line":124,"column":14,"offset":4735},"indent":[]}}],"position":{"start":{"line":124,"column":1,"offset":4722},"end":{"line":124,"column":16,"offset":4737},"indent":[]}}],"position":{"start":{"line":124,"column":1,"offset":4722},"end":{"line":124,"column":16,"offset":4737},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Retrieve the name of your instance.","position":{"start":{"line":126,"column":1,"offset":4739},"end":{"line":126,"column":36,"offset":4774},"indent":[]}}],"position":{"start":{"line":126,"column":1,"offset":4739},"end":{"line":126,"column":36,"offset":4774},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Response","position":{"start":{"line":128,"column":3,"offset":4778},"end":{"line":128,"column":11,"offset":4786},"indent":[]}}],"position":{"start":{"line":128,"column":1,"offset":4776},"end":{"line":128,"column":13,"offset":4788},"indent":[]}}],"position":{"start":{"line":128,"column":1,"offset":4776},"end":{"line":128,"column":13,"offset":4788},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n\t\"name\": \"frontdoor\"\n}","position":{"start":{"line":129,"column":1,"offset":4789},"end":{"line":133,"column":4,"offset":4825},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"inlineCode","value":"PUT api/v1/name","position":{"start":{"line":135,"column":1,"offset":4827},"end":{"line":135,"column":18,"offset":4844},"indent":[]}}],"position":{"start":{"line":135,"column":1,"offset":4827},"end":{"line":135,"column":18,"offset":4844},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Description","position":{"start":{"line":137,"column":3,"offset":4848},"end":{"line":137,"column":14,"offset":4859},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":4846},"end":{"line":137,"column":16,"offset":4861},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":4846},"end":{"line":137,"column":16,"offset":4861},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Change the name of your instance.","position":{"start":{"line":139,"column":1,"offset":4863},"end":{"line":139,"column":34,"offset":4896},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":4863},"end":{"line":139,"column":34,"offset":4896},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Payload","position":{"start":{"line":141,"column":3,"offset":4900},"end":{"line":141,"column":10,"offset":4907},"indent":[]}}],"position":{"start":{"line":141,"column":1,"offset":4898},"end":{"line":141,"column":12,"offset":4909},"indent":[]}}],"position":{"start":{"line":141,"column":1,"offset":4898},"end":{"line":141,"column":12,"offset":4909},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n\t\"name\": \"frontdoor-changed\"\n}","position":{"start":{"line":142,"column":1,"offset":4910},"end":{"line":146,"column":4,"offset":4954},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Response","position":{"start":{"line":148,"column":3,"offset":4958},"end":{"line":148,"column":11,"offset":4966},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":4956},"end":{"line":148,"column":13,"offset":4968},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":4956},"end":{"line":148,"column":13,"offset":4968},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n\t\"name\": \"frontdoor-changed\"\n}","position":{"start":{"line":149,"column":1,"offset":4969},"end":{"line":153,"column":4,"offset":5013},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"inlineCode","value":"GET api/v1/images/latest_sequence","position":{"start":{"line":155,"column":1,"offset":5015},"end":{"line":155,"column":36,"offset":5050},"indent":[]}}],"position":{"start":{"line":155,"column":1,"offset":5015},"end":{"line":155,"column":36,"offset":5050},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Description","position":{"start":{"line":157,"column":3,"offset":5054},"end":{"line":157,"column":14,"offset":5065},"indent":[]}}],"position":{"start":{"line":157,"column":1,"offset":5052},"end":{"line":157,"column":16,"offset":5067},"indent":[]}}],"position":{"start":{"line":157,"column":1,"offset":5052},"end":{"line":157,"column":16,"offset":5067},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Retrieve the latest sequence detected.","position":{"start":{"line":159,"column":1,"offset":5069},"end":{"line":159,"column":39,"offset":5107},"indent":[]}}],"position":{"start":{"line":159,"column":1,"offset":5069},"end":{"line":159,"column":39,"offset":5107},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Response","position":{"start":{"line":161,"column":3,"offset":5111},"end":{"line":161,"column":11,"offset":5119},"indent":[]}}],"position":{"start":{"line":161,"column":1,"offset":5109},"end":{"line":161,"column":13,"offset":5121},"indent":[]}}],"position":{"start":{"line":161,"column":1,"offset":5109},"end":{"line":161,"column":13,"offset":5121},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"[\n {\n time: \"10:59:57\",\n src: \"https://demo.kerberos.io/capture/1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\",\n local_src: \"/var/www/web/public/capture/1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\",\n metadata: {\n key: \"1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\",\n user: \"1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\",\n timestamp: 1501491597,\n microseconds: \"6-310145\",\n instanceName: \"frontdoor\",\n regionCoordinates: \"722-691-873-926\",\n numberOfChanges: \"703\",\n token: \"511\"\n },\n type: \"video\"\n }\n]","position":{"start":{"line":162,"column":1,"offset":5122},"end":{"line":181,"column":4,"offset":5823},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"inlineCode","value":"GET api/v1/condition/enabled","position":{"start":{"line":183,"column":1,"offset":5825},"end":{"line":183,"column":31,"offset":5855},"indent":[]}}],"position":{"start":{"line":183,"column":1,"offset":5825},"end":{"line":183,"column":31,"offset":5855},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Description","position":{"start":{"line":185,"column":3,"offset":5859},"end":{"line":185,"column":14,"offset":5870},"indent":[]}}],"position":{"start":{"line":185,"column":1,"offset":5857},"end":{"line":185,"column":16,"offset":5872},"indent":[]}}],"position":{"start":{"line":185,"column":1,"offset":5857},"end":{"line":185,"column":16,"offset":5872},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Check if enabled or disabled.","position":{"start":{"line":187,"column":1,"offset":5874},"end":{"line":187,"column":30,"offset":5903},"indent":[]}}],"position":{"start":{"line":187,"column":1,"offset":5874},"end":{"line":187,"column":30,"offset":5903},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Response","position":{"start":{"line":189,"column":3,"offset":5907},"end":{"line":189,"column":11,"offset":5915},"indent":[]}}],"position":{"start":{"line":189,"column":1,"offset":5905},"end":{"line":189,"column":13,"offset":5917},"indent":[]}}],"position":{"start":{"line":189,"column":1,"offset":5905},"end":{"line":189,"column":13,"offset":5917},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n \t\"active\": \"true\",\n \t\"delay\": \"5000\"\n}","position":{"start":{"line":190,"column":1,"offset":5918},"end":{"line":195,"column":4,"offset":5971},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"inlineCode","value":"PUT api/v1/condition/enabled","position":{"start":{"line":197,"column":1,"offset":5973},"end":{"line":197,"column":31,"offset":6003},"indent":[]}}],"position":{"start":{"line":197,"column":1,"offset":5973},"end":{"line":197,"column":31,"offset":6003},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Description","position":{"start":{"line":199,"column":3,"offset":6007},"end":{"line":199,"column":14,"offset":6018},"indent":[]}}],"position":{"start":{"line":199,"column":1,"offset":6005},"end":{"line":199,"column":16,"offset":6020},"indent":[]}}],"position":{"start":{"line":199,"column":1,"offset":6005},"end":{"line":199,"column":16,"offset":6020},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Activate or disable the system.","position":{"start":{"line":201,"column":1,"offset":6022},"end":{"line":201,"column":32,"offset":6053},"indent":[]}}],"position":{"start":{"line":201,"column":1,"offset":6022},"end":{"line":201,"column":32,"offset":6053},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Payload","position":{"start":{"line":203,"column":3,"offset":6057},"end":{"line":203,"column":10,"offset":6064},"indent":[]}}],"position":{"start":{"line":203,"column":1,"offset":6055},"end":{"line":203,"column":12,"offset":6066},"indent":[]}}],"position":{"start":{"line":203,"column":1,"offset":6055},"end":{"line":203,"column":12,"offset":6066},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n \t\"active\": \"false\"\n}","position":{"start":{"line":204,"column":1,"offset":6067},"end":{"line":208,"column":4,"offset":6102},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Response","position":{"start":{"line":210,"column":3,"offset":6106},"end":{"line":210,"column":11,"offset":6114},"indent":[]}}],"position":{"start":{"line":210,"column":1,"offset":6104},"end":{"line":210,"column":13,"offset":6116},"indent":[]}}],"position":{"start":{"line":210,"column":1,"offset":6104},"end":{"line":210,"column":13,"offset":6116},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n \t\"active\": \"false\",\n \t\"delay\": \"5000\"\n}","position":{"start":{"line":211,"column":1,"offset":6117},"end":{"line":216,"column":4,"offset":6171},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"inlineCode","value":"GET api/v1/system/health","position":{"start":{"line":218,"column":1,"offset":6173},"end":{"line":218,"column":27,"offset":6199},"indent":[]}}],"position":{"start":{"line":218,"column":1,"offset":6173},"end":{"line":218,"column":27,"offset":6199},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Description","position":{"start":{"line":220,"column":3,"offset":6203},"end":{"line":220,"column":14,"offset":6214},"indent":[]}}],"position":{"start":{"line":220,"column":1,"offset":6201},"end":{"line":220,"column":16,"offset":6216},"indent":[]}}],"position":{"start":{"line":220,"column":1,"offset":6201},"end":{"line":220,"column":16,"offset":6216},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Check if the machinery is running (the stream is connected).","position":{"start":{"line":222,"column":1,"offset":6218},"end":{"line":222,"column":61,"offset":6278},"indent":[]}}],"position":{"start":{"line":222,"column":1,"offset":6218},"end":{"line":222,"column":61,"offset":6278},"indent":[]}},{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Response","position":{"start":{"line":224,"column":3,"offset":6282},"end":{"line":224,"column":11,"offset":6290},"indent":[]}}],"position":{"start":{"line":224,"column":1,"offset":6280},"end":{"line":224,"column":13,"offset":6292},"indent":[]}}],"position":{"start":{"line":224,"column":1,"offset":6280},"end":{"line":224,"column":13,"offset":6292},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"{\n \t\"status\": \"false\"\n}","position":{"start":{"line":225,"column":1,"offset":6293},"end":{"line":229,"column":4,"offset":6328},"indent":[1,1,1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":232,"column":1,"offset":6331},"end":{"line":232,"column":31,"offset":6361},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":232,"column":31,"offset":6361}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Web interface`}

\n

{`The web is responsible for the visualization. It's a GUI which helps the user to find activity at a specific period, configure the machinery, view a live stream, see system information and much more.`}

\n

{`It's written in PHP using the extremely popular PHP Framework Laravel, and Javascript using the client-side framework BackboneJS. We will discuss the different pages and functionality briefly. Please check out `}{`the demo environment`}{` if you want to see a real life example.`}

\n

{`Overview`}

\n

{`We will shortly discuss the different pages that make up the web interface of Kerberos Open Source.`}

\n

{`Dashboard`}

\n

{`The landing page of the web is the dashboard. On the dashboard a user will see some statistics: activity per hour, activity per day, a live stream, the latest activity and a heatmap.`}

\n

\"web

\n

{`Overview`}

\n

{`When selecting a specific day, you'll will get a timeline and overview. By using the timeline you can navigate through a day; the timeline highlights the amount of activity, from gray to red.`}

\n

\"web

\n

{`Settings`}

\n

{`The settings page allows you to configure the machinery. You can define the type of camera, post-processes, conditions and much more; it's highly configurable.`}

\n

\"web

\n

{`System`}

\n

{`The system page allows you to monitor the system. On this page you'll get an overview of the system specifications (CPU, Memory, Network, etc). Several actions are available: you can download system information (for debugging purposes) and download or remove your images.`}

\n

\"web

\n

{`Project structure`}

\n

{`The web interface is using the Laravel framework (version 5.4). There is a lot of documentation related to Laravel, please review `}{`their documentation website here`}{`. In a nutshell this is how the web is organised.`}

\n

{`Back-end`}

\n
    \n
  • {`config/app.php - general application settings.`}
    • \n
  • {`config/kerberos.php - this file contains web specific parameters; the user credentials to sign in, etc.`}
    • \n
  • {`app/Http/Controllers - MVC controllers`}
    • \n
  • {`app/Http/Repositories -repositories are injected into the controller.`}
    • \n
  • {`app/Providers/AppServiceProvider.php - bind repositories to a specific interface - dependency injection.`}
    • \n
  • {`routes/api.php - contains all the URI endpoints for Ajax calls.`}
    • \n
  • {`routes/web.php - url routing for pages.`}
    • \n
\n

{`Front-end`}

\n
    \n
  • {`public/css/less - LESS is used for the CSS.`}
    • \n
  • {`public/js/app - BackboneJS and RequireJS is used for building modular JS classes.`}
    • \n
  • {`public/js/mustache - Mustache is used for the client-side view rendering.`}
    • \n
  • {`public/js/vendor - This is where the bower extensions are installed.`}
    • \n
  • {`public/capture - A directory where images are written to by default.`}
    • \n
  • {`public/bower.json - The bower extensions used in the web repository.`}
    • \n
  • {`public/Gruntfile.js - We are using Grunt for our task manager.`}
    • \n
\n

{`API`}

\n

{`If you want to integrate the Kerberos agent with your own application, you're at the right place! The web interface comes with a RESTfull API, that allows you to retrieve and modify information from the Kerberos agent.`}

\n
    \n
  • {`Disable the machinery`}
    • \n
  • {`Health check`}
    • \n
  • {`Enable or disable output devices`}
    • \n
  • {`etc.`}
    • \n
\n

{`Authentication`}

\n

{`To use the RESTfull API of your Kerberos agent you need to define an Authorization header with each request. We use Basic Authentication to secure the different endpoints.`}

\n 
{`\"Authorization\"`}{`: `}{`\"Basic root:root\"`}
\n

{`An example with Python looks like this.`}

\n 
{`import`}{` requests`}{`\n`}{`import`}{` json`}{`\n`}{`import`}{` base64`}{`\n`}{`url = `}{`\"http://ip-of-pi/api/v1/condition/enabled\"`}{`\n`}{`username = `}{`\"user\"`}{`\n`}{`password = `}{`\"passw\"`}{`\n`}{`basicAuth = base64.b64encode(`}{`'`}{`%s`}{`:`}{`%s`}{`'`}{` % (username, password))`}{`\n`}{`headers = {`}{`\"Authorization\"`}{`: `}{`\"Basic \"`}{` + basicAuth, `}{`\"Content-Type\"`}{`: `}{`\"application/json\"`}{`}`}{`\n`}{`data = `}{`'{\"active\": \"true\"}'`}{`\n`}{`#Call REST API`}{`\n`}{`response = requests.put(url, `}{`data`}{`=data, `}{`headers`}{`=headers)`}{`\n`}{`print`}{`(response.text)`}
\n

{`If you're using the wrong credentials, the web will return following error message.`}

\n 
{`Invalid credentials.`}
\n

{`Endpoints`}

\n

{`All endpoints are prefixed with api/v`}{`[version]`}{`/, in which the last part defines the API version number. Below you will find all the available endpoints with there signature and response. Note that when you call an endpoint which doesn't exists, the web will throw an 404.`}

\n 
{`{`}{`\n`}{`\t`}{`\"error\"`}{`: `}{`\"API method does not exists\"`}{`\n`}{`}`}
\n

{`Version 1`}

\n

{`Below you'll find a list of all API methods which are available for version 1.`}

\n

{`GET api/v1/name`}

\n

{`Description`}

\n

{`Retrieve the name of your instance.`}

\n

{`Response`}

\n 
{`{`}{`\n`}{`\t`}{`\"name\"`}{`: `}{`\"frontdoor\"`}{`\n`}{`}`}
\n

{`PUT api/v1/name`}

\n

{`Description`}

\n

{`Change the name of your instance.`}

\n

{`Payload`}

\n 
{`{`}{`\n`}{`\t`}{`\"name\"`}{`: `}{`\"frontdoor-changed\"`}{`\n`}{`}`}
\n

{`Response`}

\n 
{`{`}{`\n`}{`\t`}{`\"name\"`}{`: `}{`\"frontdoor-changed\"`}{`\n`}{`}`}
\n

{`GET api/v1/images/latest_sequence`}

\n

{`Description`}

\n

{`Retrieve the latest sequence detected.`}

\n

{`Response`}

\n 
{`[`}{`\n`}{`    {`}{`\n`}{`        `}{`time`}{`: `}{`\"10:59:57\"`}{`,`}{`\n`}{`        `}{`src`}{`: `}{`\"https://demo.kerberos.io/capture/1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\"`}{`,`}{`\n`}{`        `}{`local_src`}{`: `}{`\"/var/www/web/public/capture/1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\"`}{`,`}{`\n`}{`        `}{`metadata`}{`: {`}{`\n`}{`            `}{`key`}{`: `}{`\"1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\"`}{`,`}{`\n`}{`            `}{`user`}{`: `}{`\"1501491597_6-310145_frontdoor_722-691-873-926_703_511.mp4\"`}{`,`}{`\n`}{`            `}{`timestamp`}{`: `}{`1501491597`}{`,`}{`\n`}{`            `}{`microseconds`}{`: `}{`\"6-310145\"`}{`,`}{`\n`}{`            `}{`instanceName`}{`: `}{`\"frontdoor\"`}{`,`}{`\n`}{`            `}{`regionCoordinates`}{`: `}{`\"722-691-873-926\"`}{`,`}{`\n`}{`            `}{`numberOfChanges`}{`: `}{`\"703\"`}{`,`}{`\n`}{`            `}{`token`}{`: `}{`\"511\"`}{`\n`}{`        },`}{`\n`}{`        `}{`type`}{`: `}{`\"video\"`}{`\n`}{`    }`}{`\n`}{`]`}
\n

{`GET api/v1/condition/enabled`}

\n

{`Description`}

\n

{`Check if enabled or disabled.`}

\n

{`Response`}

\n 
{`{`}{`\n`}{` \t`}{`\"active\"`}{`: `}{`\"true\"`}{`,`}{`\n`}{` \t`}{`\"delay\"`}{`: `}{`\"5000\"`}{`\n`}{`}`}
\n

{`PUT api/v1/condition/enabled`}

\n

{`Description`}

\n

{`Activate or disable the system.`}

\n

{`Payload`}

\n 
{`{`}{`\n`}{` \t`}{`\"active\"`}{`: `}{`\"false\"`}{`\n`}{`}`}
\n

{`Response`}

\n 
{`{`}{`\n`}{` \t`}{`\"active\"`}{`: `}{`\"false\"`}{`,`}{`\n`}{` \t`}{`\"delay\"`}{`: `}{`\"5000\"`}{`\n`}{`}`}
\n

{`GET api/v1/system/health`}

\n

{`Description`}

\n

{`Check if the machinery is running (the stream is connected).`}

\n

{`Response`}

\n 
{`{`}{`\n`}{` \t`}{`\"status\"`}{`: `}{`\"false\"`}{`\n`}{`}`}
\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0ad112f3b6386962f76465e2ca867709.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0ad112f3b6386962f76465e2ca867709.json deleted file mode 100644 index 9664395..0000000 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-0ad112f3b6386962f76465e2ca867709.json +++ /dev/null @@ -1 +0,0 @@ -{"expireTime":9007200861747672000,"key":"gatsby-plugin-mdx-entire-payload-6f026924bed4217d6d17ce25369c1e80-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Enterprise","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a docker image, it has no high availability or fail over functionality. Due to these reasons we have developed Kerberos Enterprise, which is suitable for scaling against your ever growing video surveillance landscape, and keeps them up and running in whatever situation.","position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":274,"offset":975},"indent":[1]}}],"position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":274,"offset":975},"indent":[1]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":16,"column":1,"offset":977},"end":{"line":18,"column":11,"offset":1179},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":20,"column":4,"offset":1184},"end":{"line":20,"column":14,"offset":1194},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1181},"end":{"line":20,"column":14,"offset":1194},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.","position":{"start":{"line":22,"column":1,"offset":1196},"end":{"line":22,"column":306,"offset":1501},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1196},"end":{"line":22,"column":306,"offset":1501},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":24,"column":1,"offset":1503},"end":{"line":24,"column":91,"offset":1593},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1503},"end":{"line":24,"column":91,"offset":1593},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).","position":{"start":{"line":26,"column":1,"offset":1595},"end":{"line":26,"column":239,"offset":1833},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1595},"end":{"line":26,"column":239,"offset":1833},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.","position":{"start":{"line":28,"column":1,"offset":1835},"end":{"line":28,"column":242,"offset":2076},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1835},"end":{"line":28,"column":242,"offset":2076},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.","position":{"start":{"line":30,"column":1,"offset":2078},"end":{"line":30,"column":205,"offset":2282},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2078},"end":{"line":30,"column":205,"offset":2282},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud or on premise","position":{"start":{"line":32,"column":4,"offset":2287},"end":{"line":32,"column":23,"offset":2306},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2284},"end":{"line":32,"column":23,"offset":2306},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.","position":{"start":{"line":34,"column":1,"offset":2308},"end":{"line":34,"column":283,"offset":2590},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2308},"end":{"line":34,"column":283,"offset":2590},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":36,"column":1,"offset":2592},"end":{"line":36,"column":97,"offset":2688},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2592},"end":{"line":36,"column":97,"offset":2688},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":38,"column":4,"offset":2693},"end":{"line":38,"column":13,"offset":2702},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2690},"end":{"line":38,"column":13,"offset":2702},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is publicly available and ","position":{"start":{"line":40,"column":1,"offset":2704},"end":{"line":40,"column":47,"offset":2750},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":40,"column":49,"offset":2752},"end":{"line":40,"column":57,"offset":2760},"indent":[]}}],"position":{"start":{"line":40,"column":47,"offset":2750},"end":{"line":40,"column":59,"offset":2762},"indent":[]}},{"type":"text","value":" require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.","position":{"start":{"line":40,"column":59,"offset":2762},"end":{"line":40,"column":174,"offset":2877},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2704},"end":{"line":40,"column":174,"offset":2877},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":43,"column":1,"offset":2880},"end":{"line":43,"column":31,"offset":2910},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":43,"column":31,"offset":2910}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Enterprise`}

\n

{`Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.`}

\n

{`That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a docker image, it has no high availability or fail over functionality. Due to these reasons we have developed Kerberos Enterprise, which is suitable for scaling against your ever growing video surveillance landscape, and keeps them up and running in whatever situation.`}

\n
\n
\n

\n

{`Kubernetes`}

\n

{`To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.`}

\n

\"architecture

\n

{`Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).`}

\n

{`Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.`}

\n

{`By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.`}

\n

{`Cloud or on premise`}

\n

{`You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.`}

\n

\"architecture

\n

{`Licensing`}

\n

{`Kerberos Enterprise is publicly available and `}{`does not`}{` require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-103067923b4823d77494bcece4fa341b.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-103067923b4823d77494bcece4fa341b.json new file mode 100644 index 0000000..74b653d --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-103067923b4823d77494bcece4fa341b.json @@ -0,0 +1 @@ +{"expireTime":9007200861829817000,"key":"gatsby-plugin-mdx-entire-payload-b4b3f0ddc7a048e565ced150b3d7ee80-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":396,"offset":1049},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":396,"offset":1049},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Despite the flexible storage capabilities, Kerberos Storage is also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations. It allows you to leverage a scalable and stable system as a strong backbone for your video analytics solutions, machine learning algorithms, and more.","position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":349,"offset":1399},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":349,"offset":1399},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":22,"column":4,"offset":1404},"end":{"line":22,"column":18,"offset":1418},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1401},"end":{"line":22,"column":18,"offset":1418},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can upload your recordings to our ","position":{"start":{"line":24,"column":1,"offset":1420},"end":{"line":24,"column":90,"offset":1509},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":24,"column":91,"offset":1510},"end":{"line":24,"column":105,"offset":1524},"indent":[]}}],"position":{"start":{"line":24,"column":90,"offset":1509},"end":{"line":24,"column":114,"offset":1533},"indent":[]}},{"type":"text","value":" environment. This means that your data will be hosted and processed (metadata) in our Kerberos datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":24,"column":114,"offset":1533},"end":{"line":24,"column":274,"offset":1693},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":24,"column":275,"offset":1694},"end":{"line":24,"column":292,"offset":1711},"indent":[]}}],"position":{"start":{"line":24,"column":274,"offset":1693},"end":{"line":24,"column":301,"offset":1720},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":24,"column":301,"offset":1720},"end":{"line":24,"column":302,"offset":1721},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1420},"end":{"line":24,"column":302,"offset":1721},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":26,"column":1,"offset":1723},"end":{"line":26,"column":56,"offset":1778},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1723},"end":{"line":26,"column":56,"offset":1778},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":28,"column":4,"offset":1783},"end":{"line":28,"column":20,"offset":1799},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1780},"end":{"line":28,"column":20,"offset":1799},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":30,"column":1,"offset":1801},"end":{"line":30,"column":253,"offset":2053},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1801},"end":{"line":30,"column":253,"offset":2053},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":32,"column":6,"offset":2060},"end":{"line":32,"column":35,"offset":2089},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2059},"end":{"line":32,"column":70,"offset":2124},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2059},"end":{"line":32,"column":70,"offset":2124},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2055},"end":{"line":32,"column":70,"offset":2124},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":33,"column":6,"offset":2130},"end":{"line":33,"column":29,"offset":2153},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2129},"end":{"line":33,"column":83,"offset":2207},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2129},"end":{"line":33,"column":83,"offset":2207},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2125},"end":{"line":33,"column":83,"offset":2207},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":34,"column":6,"offset":2213},"end":{"line":34,"column":28,"offset":2235},"indent":[]}}],"position":{"start":{"line":34,"column":5,"offset":2212},"end":{"line":34,"column":57,"offset":2264},"indent":[]}}],"position":{"start":{"line":34,"column":5,"offset":2212},"end":{"line":34,"column":57,"offset":2264},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2208},"end":{"line":34,"column":57,"offset":2264},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":35,"column":6,"offset":2270},"end":{"line":35,"column":11,"offset":2275},"indent":[]}}],"position":{"start":{"line":35,"column":5,"offset":2269},"end":{"line":35,"column":29,"offset":2293},"indent":[]}}],"position":{"start":{"line":35,"column":5,"offset":2269},"end":{"line":35,"column":29,"offset":2293},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2265},"end":{"line":35,"column":29,"offset":2293},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2055},"end":{"line":35,"column":29,"offset":2293},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":37,"column":1,"offset":2295},"end":{"line":37,"column":190,"offset":2484},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2295},"end":{"line":37,"column":190,"offset":2484},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":39,"column":1,"offset":2486},"end":{"line":39,"column":99,"offset":2584},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2486},"end":{"line":39,"column":99,"offset":2584},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":41,"column":1,"offset":2586},"end":{"line":41,"column":220,"offset":2805},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2586},"end":{"line":41,"column":220,"offset":2805},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":43,"column":1,"offset":2807},"end":{"line":43,"column":98,"offset":2904},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2807},"end":{"line":43,"column":98,"offset":2904},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":45,"column":5,"offset":2910},"end":{"line":45,"column":11,"offset":2916},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2906},"end":{"line":45,"column":11,"offset":2916},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":47,"column":1,"offset":2918},"end":{"line":47,"column":303,"offset":3220},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2918},"end":{"line":47,"column":303,"offset":3220},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":49,"column":6,"offset":3227},"end":{"line":49,"column":18,"offset":3239},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":3226},"end":{"line":49,"column":46,"offset":3267},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":3226},"end":{"line":49,"column":46,"offset":3267},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3222},"end":{"line":49,"column":46,"offset":3267},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":50,"column":6,"offset":3273},"end":{"line":50,"column":29,"offset":3296},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":3272},"end":{"line":50,"column":59,"offset":3326},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":3272},"end":{"line":50,"column":59,"offset":3326},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3268},"end":{"line":50,"column":59,"offset":3326},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3222},"end":{"line":50,"column":59,"offset":3326},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":52,"column":1,"offset":3328},"end":{"line":52,"column":368,"offset":3695},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3328},"end":{"line":52,"column":368,"offset":3695},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":54,"column":1,"offset":3697},"end":{"line":54,"column":66,"offset":3762},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3697},"end":{"line":54,"column":66,"offset":3762},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":56,"column":5,"offset":3768},"end":{"line":56,"column":21,"offset":3784},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3764},"end":{"line":56,"column":21,"offset":3784},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":58,"column":1,"offset":3786},"end":{"line":58,"column":237,"offset":4022},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3786},"end":{"line":58,"column":237,"offset":4022},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":60,"column":1,"offset":4024},"end":{"line":60,"column":105,"offset":4128},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4024},"end":{"line":60,"column":105,"offset":4128},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":62,"column":1,"offset":4130},"end":{"line":62,"column":45,"offset":4174},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4130},"end":{"line":62,"column":45,"offset":4174},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":64,"column":3,"offset":4178},"end":{"line":64,"column":380,"offset":4555},"indent":[]}}],"position":{"start":{"line":64,"column":3,"offset":4178},"end":{"line":64,"column":380,"offset":4555},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4176},"end":{"line":65,"column":1,"offset":4556},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":66,"column":3,"offset":4559},"end":{"line":67,"column":49,"offset":4873},"indent":[2]}}],"position":{"start":{"line":66,"column":3,"offset":4559},"end":{"line":67,"column":49,"offset":4873},"indent":[2]}}],"position":{"start":{"line":66,"column":1,"offset":4557},"end":{"line":67,"column":49,"offset":4873},"indent":[1]}}],"position":{"start":{"line":64,"column":1,"offset":4176},"end":{"line":67,"column":49,"offset":4873},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":69,"column":5,"offset":4879},"end":{"line":69,"column":13,"offset":4887},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4875},"end":{"line":69,"column":13,"offset":4887},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":71,"column":1,"offset":4889},"end":{"line":71,"column":156,"offset":5044},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":71,"column":156,"offset":5044},"end":{"line":71,"column":177,"offset":5065},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":71,"column":177,"offset":5065},"end":{"line":71,"column":188,"offset":5076},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":71,"column":188,"offset":5076},"end":{"line":71,"column":193,"offset":5081},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":71,"column":193,"offset":5081},"end":{"line":71,"column":379,"offset":5267},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":4889},"end":{"line":71,"column":379,"offset":5267},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":73,"column":1,"offset":5269},"end":{"line":73,"column":68,"offset":5336},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5269},"end":{"line":73,"column":68,"offset":5336},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":75,"column":4,"offset":5341},"end":{"line":75,"column":13,"offset":5350},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5338},"end":{"line":75,"column":13,"offset":5350},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":77,"column":1,"offset":5352},"end":{"line":77,"column":44,"offset":5395},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":77,"column":46,"offset":5397},"end":{"line":77,"column":68,"offset":5419},"indent":[]}}],"position":{"start":{"line":77,"column":44,"offset":5395},"end":{"line":77,"column":70,"offset":5421},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":77,"column":70,"offset":5421},"end":{"line":77,"column":106,"offset":5457},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":77,"column":108,"offset":5459},"end":{"line":77,"column":129,"offset":5480},"indent":[]}}],"position":{"start":{"line":77,"column":106,"offset":5457},"end":{"line":77,"column":131,"offset":5482},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":77,"column":131,"offset":5482},"end":{"line":77,"column":159,"offset":5510},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":5352},"end":{"line":77,"column":159,"offset":5510},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":80,"column":1,"offset":5513},"end":{"line":80,"column":31,"offset":5543},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":80,"column":31,"offset":5543}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio.`}

\n

{`Despite the flexible storage capabilities, Kerberos Storage is also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations. It allows you to leverage a scalable and stable system as a strong backbone for your video analytics solutions, machine learning algorithms, and more.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can upload your recordings to our `}{`Kerberos Cloud`}{` environment. This means that your data will be hosted and processed (metadata) in our Kerberos datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-15fe440bff947c861e534269b30fcdca.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-15fe440bff947c861e534269b30fcdca.json new file mode 100644 index 0000000..3e1c46d --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-15fe440bff947c861e534269b30fcdca.json @@ -0,0 +1 @@ +{"expireTime":9007200861824800000,"key":"gatsby-plugin-mdx-entire-payload-d26c6720f7bd1fd8a1c0073bcf5203ef-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import SettingsIcon from '@material-ui/icons/Settings';","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":56,"offset":214},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Get Started","position":{"start":{"line":10,"column":3,"offset":218},"end":{"line":10,"column":14,"offset":229},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":216},"end":{"line":10,"column":14,"offset":229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.","position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known ","position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":169,"offset":679},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":14,"column":169,"offset":679},"end":{"line":14,"column":178,"offset":688},"indent":[]}},{"type":"text","value":" command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.","position":{"start":{"line":14,"column":178,"offset":688},"end":{"line":14,"column":314,"offset":824},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":314,"offset":824},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":16,"column":1,"offset":826},"end":{"line":18,"column":11,"offset":1028},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Login page","position":{"start":{"line":20,"column":4,"offset":1033},"end":{"line":20,"column":14,"offset":1043},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1030},"end":{"line":20,"column":14,"offset":1043},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.","position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/login.gif","alt":"Factory","position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The default username password of the Factory web applications is:","position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"username: ","position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":13,"offset":1310},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":28,"column":15,"offset":1312},"end":{"line":28,"column":19,"offset":1316},"indent":[]}}],"position":{"start":{"line":28,"column":13,"offset":1310},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":28,"column":21,"offset":1318},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"password: ","position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":13,"offset":1331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"kerberos","position":{"start":{"line":29,"column":15,"offset":1333},"end":{"line":29,"column":23,"offset":1341},"indent":[]}}],"position":{"start":{"line":29,"column":13,"offset":1331},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1319},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":29,"column":25,"offset":1343},"indent":[1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"The username and password ","position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":29,"offset":1373},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/enterprise/blob/master/yaml/factory/deployment.yaml#L54","children":[{"type":"text","value":"can be changed in the ","position":{"start":{"line":31,"column":30,"offset":1374},"end":{"line":31,"column":52,"offset":1396},"indent":[]}},{"type":"inlineCode","value":"deploment.yaml","position":{"start":{"line":31,"column":52,"offset":1396},"end":{"line":31,"column":68,"offset":1412},"indent":[]}},{"type":"text","value":" file","position":{"start":{"line":31,"column":68,"offset":1412},"end":{"line":31,"column":73,"offset":1417},"indent":[]}}],"position":{"start":{"line":31,"column":29,"offset":1373},"end":{"line":31,"column":162,"offset":1506},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":162,"offset":1506},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1345},"end":{"line":31,"column":163,"offset":1507},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Overview","position":{"start":{"line":33,"column":4,"offset":1512},"end":{"line":33,"column":12,"offset":1520},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1509},"end":{"line":33,"column":12,"offset":1520},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: ","position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":146,"offset":1667},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Docker","position":{"start":{"line":35,"column":148,"offset":1669},"end":{"line":35,"column":154,"offset":1675},"indent":[]}}],"position":{"start":{"line":35,"column":146,"offset":1667},"end":{"line":35,"column":156,"offset":1677},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":35,"column":156,"offset":1677},"end":{"line":35,"column":161,"offset":1682},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":35,"column":163,"offset":1684},"end":{"line":35,"column":173,"offset":1694},"indent":[]}}],"position":{"start":{"line":35,"column":161,"offset":1682},"end":{"line":35,"column":175,"offset":1696},"indent":[]}},{"type":"text","value":". Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.","position":{"start":{"line":35,"column":175,"offset":1696},"end":{"line":35,"column":317,"offset":1838},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":317,"offset":1838},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.","position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/docker-Kubernetes.gif","alt":"Factory","position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":41,"column":4,"offset":2094},"end":{"line":41,"column":14,"offset":2104},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2091},"end":{"line":41,"column":14,"offset":2104},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:","position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Nodes: a list of all the nodes in your cluster.","position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":45,"column":50,"offset":2255},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Deployments: a list of all the Kerberos Enterprise agents running in your cluster.","position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":2256},"end":{"line":46,"column":85,"offset":2340},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pods: all the pods running in your cluster.","position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2341},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":47,"column":46,"offset":2386},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Nodes","position":{"start":{"line":49,"column":4,"offset":2391},"end":{"line":49,"column":9,"offset":2396},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":2388},"end":{"line":49,"column":9,"offset":2396},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.","position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-nodes.png","alt":"Factory","position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Deployments","position":{"start":{"line":55,"column":4,"offset":2700},"end":{"line":55,"column":15,"offset":2711},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2697},"end":{"line":55,"column":15,"offset":2711},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.","position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-deployments.png","alt":"Factory","position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Adding a new deployment","position":{"start":{"line":61,"column":5,"offset":3201},"end":{"line":61,"column":28,"offset":3224},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3197},"end":{"line":61,"column":28,"offset":3224},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"There are two options to add a new deployment, single deployments and bulk deployment.","position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/single-bulk-deployment.gif","alt":"Factory","position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"single deployment","position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.","position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"in bulk deployment.","position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By importing an Excel file, deployments can be created in bulk.","position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.","position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-add-bulk-deployment-excel.png","alt":"Factory","position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Configuring a deployment","position":{"start":{"line":79,"column":5,"offset":3855},"end":{"line":79,"column":29,"offset":3879},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3851},"end":{"line":79,"column":29,"offset":3879},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the ","position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":200,"offset":4080},"indent":[]}},{"type":"jsx","value":"","position":{"start":{"line":81,"column":200,"offset":4080},"end":{"line":81,"column":235,"offset":4115},"indent":[]}},{"type":"text","value":" icon. This will open a popup, allowing you to change some settings.","position":{"start":{"line":81,"column":235,"offset":4115},"end":{"line":81,"column":303,"offset":4183},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":303,"offset":4183},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/deployment-configuration.gif","alt":"Factory","position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Following settings can be changed:","position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more regions of interest,","position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":87,"column":35,"offset":4325},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Time based conditions,","position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":4326},"end":{"line":88,"column":25,"offset":4350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pre- and postrecording","position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4351},"end":{"line":89,"column":25,"offset":4375},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording","position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4376},"end":{"line":90,"column":23,"offset":4398},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Linking to ","position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":14,"offset":4412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":91,"column":15,"offset":4413},"end":{"line":91,"column":29,"offset":4427},"indent":[]}}],"position":{"start":{"line":91,"column":14,"offset":4412},"end":{"line":91,"column":38,"offset":4436},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":91,"column":38,"offset":4436},"end":{"line":91,"column":42,"offset":4440},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":91,"column":43,"offset":4441},"end":{"line":91,"column":59,"offset":4457},"indent":[]}}],"position":{"start":{"line":91,"column":42,"offset":4440},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4399},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":91,"column":83,"offset":4481},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Global configuration","position":{"start":{"line":93,"column":5,"offset":4487},"end":{"line":93,"column":25,"offset":4507},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4483},"end":{"line":93,"column":25,"offset":4507},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.","position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.","position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/global-configuration.gif","alt":"Factory Global Config","position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Upgrade or reboot a Kerberos Enterprise agent","position":{"start":{"line":101,"column":5,"offset":5046},"end":{"line":101,"column":50,"offset":5091},"indent":[]}}],"position":{"start":{"line":101,"column":1,"offset":5042},"end":{"line":101,"column":50,"offset":5091},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, ","position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":373,"offset":5465},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"a zero downtime upgrade will take place","position":{"start":{"line":103,"column":375,"offset":5467},"end":{"line":103,"column":414,"offset":5506},"indent":[]}}],"position":{"start":{"line":103,"column":373,"offset":5465},"end":{"line":103,"column":416,"offset":5508},"indent":[]}},{"type":"text","value":". Kubernetes will download the new release, create a new pod, and destroy the old one.","position":{"start":{"line":103,"column":416,"offset":5508},"end":{"line":103,"column":502,"offset":5594},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":502,"offset":5594},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.","position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}}],"position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/upgrade-reboot.gif","alt":"Upgrade and reboot","position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}}],"position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Pods","position":{"start":{"line":110,"column":4,"offset":5965},"end":{"line":110,"column":8,"offset":5969},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":5962},"end":{"line":110,"column":8,"offset":5969},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.","position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-pods.png","alt":"Factory","position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage and video management","position":{"start":{"line":117,"column":4,"offset":6482},"end":{"line":117,"column":32,"offset":6510},"indent":[]}}],"position":{"start":{"line":117,"column":1,"offset":6479},"end":{"line":117,"column":32,"offset":6510},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).","position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also ","position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":169,"offset":7035},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":121,"column":171,"offset":7037},"end":{"line":121,"column":179,"offset":7045},"indent":[]}}],"position":{"start":{"line":121,"column":169,"offset":7035},"end":{"line":121,"column":181,"offset":7047},"indent":[]}},{"type":"text","value":" have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed ","position":{"start":{"line":121,"column":181,"offset":7047},"end":{"line":121,"column":419,"offset":7285},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":121,"column":420,"offset":7286},"end":{"line":121,"column":436,"offset":7302},"indent":[]}}],"position":{"start":{"line":121,"column":419,"offset":7285},"end":{"line":121,"column":460,"offset":7326},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":121,"column":460,"offset":7326},"end":{"line":121,"column":465,"offset":7331},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":121,"column":466,"offset":7332},"end":{"line":121,"column":480,"offset":7346},"indent":[]}}],"position":{"start":{"line":121,"column":465,"offset":7331},"end":{"line":121,"column":489,"offset":7355},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":121,"column":489,"offset":7355},"end":{"line":121,"column":490,"offset":7356},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":490,"offset":7356},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":123,"column":5,"offset":7362},"end":{"line":123,"column":21,"offset":7378},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":7358},"end":{"line":123,"column":21,"offset":7378},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":125,"column":2,"offset":7381},"end":{"line":125,"column":18,"offset":7397},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":42,"offset":7421},"indent":[]}},{"type":"text","value":" is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).","position":{"start":{"line":125,"column":42,"offset":7421},"end":{"line":125,"column":328,"offset":7707},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":328,"offset":7707},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).","position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}}],"position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the ","position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":147,"offset":8189},"indent":[]}},{"type":"inlineCode","value":"cloud","position":{"start":{"line":131,"column":147,"offset":8189},"end":{"line":131,"column":154,"offset":8196},"indent":[]}},{"type":"text","value":" tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.","position":{"start":{"line":131,"column":154,"offset":8196},"end":{"line":131,"column":245,"offset":8287},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":245,"offset":8287},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Storage URI: this is the API endpoint of your Kerberos Storage instance. Typically this is in the following format: ","position":{"start":{"line":133,"column":3,"offset":8291},"end":{"line":133,"column":119,"offset":8407},"indent":[]}},{"type":"inlineCode","value":"http(s)://api.yourdomain.com/storage","position":{"start":{"line":133,"column":119,"offset":8407},"end":{"line":133,"column":157,"offset":8445},"indent":[]}},{"type":"text","value":". Where ","position":{"start":{"line":133,"column":157,"offset":8445},"end":{"line":133,"column":165,"offset":8453},"indent":[]}},{"type":"inlineCode","value":"api.yourdomain.com","position":{"start":{"line":133,"column":165,"offset":8453},"end":{"line":133,"column":185,"offset":8473},"indent":[]}},{"type":"text","value":" should match your Kerberos Storage API endpoint.","position":{"start":{"line":133,"column":185,"offset":8473},"end":{"line":133,"column":234,"offset":8522},"indent":[]}}],"position":{"start":{"line":133,"column":3,"offset":8291},"end":{"line":133,"column":234,"offset":8522},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":8289},"end":{"line":134,"column":1,"offset":8523},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Provider: the name of the provider, which you created on the Kerberos Storage providers page, to which you want to send your recordings to.","position":{"start":{"line":135,"column":3,"offset":8526},"end":{"line":135,"column":142,"offset":8665},"indent":[]}}],"position":{"start":{"line":135,"column":3,"offset":8526},"end":{"line":135,"column":142,"offset":8665},"indent":[]}}],"position":{"start":{"line":135,"column":1,"offset":8524},"end":{"line":136,"column":1,"offset":8666},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Directory: this is the subdirectory in which your files will be stored. At the time of writing this should also equal your Kerberos Cloud username, if you plan to upload to Kerberos Cloud.","position":{"start":{"line":137,"column":3,"offset":8669},"end":{"line":137,"column":191,"offset":8857},"indent":[]}}],"position":{"start":{"line":137,"column":3,"offset":8669},"end":{"line":137,"column":191,"offset":8857},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":8667},"end":{"line":138,"column":1,"offset":8858},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Access Key: this should match the access key of one of your Kerberos Storage accounts.","position":{"start":{"line":139,"column":3,"offset":8861},"end":{"line":139,"column":89,"offset":8947},"indent":[]}}],"position":{"start":{"line":139,"column":3,"offset":8861},"end":{"line":139,"column":89,"offset":8947},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":8859},"end":{"line":140,"column":1,"offset":8948},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secret Access Key: this should match the secret access key of one of your Kerberos Storage accounts.","position":{"start":{"line":141,"column":3,"offset":8951},"end":{"line":141,"column":103,"offset":9051},"indent":[]}}],"position":{"start":{"line":141,"column":3,"offset":8951},"end":{"line":141,"column":103,"offset":9051},"indent":[]}}],"position":{"start":{"line":141,"column":1,"offset":8949},"end":{"line":141,"column":103,"offset":9051},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":8289},"end":{"line":141,"column":103,"offset":9051},"indent":[1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-enterprise-storage-setup.gif","alt":"kerberos storage configuration","position":{"start":{"line":144,"column":1,"offset":9054},"end":{"line":144,"column":101,"offset":9154},"indent":[]}}],"position":{"start":{"line":144,"column":1,"offset":9054},"end":{"line":144,"column":101,"offset":9154},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":146,"column":5,"offset":9160},"end":{"line":146,"column":19,"offset":9174},"indent":[]}}],"position":{"start":{"line":146,"column":1,"offset":9156},"end":{"line":146,"column":19,"offset":9174},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more ","position":{"start":{"line":148,"column":1,"offset":9176},"end":{"line":148,"column":219,"offset":9394},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"about the features and functions here","position":{"start":{"line":148,"column":220,"offset":9395},"end":{"line":148,"column":257,"offset":9432},"indent":[]}}],"position":{"start":{"line":148,"column":219,"offset":9394},"end":{"line":148,"column":266,"offset":9441},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":148,"column":266,"offset":9441},"end":{"line":148,"column":267,"offset":9442},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":9176},"end":{"line":148,"column":267,"offset":9442},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the ","position":{"start":{"line":150,"column":1,"offset":9444},"end":{"line":150,"column":285,"offset":9728},"indent":[]}},{"type":"link","title":null,"url":"/storage/get-started","children":[{"type":"text","value":"Kerberos Storage page","position":{"start":{"line":150,"column":286,"offset":9729},"end":{"line":150,"column":307,"offset":9750},"indent":[]}}],"position":{"start":{"line":150,"column":285,"offset":9728},"end":{"line":150,"column":330,"offset":9773},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":150,"column":330,"offset":9773},"end":{"line":150,"column":331,"offset":9774},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":9444},"end":{"line":150,"column":331,"offset":9774},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.","position":{"start":{"line":152,"column":1,"offset":9776},"end":{"line":152,"column":104,"offset":9879},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":9776},"end":{"line":152,"column":104,"offset":9879},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-enterprise-to-cloud.gif","alt":"kerberos storage configuration","position":{"start":{"line":154,"column":1,"offset":9881},"end":{"line":154,"column":96,"offset":9976},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":9881},"end":{"line":154,"column":96,"offset":9976},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":157,"column":1,"offset":9979},"end":{"line":157,"column":31,"offset":10009},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":157,"column":31,"offset":10009}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport SettingsIcon from '@material-ui/icons/Settings';\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Get Started`}

\n

{`Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.`}

\n

{`Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known `}{`kubectl`}{` command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.`}

\n
\n
\n

\n

{`Login page`}

\n

{`Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.`}

\n

\"Factory\"

\n

{`The default username password of the Factory web applications is:`}

\n
    \n
  • {`username: `}{`root`}
    • \n
  • {`password: `}{`kerberos`}
    • \n
\n
\n

{`The username and password `}{`can be changed in the `}{`deploment.yaml`}{` file`}{`.`}

\n
\n

{`Overview`}

\n

{`On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: `}{`Docker`}{` and `}{`Kubernetes`}{`. Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.`}

\n

{`When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.`}

\n

\"Factory\"

\n

{`Kubernetes`}

\n

{`On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:`}

\n
    \n
  • {`Nodes: a list of all the nodes in your cluster.`}
    • \n
  • {`Deployments: a list of all the Kerberos Enterprise agents running in your cluster.`}
    • \n
  • {`Pods: all the pods running in your cluster.`}
    • \n
\n

{`Nodes`}

\n

{`The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.`}

\n

\"Factory\"

\n

{`Deployments`}

\n

{`The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.`}

\n

\"Factory\"

\n

{`Adding a new deployment`}

\n

{`There are two options to add a new deployment, single deployments and bulk deployment.`}

\n

\"Factory\"

\n
    \n
  • {`single deployment`}
    • \n
\n

{`By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.`}

\n
    \n
  • {`in bulk deployment.`}
    • \n
\n

{`By importing an Excel file, deployments can be created in bulk.`}

\n

{`By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.`}

\n

\"Factory\"

\n

{`Configuring a deployment`}

\n

{`Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the `}{` icon. This will open a popup, allowing you to change some settings.`}

\n

\"Factory\"

\n

{`Following settings can be changed:`}

\n
    \n
  • {`One or more regions of interest,`}
    • \n
  • {`Time based conditions,`}
    • \n
  • {`Pre- and postrecording`}
    • \n
  • {`Continious recording`}
    • \n
  • {`Linking to `}{`Kerberos Cloud`}{` or `}{`Kerberos Storage`}
    • \n
\n

{`Global configuration`}

\n

{`Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.`}

\n

{`By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.`}

\n

\"Factory

\n

{`Upgrade or reboot a Kerberos Enterprise agent`}

\n

{`At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, `}{`a zero downtime upgrade will take place`}{`. Kubernetes will download the new release, create a new pod, and destroy the old one.`}

\n

{`At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.`}

\n

\"Upgrade

\n

{`Pods`}

\n

{`When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.`}

\n

\"Factory\"

\n

{`Storage and video management`}

\n

{`Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).`}

\n

{`Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also `}{`does not`}{` have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed `}{`Kerberos Storage`}{` and `}{`Kerberos Cloud`}{`.`}

\n

{`Kerberos Storage`}

\n

{`Kerberos Storage`}{` is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).`}

\n

{`On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).`}

\n

\"architecture

\n

{`To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the `}{`cloud`}{` tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.`}

\n
    \n
  • \n

    {`Storage URI: this is the API endpoint of your Kerberos Storage instance. Typically this is in the following format: `}{`http(s)://api.yourdomain.com/storage`}{`. Where `}{`api.yourdomain.com`}{` should match your Kerberos Storage API endpoint.`}

    \n
    • \n
  • \n

    {`Provider: the name of the provider, which you created on the Kerberos Storage providers page, to which you want to send your recordings to.`}

    \n
    • \n
  • \n

    {`Directory: this is the subdirectory in which your files will be stored. At the time of writing this should also equal your Kerberos Cloud username, if you plan to upload to Kerberos Cloud.`}

    \n
    • \n
  • \n

    {`Access Key: this should match the access key of one of your Kerberos Storage accounts.`}

    \n
    • \n
  • \n

    {`Secret Access Key: this should match the secret access key of one of your Kerberos Storage accounts.`}

    \n
    • \n
\n

\"kerberos

\n

{`Kerberos Cloud`}

\n

{`For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more `}{`about the features and functions here`}{`.`}

\n

{`You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the `}{`Kerberos Storage page`}{`.`}

\n

{`Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.`}

\n

\"kerberos

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-195832fa52cabaef3c47ce0f6a880491.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-195832fa52cabaef3c47ce0f6a880491.json new file mode 100644 index 0000000..74258f8 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-195832fa52cabaef3c47ce0f6a880491.json @@ -0,0 +1 @@ +{"expireTime":9007200861828685000,"key":"gatsby-plugin-mdx-entire-payload-6d3ac4a3b80077a86ebb472e249731a3-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":77,"offset":412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":78,"offset":413},"end":{"line":12,"column":92,"offset":427},"indent":[]}}],"position":{"start":{"line":12,"column":77,"offset":412},"end":{"line":12,"column":101,"offset":436},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers.","position":{"start":{"line":12,"column":101,"offset":436},"end":{"line":12,"column":166,"offset":501},"indent":[]}}],"position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":166,"offset":501},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":166,"offset":501},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"In addtionation to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":13,"column":4,"offset":505},"end":{"line":13,"column":581,"offset":1082},"indent":[]}}],"position":{"start":{"line":13,"column":4,"offset":505},"end":{"line":13,"column":581,"offset":1082},"indent":[]}}],"position":{"start":{"line":13,"column":1,"offset":502},"end":{"line":13,"column":581,"offset":1082},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":13,"column":581,"offset":1082},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":15,"column":4,"offset":1087},"end":{"line":15,"column":18,"offset":1101},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":1084},"end":{"line":15,"column":18,"offset":1101},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":17,"column":1,"offset":1103},"end":{"line":17,"column":291,"offset":1393},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":17,"column":292,"offset":1394},"end":{"line":17,"column":309,"offset":1411},"indent":[]}}],"position":{"start":{"line":17,"column":291,"offset":1393},"end":{"line":17,"column":318,"offset":1420},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":17,"column":318,"offset":1420},"end":{"line":17,"column":319,"offset":1421},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":1103},"end":{"line":17,"column":319,"offset":1421},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":19,"column":1,"offset":1423},"end":{"line":19,"column":56,"offset":1478},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":1423},"end":{"line":19,"column":56,"offset":1478},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":21,"column":4,"offset":1483},"end":{"line":21,"column":20,"offset":1499},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1480},"end":{"line":21,"column":20,"offset":1499},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":23,"column":1,"offset":1501},"end":{"line":23,"column":253,"offset":1753},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1501},"end":{"line":23,"column":253,"offset":1753},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":25,"column":6,"offset":1760},"end":{"line":25,"column":35,"offset":1789},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1759},"end":{"line":25,"column":70,"offset":1824},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1759},"end":{"line":25,"column":70,"offset":1824},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1755},"end":{"line":25,"column":70,"offset":1824},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":26,"column":6,"offset":1830},"end":{"line":26,"column":29,"offset":1853},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1829},"end":{"line":26,"column":83,"offset":1907},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1829},"end":{"line":26,"column":83,"offset":1907},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1825},"end":{"line":26,"column":83,"offset":1907},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":27,"column":6,"offset":1913},"end":{"line":27,"column":28,"offset":1935},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1912},"end":{"line":27,"column":57,"offset":1964},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1912},"end":{"line":27,"column":57,"offset":1964},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1908},"end":{"line":27,"column":57,"offset":1964},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":28,"column":6,"offset":1970},"end":{"line":28,"column":11,"offset":1975},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":1969},"end":{"line":28,"column":29,"offset":1993},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":1969},"end":{"line":28,"column":29,"offset":1993},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1965},"end":{"line":28,"column":29,"offset":1993},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1755},"end":{"line":28,"column":29,"offset":1993},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":30,"column":1,"offset":1995},"end":{"line":30,"column":190,"offset":2184},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1995},"end":{"line":30,"column":190,"offset":2184},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":32,"column":1,"offset":2186},"end":{"line":32,"column":99,"offset":2284},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2186},"end":{"line":32,"column":99,"offset":2284},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":34,"column":1,"offset":2286},"end":{"line":34,"column":220,"offset":2505},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2286},"end":{"line":34,"column":220,"offset":2505},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":36,"column":1,"offset":2507},"end":{"line":36,"column":98,"offset":2604},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2507},"end":{"line":36,"column":98,"offset":2604},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":38,"column":5,"offset":2610},"end":{"line":38,"column":11,"offset":2616},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2606},"end":{"line":38,"column":11,"offset":2616},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":40,"column":1,"offset":2618},"end":{"line":40,"column":303,"offset":2920},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2618},"end":{"line":40,"column":303,"offset":2920},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":42,"column":6,"offset":2927},"end":{"line":42,"column":18,"offset":2939},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2926},"end":{"line":42,"column":46,"offset":2967},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2926},"end":{"line":42,"column":46,"offset":2967},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2922},"end":{"line":42,"column":46,"offset":2967},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":43,"column":6,"offset":2973},"end":{"line":43,"column":29,"offset":2996},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":2972},"end":{"line":43,"column":59,"offset":3026},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":2972},"end":{"line":43,"column":59,"offset":3026},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2968},"end":{"line":43,"column":59,"offset":3026},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2922},"end":{"line":43,"column":59,"offset":3026},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":45,"column":1,"offset":3028},"end":{"line":45,"column":368,"offset":3395},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":3028},"end":{"line":45,"column":368,"offset":3395},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":47,"column":1,"offset":3397},"end":{"line":47,"column":66,"offset":3462},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3397},"end":{"line":47,"column":66,"offset":3462},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":49,"column":5,"offset":3468},"end":{"line":49,"column":21,"offset":3484},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3464},"end":{"line":49,"column":21,"offset":3484},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":51,"column":1,"offset":3486},"end":{"line":51,"column":237,"offset":3722},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":3486},"end":{"line":51,"column":237,"offset":3722},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":53,"column":1,"offset":3724},"end":{"line":53,"column":105,"offset":3828},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":3724},"end":{"line":53,"column":105,"offset":3828},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":55,"column":1,"offset":3830},"end":{"line":55,"column":45,"offset":3874},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":3830},"end":{"line":55,"column":45,"offset":3874},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":57,"column":3,"offset":3878},"end":{"line":57,"column":380,"offset":4255},"indent":[]}}],"position":{"start":{"line":57,"column":3,"offset":3878},"end":{"line":57,"column":380,"offset":4255},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":3876},"end":{"line":58,"column":1,"offset":4256},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":59,"column":3,"offset":4259},"end":{"line":60,"column":49,"offset":4573},"indent":[2]}}],"position":{"start":{"line":59,"column":3,"offset":4259},"end":{"line":60,"column":49,"offset":4573},"indent":[2]}}],"position":{"start":{"line":59,"column":1,"offset":4257},"end":{"line":60,"column":49,"offset":4573},"indent":[1]}}],"position":{"start":{"line":57,"column":1,"offset":3876},"end":{"line":60,"column":49,"offset":4573},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":62,"column":5,"offset":4579},"end":{"line":62,"column":13,"offset":4587},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4575},"end":{"line":62,"column":13,"offset":4587},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":64,"column":1,"offset":4589},"end":{"line":64,"column":156,"offset":4744},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":64,"column":156,"offset":4744},"end":{"line":64,"column":177,"offset":4765},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":64,"column":177,"offset":4765},"end":{"line":64,"column":188,"offset":4776},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":64,"column":188,"offset":4776},"end":{"line":64,"column":193,"offset":4781},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":64,"column":193,"offset":4781},"end":{"line":64,"column":379,"offset":4967},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4589},"end":{"line":64,"column":379,"offset":4967},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":66,"column":1,"offset":4969},"end":{"line":66,"column":68,"offset":5036},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":4969},"end":{"line":66,"column":68,"offset":5036},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":68,"column":4,"offset":5041},"end":{"line":68,"column":13,"offset":5050},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":5038},"end":{"line":68,"column":13,"offset":5050},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":70,"column":1,"offset":5052},"end":{"line":70,"column":44,"offset":5095},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":70,"column":46,"offset":5097},"end":{"line":70,"column":68,"offset":5119},"indent":[]}}],"position":{"start":{"line":70,"column":44,"offset":5095},"end":{"line":70,"column":70,"offset":5121},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":70,"column":70,"offset":5121},"end":{"line":70,"column":106,"offset":5157},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":70,"column":108,"offset":5159},"end":{"line":70,"column":129,"offset":5180},"indent":[]}}],"position":{"start":{"line":70,"column":106,"offset":5157},"end":{"line":70,"column":131,"offset":5182},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":70,"column":131,"offset":5182},"end":{"line":70,"column":159,"offset":5210},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":5052},"end":{"line":70,"column":159,"offset":5210},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":73,"column":1,"offset":5213},"end":{"line":73,"column":31,"offset":5243},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":73,"column":31,"offset":5243}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n
    \n
  1. {`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers.`}
    2. \n
  2. {`In addtionation to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}
    3. \n
\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-1c11a37c3496fd2d44549ab8cf405d6b.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-1c11a37c3496fd2d44549ab8cf405d6b.json index c20a9eb..5e8d25f 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-1c11a37c3496fd2d44549ab8cf405d6b.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-1c11a37c3496fd2d44549ab8cf405d6b.json @@ -1 +1 @@ -{"expireTime":9007200861747674000,"key":"gatsby-plugin-mdx-entire-payload-9f922540cc95db8e5a0d8c1da3a926de-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Kerberos Storage - Recycle Mechanism","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":39,"offset":197},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":39,"offset":197},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to storing your recordings, cleaning up is also important. You have to avoid your disk being filled up and locking up the entire system and cluster. Therefore we have build a recycle service called Kerberos Storage Recycle, which you can use to remove recordings based on different rules.","position":{"start":{"line":10,"column":1,"offset":199},"end":{"line":10,"column":294,"offset":492},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":199},"end":{"line":10,"column":294,"offset":492},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":12,"column":4,"offset":497},"end":{"line":12,"column":17,"offset":510},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":494},"end":{"line":12,"column":17,"offset":510},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This installation guide assumes you have setup Kerberos Storage properly.","position":{"start":{"line":14,"column":1,"offset":512},"end":{"line":14,"column":74,"offset":585},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":512},"end":{"line":14,"column":74,"offset":585},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Installation","position":{"start":{"line":16,"column":4,"offset":590},"end":{"line":16,"column":16,"offset":602},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":587},"end":{"line":16,"column":16,"offset":602},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Modify the MongoDB credentials, as you did for the Kerberos Storage yaml file.","position":{"start":{"line":18,"column":1,"offset":604},"end":{"line":18,"column":79,"offset":682},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":604},"end":{"line":18,"column":79,"offset":682},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":20,"column":1,"offset":684},"end":{"line":23,"column":30,"offset":803},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Execute following script to deploy the recycle job.","position":{"start":{"line":25,"column":1,"offset":805},"end":{"line":25,"column":52,"offset":856},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":805},"end":{"line":25,"column":52,"offset":856},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/storage\nkubectl apply -f ./storage/yaml/deployment-cleanup.yaml","position":{"start":{"line":27,"column":1,"offset":858},"end":{"line":28,"column":60,"offset":970},"indent":[1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":31,"column":1,"offset":973},"end":{"line":31,"column":31,"offset":1003},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":31,"column":31,"offset":1003}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Kerberos Storage - Recycle Mechanism`}

\n

{`Next to storing your recordings, cleaning up is also important. You have to avoid your disk being filled up and locking up the entire system and cluster. Therefore we have build a recycle service called Kerberos Storage Recycle, which you can use to remove recordings based on different rules.`}

\n

{`Prerequisites`}

\n

{`This installation guide assumes you have setup Kerberos Storage properly.`}

\n

{`Installation`}

\n

{`Modify the MongoDB credentials, as you did for the Kerberos Storage yaml file.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Execute following script to deploy the recycle job.`}

\n 
{`git clone https://github.com/kerberos-io/storage`}{`\n`}{`kubectl apply -f ./storage/yaml/deployment-cleanup.yaml`}
\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750178000,"key":"gatsby-plugin-mdx-entire-payload-9f922540cc95db8e5a0d8c1da3a926de-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Kerberos Storage - Recycle Mechanism","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":39,"offset":197},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":39,"offset":197},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to storing your recordings, cleaning up is also important. You have to avoid your disk being filled up and locking up the entire system and cluster. Therefore we have build a recycle service called Kerberos Storage Recycle, which you can use to remove recordings based on different rules.","position":{"start":{"line":10,"column":1,"offset":199},"end":{"line":10,"column":294,"offset":492},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":199},"end":{"line":10,"column":294,"offset":492},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":12,"column":4,"offset":497},"end":{"line":12,"column":17,"offset":510},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":494},"end":{"line":12,"column":17,"offset":510},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This installation guide assumes you have setup Kerberos Storage properly.","position":{"start":{"line":14,"column":1,"offset":512},"end":{"line":14,"column":74,"offset":585},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":512},"end":{"line":14,"column":74,"offset":585},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Installation","position":{"start":{"line":16,"column":4,"offset":590},"end":{"line":16,"column":16,"offset":602},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":587},"end":{"line":16,"column":16,"offset":602},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Modify the MongoDB credentials, as you did for the Kerberos Storage yaml file.","position":{"start":{"line":18,"column":1,"offset":604},"end":{"line":18,"column":79,"offset":682},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":604},"end":{"line":18,"column":79,"offset":682},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":20,"column":1,"offset":684},"end":{"line":23,"column":30,"offset":803},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Execute following script to deploy the recycle job.","position":{"start":{"line":25,"column":1,"offset":805},"end":{"line":25,"column":52,"offset":856},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":805},"end":{"line":25,"column":52,"offset":856},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/storage\nkubectl apply -f ./storage/yaml/deployment-cleanup.yaml","position":{"start":{"line":27,"column":1,"offset":858},"end":{"line":28,"column":60,"offset":970},"indent":[1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":31,"column":1,"offset":973},"end":{"line":31,"column":31,"offset":1003},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":31,"column":31,"offset":1003}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Kerberos Storage - Recycle Mechanism`}

\n

{`Next to storing your recordings, cleaning up is also important. You have to avoid your disk being filled up and locking up the entire system and cluster. Therefore we have build a recycle service called Kerberos Storage Recycle, which you can use to remove recordings based on different rules.`}

\n

{`Prerequisites`}

\n

{`This installation guide assumes you have setup Kerberos Storage properly.`}

\n

{`Installation`}

\n

{`Modify the MongoDB credentials, as you did for the Kerberos Storage yaml file.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Execute following script to deploy the recycle job.`}

\n 
{`git clone https://github.com/kerberos-io/storage`}{`\n`}{`kubectl apply -f ./storage/yaml/deployment-cleanup.yaml`}
\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-1d35799b0fd4a99ff0dbdd3b2f81aebf.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-1d35799b0fd4a99ff0dbdd3b2f81aebf.json index 3db29bc..696166e 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-1d35799b0fd4a99ff0dbdd3b2f81aebf.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-1d35799b0fd4a99ff0dbdd3b2f81aebf.json @@ -1 +1 @@ -{"expireTime":9007200861747685000,"key":"gatsby-plugin-mdx-entire-payload-13c4772d8dccd98e23ab4094aa241345-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Contribute","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In this document we describe the different things you need to know if you would like to add a new feature to Kerberos Open Source, or change some of its behaviour for your own use case.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":10,"column":186,"offset":358},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":10,"column":186,"offset":358},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before starting, as you might have read already, you need to know that Kerberos Open Source consists of two solutions. A front-end, also called ","position":{"start":{"line":12,"column":1,"offset":360},"end":{"line":12,"column":145,"offset":504},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"web","position":{"start":{"line":12,"column":147,"offset":506},"end":{"line":12,"column":150,"offset":509},"indent":[]}}],"position":{"start":{"line":12,"column":145,"offset":504},"end":{"line":12,"column":152,"offset":511},"indent":[]}},{"type":"text","value":", which allows you to review the recordings and to configure the back-end settings. A back-end, also called ","position":{"start":{"line":12,"column":152,"offset":511},"end":{"line":12,"column":260,"offset":619},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"machinery","position":{"start":{"line":12,"column":262,"offset":621},"end":{"line":12,"column":271,"offset":630},"indent":[]}}],"position":{"start":{"line":12,"column":260,"offset":619},"end":{"line":12,"column":273,"offset":632},"indent":[]}},{"type":"text","value":", which is computer vision solution that processes the video stream of surveillance camera.","position":{"start":{"line":12,"column":273,"offset":632},"end":{"line":12,"column":364,"offset":723},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":360},"end":{"line":12,"column":364,"offset":723},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you start changing or adding features to Kerberos Open Source, there is a big chance you will need to modify the previously mentioned solutions. That's why we will discuss how you can contribute to one or both solutions.","position":{"start":{"line":14,"column":1,"offset":725},"end":{"line":14,"column":226,"offset":950},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":725},"end":{"line":14,"column":226,"offset":950},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":16,"column":4,"offset":955},"end":{"line":16,"column":13,"offset":964},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":952},"end":{"line":16,"column":13,"offset":964},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Contributing to the ","position":{"start":{"line":18,"column":1,"offset":966},"end":{"line":18,"column":21,"offset":986},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery","children":[{"type":"text","value":"machinery repository","position":{"start":{"line":18,"column":22,"offset":987},"end":{"line":18,"column":42,"offset":1007},"indent":[]}}],"position":{"start":{"line":18,"column":21,"offset":986},"end":{"line":18,"column":85,"offset":1050},"indent":[]}},{"type":"text","value":" requires C++ skills. This section describes all the technical stuff you will need to know. If you want to contribute, the first thing you will need to do is installing the source code on your working station.","position":{"start":{"line":18,"column":85,"offset":1050},"end":{"line":18,"column":294,"offset":1259},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":966},"end":{"line":18,"column":294,"offset":1259},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":20,"column":5,"offset":1265},"end":{"line":20,"column":18,"offset":1278},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1261},"end":{"line":20,"column":18,"offset":1278},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"A Linux OS, or Mac OSX (Window is not supported).","position":{"start":{"line":22,"column":3,"offset":1282},"end":{"line":22,"column":52,"offset":1331},"indent":[]}}],"position":{"start":{"line":22,"column":3,"offset":1282},"end":{"line":22,"column":52,"offset":1331},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1280},"end":{"line":22,"column":52,"offset":1331},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Installation","position":{"start":{"line":24,"column":5,"offset":1337},"end":{"line":24,"column":17,"offset":1349},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1333},"end":{"line":24,"column":17,"offset":1349},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The complete installation can be found on the advanced installation page, describing the complete set of instructions. However for simplicity we will give a summarized version, as probably you will already have a development environment set up.","position":{"start":{"line":26,"column":1,"offset":1351},"end":{"line":26,"column":245,"offset":1595},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1351},"end":{"line":26,"column":245,"offset":1595},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Install development tools (C++, CMake) and V4L utils, and clone the repository. Compile the project using cmake and make.","position":{"start":{"line":28,"column":1,"offset":1597},"end":{"line":28,"column":122,"offset":1718},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1597},"end":{"line":28,"column":122,"offset":1718},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo apt-get -y update\nsudo apt-get install -y git cmake subversion dh-autoreconf libcurl4-openssl-dev yasm libx264-dev pkg-config libssl-dev\ncd && sudo git clone https://github.com/kerberos-io/machinery\ncd machinery && mkdir build && cd build\ncmake .. && make -j8 && make check && sudo make install","position":{"start":{"line":30,"column":1,"offset":1720},"end":{"line":36,"column":4,"offset":2029},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Testing","position":{"start":{"line":38,"column":5,"offset":2035},"end":{"line":38,"column":12,"offset":2042},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2031},"end":{"line":38,"column":12,"offset":2042},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"We strongly recommend testing as a best practice in complex projects. Therefore the machinery uses the popular C++ test library: Google Test and Google Mock. The tests can be found in the test directory. You can run the test by executing following command:","position":{"start":{"line":40,"column":1,"offset":2044},"end":{"line":40,"column":257,"offset":2300},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2044},"end":{"line":40,"column":257,"offset":2300},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"make check","position":{"start":{"line":42,"column":1,"offset":2302},"end":{"line":44,"column":4,"offset":2322},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Adding a new class","position":{"start":{"line":46,"column":5,"offset":2328},"end":{"line":46,"column":23,"offset":2346},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":2324},"end":{"line":46,"column":23,"offset":2346},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This paragraph will tell you how to create a new condition, algorithm, expositor, io or capture device. For simplicity we will show how to create a new algorithm; the steps are identical if you want to create for example a new capture device; only the directory will differ.","position":{"start":{"line":48,"column":1,"offset":2348},"end":{"line":48,"column":275,"offset":2622},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":2348},"end":{"line":48,"column":275,"offset":2622},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Create the header file","position":{"start":{"line":50,"column":6,"offset":2629},"end":{"line":50,"column":28,"offset":2651},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2624},"end":{"line":50,"column":28,"offset":2651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"First we will need to create a new header file in the include/kerberos/machinery/algorithm directory. You can copy an existing algorithm header file, and start from there. You will end up with the following header file:","position":{"start":{"line":52,"column":1,"offset":2653},"end":{"line":52,"column":220,"offset":2872},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":2653},"end":{"line":52,"column":220,"offset":2872},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"//\n// Class: AnotherAlgorithm\n// Description: Another algorithm\n// Created: ...\n// Author: ...\n// Mail: ...\n// Website: ...\n//\n// The copyright to the computer program(s) herein\n// is the property of kerberos.io, Belgium.\n// The program(s) may be used and/or copied .\n//\n/////////////////////////////////////////////////////\n#ifndef __AnotherAlgorithm_H_INCLUDED__ // if AnotherAlgorithm.h hasn't been included yet...\n#define __AnotherAlgorithm_H_INCLUDED__ // #define this so the compiler knows it has been included\n#include \"machinery/algorithm/Algorithm.h\"\nnamespace kerberos\n{\n\tchar AnotherAlgorithmName[] = \"AnotherAlgorithm\";\n\tclass AnotherAlgorithm : public AlgorithmCreator\n\t{\n \tprivate:\n \t\tImage m_result;\n \tint m_parameter;\n \tpublic:\n \tAnotherAlgorithm(){}\n \tvoid setup(const StringMap & settings);\n \tvoid initialize(ImageVector & images);\n \tImage evaluate(ImageVector & images, JSON & data);\n \tvoid setParameter(int parameter);\n\t};\n}\n#endif","position":{"start":{"line":54,"column":1,"offset":2874},"end":{"line":88,"column":4,"offset":3959},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"When creating a new class you will need to inherit from it corresponding creator, for the algorithm example: AlgorithmCreator. The creator class requires two template parameters. The first one is a unique name for the class, this name will be used to make some kind of dependency injection possible; and is used in the configurations files. The second parameter is the class itself.","position":{"start":{"line":90,"column":1,"offset":3961},"end":{"line":90,"column":383,"offset":4343},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":3961},"end":{"line":90,"column":383,"offset":4343},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The inheritance of the creator class can be a little bit strange, but it is required and needed to register the class automatically with the factory. When the code gets compiled, the classes will be automatically registered with the factory, and you can create instances of those classes by using the name we've defined in the first template parameter. For example we could create a new instance of our previously created class with the following command.","position":{"start":{"line":92,"column":1,"offset":4345},"end":{"line":92,"column":456,"offset":4800},"indent":[]}}],"position":{"start":{"line":92,"column":1,"offset":4345},"end":{"line":92,"column":456,"offset":4800},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"Algorithm * anotherAlgorithm = Factory::getInstance()->create(\"AnotherAlgorithm\");","position":{"start":{"line":94,"column":1,"offset":4802},"end":{"line":96,"column":4,"offset":4905},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Create the source file","position":{"start":{"line":98,"column":6,"offset":4912},"end":{"line":98,"column":28,"offset":4934},"indent":[]}}],"position":{"start":{"line":98,"column":1,"offset":4907},"end":{"line":98,"column":28,"offset":4934},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Ofcourse we also need to have an implementation file, therefore we need to create a new source file in the src/kerberos/machinery/algorithm directory. Just like the previous example, you can copy an existing class and implement the member functions you've declared in the header file. An example would be:","position":{"start":{"line":100,"column":1,"offset":4936},"end":{"line":100,"column":306,"offset":5241},"indent":[]}}],"position":{"start":{"line":100,"column":1,"offset":4936},"end":{"line":100,"column":306,"offset":5241},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"#include \"machinery/algorithm/AnotherAlgorithm.h\"\nnamespace kerberos\n{\n void AnotherAlgorithm::setup(const StringMap & settings)\n {\n Algorithm::setup(settings);\n int parameter = std::atoi(settings.at(\"algorithms.AnotherAlgorithm.parameter\").c_str());\n setParameter(parameter);\n }\n void AnotherAlgorithm::initialize(ImageVector & images)\n {\n ....\n }\n Image AnotherAlgorithm::evaluate(ImageVector & images, JSON & data)\n {\n Image evaluation;\n ... do something ..\n return evaluation;\n }\n void AnotherAlgorithm::setParameter(int parameter)\n {\n m_parameter = parameter;\n }\n}","position":{"start":{"line":102,"column":1,"offset":5243},"end":{"line":127,"column":4,"offset":5914},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Modify the CMakeLists.txt file","position":{"start":{"line":129,"column":6,"offset":5921},"end":{"line":129,"column":36,"offset":5951},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":5916},"end":{"line":129,"column":36,"offset":5951},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Open the CMakeLists.txt in the src/kerberos directory file and append the name of the algorithm class to the KERBEROS_FACTORY_ENTITIES variable; for example machinery/algorithm/AnotherAlgorithm.cpp.","position":{"start":{"line":131,"column":1,"offset":5953},"end":{"line":131,"column":199,"offset":6151},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":5953},"end":{"line":131,"column":199,"offset":6151},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"# -------------------------------------------------------\n# Entities that have to be registered with the factory\n# - classes are registered on compile time, so they\n# don't belong to a library. New algorithms, expositors\n# or Io classes belong here.\nset(KERBEROS_FACTORY_ENTITIES\n capture/USBCamera.cpp\n machinery/condition/Time.cpp\n machinery/condition/Enabled.cpp\n machinery/algorithm/DifferentialCollins.cpp\n machinery/algorithm/DifferentialCollinsWithColor.cpp\n machinery/algorithm/AnotherAlgorithm.cpp\n machinery/expositor/RectangleExpositor.cpp\n machinery/expositor/HullExpositor.cpp\n machinery/heuristic/Sequence.cpp\n machinery/io/IoDisk.cpp\n machinery/io/IoTCP.cpp\n machinery/io/IoMongoDB.cpp\n)","position":{"start":{"line":133,"column":1,"offset":6153},"end":{"line":153,"column":4,"offset":6907},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Create a new entry in the config file","position":{"start":{"line":155,"column":6,"offset":6914},"end":{"line":155,"column":43,"offset":6951},"indent":[]}}],"position":{"start":{"line":155,"column":1,"offset":6909},"end":{"line":155,"column":43,"offset":6951},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Open the algorithm.xml file in the config directory, and add a new tag with exactly the same name you've used in the header file; so in our example \"AnotherAlgorithm\". Within the new tag we can add properties that we will be use to configure our algorithm, in our example we defined a field parameter so we can add this field in the config file.","position":{"start":{"line":157,"column":1,"offset":6953},"end":{"line":157,"column":346,"offset":7298},"indent":[]}}],"position":{"start":{"line":157,"column":1,"offset":6953},"end":{"line":157,"column":346,"offset":7298},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One thing you will need to do is to attach a type to a property. The type will be used by the web to automatically render the properties. For simplicity we can use the type number, this will show an input box on the settings page of the web where we are able to add numbers.","position":{"start":{"line":159,"column":1,"offset":7300},"end":{"line":159,"column":275,"offset":7574},"indent":[]}}],"position":{"start":{"line":159,"column":1,"offset":7300},"end":{"line":159,"column":275,"offset":7574},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"\n\t\n\t\t5\n \n","position":{"start":{"line":161,"column":1,"offset":7576},"end":{"line":167,"column":4,"offset":7697},"indent":[1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"You can retrieve the parameter in the setup function with the settings parameter.","position":{"start":{"line":169,"column":1,"offset":7699},"end":{"line":169,"column":82,"offset":7780},"indent":[]}}],"position":{"start":{"line":169,"column":1,"offset":7699},"end":{"line":169,"column":82,"offset":7780},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"settings.at(\"algorithms.AnotherAlgorithm.parameter\")","position":{"start":{"line":171,"column":1,"offset":7782},"end":{"line":173,"column":4,"offset":7844},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Compile","position":{"start":{"line":175,"column":5,"offset":7850},"end":{"line":175,"column":12,"offset":7857},"indent":[]}}],"position":{"start":{"line":175,"column":1,"offset":7846},"end":{"line":175,"column":12,"offset":7857},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Hurray, we've made it! So now you can compile the code again, and if you're using an IDE don't forget to include the new source file! If you are compiling from the command-line you just have to go to the build folder and write make.","position":{"start":{"line":177,"column":1,"offset":7859},"end":{"line":177,"column":233,"offset":8091},"indent":[]}}],"position":{"start":{"line":177,"column":1,"offset":7859},"end":{"line":177,"column":233,"offset":8091},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Web","position":{"start":{"line":179,"column":4,"offset":8096},"end":{"line":179,"column":7,"offset":8099},"indent":[]}}],"position":{"start":{"line":179,"column":1,"offset":8093},"end":{"line":179,"column":7,"offset":8099},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Contributing to ","position":{"start":{"line":181,"column":1,"offset":8101},"end":{"line":181,"column":17,"offset":8117},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web","children":[{"type":"text","value":"the web repository","position":{"start":{"line":181,"column":18,"offset":8118},"end":{"line":181,"column":36,"offset":8136},"indent":[]}}],"position":{"start":{"line":181,"column":17,"offset":8117},"end":{"line":181,"column":73,"offset":8173},"indent":[]}},{"type":"text","value":" requires both front- and back-end skillls, more precisely BackboneJS (JavaScript) and Laravel 5.4 (PHP).","position":{"start":{"line":181,"column":73,"offset":8173},"end":{"line":181,"column":178,"offset":8278},"indent":[]}}],"position":{"start":{"line":181,"column":1,"offset":8101},"end":{"line":181,"column":178,"offset":8278},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":183,"column":5,"offset":8284},"end":{"line":183,"column":18,"offset":8297},"indent":[]}}],"position":{"start":{"line":183,"column":1,"offset":8280},"end":{"line":183,"column":18,"offset":8297},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Make sure you have following services installed on your working station.","position":{"start":{"line":185,"column":1,"offset":8299},"end":{"line":185,"column":73,"offset":8371},"indent":[]}}],"position":{"start":{"line":185,"column":1,"offset":8299},"end":{"line":185,"column":73,"offset":8371},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":">","position":{"start":{"line":187,"column":2,"offset":8374},"end":{"line":187,"column":4,"offset":8376},"indent":[]}},{"type":"text","value":"= PHP 7.1.0, NodeJS and NPM and Nginx or Apache","position":{"start":{"line":187,"column":4,"offset":8376},"end":{"line":187,"column":51,"offset":8423},"indent":[]}}],"position":{"start":{"line":187,"column":2,"offset":8374},"end":{"line":187,"column":51,"offset":8423},"indent":[]}}],"position":{"start":{"line":187,"column":1,"offset":8373},"end":{"line":187,"column":51,"offset":8423},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Installation","position":{"start":{"line":189,"column":5,"offset":8429},"end":{"line":189,"column":17,"offset":8441},"indent":[]}}],"position":{"start":{"line":189,"column":1,"offset":8425},"end":{"line":189,"column":17,"offset":8441},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Clone the repository to your working station.","position":{"start":{"line":191,"column":1,"offset":8443},"end":{"line":191,"column":46,"offset":8488},"indent":[]}}],"position":{"start":{"line":191,"column":1,"offset":8443},"end":{"line":191,"column":46,"offset":8488},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"git clone https://github.com/kerberos-io/web\ncd web","position":{"start":{"line":193,"column":1,"offset":8490},"end":{"line":196,"column":4,"offset":8551},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Install the PHP libraries using the dependency mananger, ","position":{"start":{"line":198,"column":1,"offset":8553},"end":{"line":198,"column":58,"offset":8610},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Composer","position":{"start":{"line":198,"column":60,"offset":8612},"end":{"line":198,"column":68,"offset":8620},"indent":[]}}],"position":{"start":{"line":198,"column":58,"offset":8610},"end":{"line":198,"column":70,"offset":8622},"indent":[]}},{"type":"text","value":". If you haven't installed composer execute following commands.","position":{"start":{"line":198,"column":70,"offset":8622},"end":{"line":198,"column":133,"offset":8685},"indent":[]}}],"position":{"start":{"line":198,"column":1,"offset":8553},"end":{"line":198,"column":133,"offset":8685},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"php -r \"readfile('https://getcomposer.org/installer');\" > composer-setup.php\nphp -r \"if (hash('SHA384', file_get_contents('composer-setup.php')) === '41e71d86b40f28e771d4bb662b997f79625196afcca95a5abf44391188c695c6c1456e16154c75a211d238cc3bc5cb47') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;\"\nphp composer-setup.php\nphp -r \"unlink('composer-setup.php');\"","position":{"start":{"line":200,"column":1,"offset":8687},"end":{"line":205,"column":4,"offset":9118},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"After a succesful installation, you can run composer install or composer update from the root of the project. All dependencies will be installed or updated if a newer version is detected.","position":{"start":{"line":207,"column":1,"offset":9120},"end":{"line":207,"column":188,"offset":9307},"indent":[]}}],"position":{"start":{"line":207,"column":1,"offset":9120},"end":{"line":207,"column":188,"offset":9307},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"composer update","position":{"start":{"line":209,"column":1,"offset":9309},"end":{"line":211,"column":4,"offset":9334},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Besides PHP, the project also relies on BackboneJS (Javascript) for the front-end. Therefore a couple JavaScript dependencies should be installed.","position":{"start":{"line":213,"column":1,"offset":9336},"end":{"line":213,"column":147,"offset":9482},"indent":[]}}],"position":{"start":{"line":213,"column":1,"offset":9336},"end":{"line":213,"column":147,"offset":9482},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"npm -g install bower\ncd public\nbower update","position":{"start":{"line":215,"column":1,"offset":9484},"end":{"line":219,"column":4,"offset":9537},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"When everything is installed properly, you need too link the web project with your applicationn server. Read more on the ","position":{"start":{"line":221,"column":1,"offset":9539},"end":{"line":221,"column":122,"offset":9660},"indent":[]}},{"type":"link","title":null,"url":"https://laravel.com/docs/5.8/deployment","children":[{"type":"text","value":"Laravel documentation website","position":{"start":{"line":221,"column":123,"offset":9661},"end":{"line":221,"column":152,"offset":9690},"indent":[]}}],"position":{"start":{"line":221,"column":122,"offset":9660},"end":{"line":221,"column":194,"offset":9732},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":221,"column":194,"offset":9732},"end":{"line":221,"column":195,"offset":9733},"indent":[]}}],"position":{"start":{"line":221,"column":1,"offset":9539},"end":{"line":221,"column":195,"offset":9733},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":224,"column":1,"offset":9736},"end":{"line":224,"column":31,"offset":9766},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":224,"column":31,"offset":9766}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Contribute`}

\n

{`In this document we describe the different things you need to know if you would like to add a new feature to Kerberos Open Source, or change some of its behaviour for your own use case.`}

\n

{`Before starting, as you might have read already, you need to know that Kerberos Open Source consists of two solutions. A front-end, also called `}{`web`}{`, which allows you to review the recordings and to configure the back-end settings. A back-end, also called `}{`machinery`}{`, which is computer vision solution that processes the video stream of surveillance camera.`}

\n

{`Once you start changing or adding features to Kerberos Open Source, there is a big chance you will need to modify the previously mentioned solutions. That's why we will discuss how you can contribute to one or both solutions.`}

\n

{`Machinery`}

\n

{`Contributing to the `}{`machinery repository`}{` requires C++ skills. This section describes all the technical stuff you will need to know. If you want to contribute, the first thing you will need to do is installing the source code on your working station.`}

\n

{`Prerequisites`}

\n
\n

{`A Linux OS, or Mac OSX (Window is not supported).`}

\n
\n

{`Installation`}

\n

{`The complete installation can be found on the advanced installation page, describing the complete set of instructions. However for simplicity we will give a summarized version, as probably you will already have a development environment set up.`}

\n

{`Install development tools (C++, CMake) and V4L utils, and clone the repository. Compile the project using cmake and make.`}

\n 
{`sudo`}{` `}{`apt`}{`-`}{`get`}{` -`}{`y`}{` `}{`update`}{`\n`}{`sudo`}{` `}{`apt`}{`-`}{`get`}{` `}{`install`}{` -`}{`y`}{` `}{`git`}{` `}{`cmake`}{` `}{`subversion`}{` `}{`dh`}{`-`}{`autoreconf`}{` `}{`libcurl4`}{`-`}{`openssl`}{`-`}{`dev`}{` `}{`yasm`}{` `}{`libx264`}{`-`}{`dev`}{` `}{`pkg`}{`-`}{`config`}{` `}{`libssl`}{`-`}{`dev`}{`\n`}{`cd`}{` && `}{`sudo`}{` `}{`git`}{` `}{`clone`}{` https:`}{`//github.com/kerberos-io/machinery`}{`\n`}{`cd`}{` `}{`machinery`}{` && `}{`mkdir`}{` `}{`build`}{` && `}{`cd`}{` `}{`build`}{`\n`}{`cmake`}{` .. && `}{`make`}{` -`}{`j8`}{` && `}{`make`}{` `}{`check`}{` && `}{`sudo`}{` `}{`make`}{` `}{`install`}
\n

{`Testing`}

\n

{`We strongly recommend testing as a best practice in complex projects. Therefore the machinery uses the popular C++ test library: Google Test and Google Mock. The tests can be found in the test directory. You can run the test by executing following command:`}

\n 
{`make`}{` `}{`check`}
\n

{`Adding a new class`}

\n

{`This paragraph will tell you how to create a new condition, algorithm, expositor, io or capture device. For simplicity we will show how to create a new algorithm; the steps are identical if you want to create for example a new capture device; only the directory will differ.`}

\n

{`Create the header file`}

\n

{`First we will need to create a new header file in the include/kerberos/machinery/algorithm directory. You can copy an existing algorithm header file, and start from there. You will end up with the following header file:`}

\n 
{`//`}{`\n`}{`//  Class: AnotherAlgorithm`}{`\n`}{`//  Description: Another algorithm`}{`\n`}{`//  Created:     ...`}{`\n`}{`//  Author:      ...`}{`\n`}{`//  Mail:        ...`}{`\n`}{`//  Website:     ...`}{`\n`}{`//`}{`\n`}{`//  The copyright to the computer program(s) herein`}{`\n`}{`//  is the property of kerberos.io, Belgium.`}{`\n`}{`//  The program(s) may be used and/or copied .`}{`\n`}{`//`}{`\n`}{`/////////////////////////////////////////////////////`}{`\n`}{`#`}{`ifndef`}{` `}{`__AnotherAlgorithm_H_INCLUDED__`}{`   `}{`// if AnotherAlgorithm.h hasn't been included yet...`}{`\n`}{`#`}{`define`}{` `}{`__AnotherAlgorithm_H_INCLUDED__`}{`   `}{`// #define this so the compiler knows it has been included`}{`\n`}{`#`}{`include`}{` `}{`\"machinery/algorithm/Algorithm.h\"`}{`\n`}{`namespace`}{` `}{`kerberos`}{`\n`}{`{`}{`\n`}{`\t`}{`char`}{` `}{`AnotherAlgorithmName`}{`[] = `}{`\"AnotherAlgorithm\"`}{`;`}{`\n`}{`\t`}{`class`}{` `}{`AnotherAlgorithm`}{` : `}{`public`}{` `}{`AlgorithmCreator`}{`<`}{`AnotherAlgorithmName`}{`, `}{`AnotherAlgorithm`}{`>`}{`\n`}{`\t{`}{`\n`}{`    \t`}{`private`}{`:`}{`\n`}{`    \t\t`}{`Image`}{` `}{`m_result`}{`;`}{`\n`}{`        \t`}{`int`}{` `}{`m_parameter`}{`;`}{`\n`}{`    \t`}{`public`}{`:`}{`\n`}{`        \t`}{`AnotherAlgorithm`}{`(){}`}{`\n`}{`        \t`}{`void`}{` `}{`setup`}{`(`}{`const`}{` `}{`StringMap`}{` & `}{`settings`}{`);`}{`\n`}{`        \t`}{`void`}{` `}{`initialize`}{`(`}{`ImageVector`}{` & `}{`images`}{`);`}{`\n`}{`        \t`}{`Image`}{` `}{`evaluate`}{`(`}{`ImageVector`}{` & `}{`images`}{`, `}{`JSON`}{` & `}{`data`}{`);`}{`\n`}{`        \t`}{`void`}{` `}{`setParameter`}{`(`}{`int`}{` `}{`parameter`}{`);`}{`\n`}{`\t};`}{`\n`}{`}`}{`\n`}{`#`}{`endif`}
\n

{`When creating a new class you will need to inherit from it corresponding creator, for the algorithm example: AlgorithmCreator. The creator class requires two template parameters. The first one is a unique name for the class, this name will be used to make some kind of dependency injection possible; and is used in the configurations files. The second parameter is the class itself.`}

\n

{`The inheritance of the creator class can be a little bit strange, but it is required and needed to register the class automatically with the factory. When the code gets compiled, the classes will be automatically registered with the factory, and you can create instances of those classes by using the name we've defined in the first template parameter. For example we could create a new instance of our previously created class with the following command.`}

\n 
{`Algorithm`}{` * `}{`anotherAlgorithm`}{` = `}{`Factory`}{`<`}{`Algorithm`}{`>::`}{`getInstance`}{`()->`}{`create`}{`(`}{`\"AnotherAlgorithm\"`}{`);`}
\n

{`Create the source file`}

\n

{`Ofcourse we also need to have an implementation file, therefore we need to create a new source file in the src/kerberos/machinery/algorithm directory. Just like the previous example, you can copy an existing class and implement the member functions you've declared in the header file. An example would be:`}

\n 
{`#`}{`include`}{` `}{`\"machinery/algorithm/AnotherAlgorithm.h\"`}{`\n`}{`namespace`}{` `}{`kerberos`}{`\n`}{`{`}{`\n`}{`    `}{`void`}{` AnotherAlgorithm::`}{`setup`}{`(`}{`const`}{` `}{`StringMap`}{` & `}{`settings`}{`)`}{`\n`}{`    {`}{`\n`}{`        Algorithm::`}{`setup`}{`(`}{`settings`}{`);`}{`\n`}{`        `}{`int`}{` `}{`parameter`}{` = std::`}{`atoi`}{`(`}{`settings`}{`.`}{`at`}{`(`}{`\"algorithms.AnotherAlgorithm.parameter\"`}{`).`}{`c_str`}{`());`}{`\n`}{`        `}{`setParameter`}{`(`}{`parameter`}{`);`}{`\n`}{`    }`}{`\n`}{`    `}{`void`}{` AnotherAlgorithm::`}{`initialize`}{`(`}{`ImageVector`}{` & `}{`images`}{`)`}{`\n`}{`    {`}{`\n`}{`        ....`}{`\n`}{`    }`}{`\n`}{`    `}{`Image`}{` AnotherAlgorithm::`}{`evaluate`}{`(`}{`ImageVector`}{` & `}{`images`}{`, `}{`JSON`}{` & `}{`data`}{`)`}{`\n`}{`    {`}{`\n`}{`        `}{`Image`}{` `}{`evaluation`}{`;`}{`\n`}{`        ... `}{`do`}{` `}{`something`}{` ..`}{`\n`}{`        `}{`return`}{` `}{`evaluation`}{`;`}{`\n`}{`    }`}{`\n`}{`    `}{`void`}{` AnotherAlgorithm::`}{`setParameter`}{`(`}{`int`}{` `}{`parameter`}{`)`}{`\n`}{`    {`}{`\n`}{`        `}{`m_parameter`}{` = `}{`parameter`}{`;`}{`\n`}{`    }`}{`\n`}{`}`}
\n

{`Modify the CMakeLists.txt file`}

\n

{`Open the CMakeLists.txt in the src/kerberos directory file and append the name of the algorithm class to the KERBEROS_FACTORY_ENTITIES variable; for example machinery/algorithm/AnotherAlgorithm.cpp.`}

\n 
{`# -------------------------------------------------------`}{`\n`}{`# `}{`Entities`}{` `}{`that`}{` `}{`have`}{` `}{`to`}{` `}{`be`}{` `}{`registered`}{` `}{`with`}{` `}{`the`}{` `}{`factory`}{`\n`}{`#   - `}{`classes`}{` `}{`are`}{` `}{`registered`}{` `}{`on`}{` `}{`compile`}{` `}{`time`}{`, `}{`so`}{` `}{`they`}{`\n`}{`#   `}{`don`}{`'t belong to a library. New algorithms, expositor`}{`s`}{`\n`}{`#   `}{`or`}{` `}{`Io`}{` `}{`classes`}{` `}{`belong`}{` `}{`here`}{`.`}{`\n`}{`set`}{`(`}{`KERBEROS_FACTORY_ENTITIES`}{`\n`}{`    `}{`capture`}{`/`}{`USBCamera`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`condition`}{`/`}{`Time`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`condition`}{`/`}{`Enabled`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`algorithm`}{`/`}{`DifferentialCollins`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`algorithm`}{`/`}{`DifferentialCollinsWithColor`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`algorithm`}{`/`}{`AnotherAlgorithm`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`expositor`}{`/`}{`RectangleExpositor`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`expositor`}{`/`}{`HullExpositor`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`heuristic`}{`/`}{`Sequence`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`io`}{`/`}{`IoDisk`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`io`}{`/`}{`IoTCP`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`io`}{`/`}{`IoMongoDB`}{`.`}{`cpp`}{`\n`}{`)`}
\n

{`Create a new entry in the config file`}

\n

{`Open the algorithm.xml file in the config directory, and add a new tag with exactly the same name you've used in the header file; so in our example \"AnotherAlgorithm\". Within the new tag we can add properties that we will be use to configure our algorithm, in our example we defined a field parameter so we can add this field in the config file.`}

\n

{`One thing you will need to do is to attach a type to a property. The type will be used by the web to automatically render the properties. For simplicity we can use the type number, this will show an input box on the settings page of the web where we are able to add numbers.`}

\n 
{`<`}{`algorithms`}{`>`}{`\n`}{`\t<`}{`AnotherAlgorithm`}{`>`}{`\n`}{`\t\t<`}{`parameter`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`5`}{`{`parameter`}{`>`}{`\n`}{`    {`AnotherAlgorithm`}{`>`}{`\n`}{`{`algorithms`}{`>`}
\n

{`You can retrieve the parameter in the setup function with the settings parameter.`}

\n 
{`settings`}{`.`}{`at`}{`(`}{`\"algorithms.AnotherAlgorithm.parameter\"`}{`)`}
\n

{`Compile`}

\n

{`Hurray, we've made it! So now you can compile the code again, and if you're using an IDE don't forget to include the new source file! If you are compiling from the command-line you just have to go to the build folder and write make.`}

\n

{`Web`}

\n

{`Contributing to `}{`the web repository`}{` requires both front- and back-end skillls, more precisely BackboneJS (JavaScript) and Laravel 5.4 (PHP).`}

\n

{`Prerequisites`}

\n

{`Make sure you have following services installed on your working station.`}

\n
\n

{`>`}{`= PHP 7.1.0, NodeJS and NPM and Nginx or Apache`}

\n
\n

{`Installation`}

\n

{`Clone the repository to your working station.`}

\n 
{`git`}{` `}{`clone`}{` https:`}{`//github.com/kerberos-io/web`}{`\n`}{`cd`}{` `}{`web`}
\n

{`Install the PHP libraries using the dependency mananger, `}{`Composer`}{`. If you haven't installed composer execute following commands.`}

\n 
{`php`}{` -`}{`r`}{` `}{`\"readfile('https://getcomposer.org/installer');\"`}{` > `}{`composer`}{`-`}{`setup`}{`.`}{`php`}{`\n`}{`php`}{` -`}{`r`}{` `}{`\"if (hash('SHA384', file_get_contents('composer-setup.php')) === '41e71d86b40f28e771d4bb662b997f79625196afcca95a5abf44391188c695c6c1456e16154c75a211d238cc3bc5cb47') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;\"`}{`\n`}{`php`}{` `}{`composer`}{`-`}{`setup`}{`.`}{`php`}{`\n`}{`php`}{` -`}{`r`}{` `}{`\"unlink('composer-setup.php');\"`}
\n

{`After a succesful installation, you can run composer install or composer update from the root of the project. All dependencies will be installed or updated if a newer version is detected.`}

\n 
{`composer`}{` `}{`update`}
\n

{`Besides PHP, the project also relies on BackboneJS (Javascript) for the front-end. Therefore a couple JavaScript dependencies should be installed.`}

\n 
{`npm`}{` -`}{`g`}{` `}{`install`}{` `}{`bower`}{`\n`}{`cd`}{` `}{`public`}{`\n`}{`bower`}{` `}{`update`}
\n

{`When everything is installed properly, you need too link the web project with your applicationn server. Read more on the `}{`Laravel documentation website`}{`.`}

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750188000,"key":"gatsby-plugin-mdx-entire-payload-13c4772d8dccd98e23ab4094aa241345-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Contribute","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In this document we describe the different things you need to know if you would like to add a new feature to Kerberos Open Source, or change some of its behaviour for your own use case.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":10,"column":186,"offset":358},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":10,"column":186,"offset":358},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before starting, as you might have read already, you need to know that Kerberos Open Source consists of two solutions. A front-end, also called ","position":{"start":{"line":12,"column":1,"offset":360},"end":{"line":12,"column":145,"offset":504},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"web","position":{"start":{"line":12,"column":147,"offset":506},"end":{"line":12,"column":150,"offset":509},"indent":[]}}],"position":{"start":{"line":12,"column":145,"offset":504},"end":{"line":12,"column":152,"offset":511},"indent":[]}},{"type":"text","value":", which allows you to review the recordings and to configure the back-end settings. A back-end, also called ","position":{"start":{"line":12,"column":152,"offset":511},"end":{"line":12,"column":260,"offset":619},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"machinery","position":{"start":{"line":12,"column":262,"offset":621},"end":{"line":12,"column":271,"offset":630},"indent":[]}}],"position":{"start":{"line":12,"column":260,"offset":619},"end":{"line":12,"column":273,"offset":632},"indent":[]}},{"type":"text","value":", which is computer vision solution that processes the video stream of surveillance camera.","position":{"start":{"line":12,"column":273,"offset":632},"end":{"line":12,"column":364,"offset":723},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":360},"end":{"line":12,"column":364,"offset":723},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you start changing or adding features to Kerberos Open Source, there is a big chance you will need to modify the previously mentioned solutions. That's why we will discuss how you can contribute to one or both solutions.","position":{"start":{"line":14,"column":1,"offset":725},"end":{"line":14,"column":226,"offset":950},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":725},"end":{"line":14,"column":226,"offset":950},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":16,"column":4,"offset":955},"end":{"line":16,"column":13,"offset":964},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":952},"end":{"line":16,"column":13,"offset":964},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Contributing to the ","position":{"start":{"line":18,"column":1,"offset":966},"end":{"line":18,"column":21,"offset":986},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery","children":[{"type":"text","value":"machinery repository","position":{"start":{"line":18,"column":22,"offset":987},"end":{"line":18,"column":42,"offset":1007},"indent":[]}}],"position":{"start":{"line":18,"column":21,"offset":986},"end":{"line":18,"column":85,"offset":1050},"indent":[]}},{"type":"text","value":" requires C++ skills. This section describes all the technical stuff you will need to know. If you want to contribute, the first thing you will need to do is installing the source code on your working station.","position":{"start":{"line":18,"column":85,"offset":1050},"end":{"line":18,"column":294,"offset":1259},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":966},"end":{"line":18,"column":294,"offset":1259},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":20,"column":5,"offset":1265},"end":{"line":20,"column":18,"offset":1278},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1261},"end":{"line":20,"column":18,"offset":1278},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"A Linux OS, or Mac OSX (Window is not supported).","position":{"start":{"line":22,"column":3,"offset":1282},"end":{"line":22,"column":52,"offset":1331},"indent":[]}}],"position":{"start":{"line":22,"column":3,"offset":1282},"end":{"line":22,"column":52,"offset":1331},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1280},"end":{"line":22,"column":52,"offset":1331},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Installation","position":{"start":{"line":24,"column":5,"offset":1337},"end":{"line":24,"column":17,"offset":1349},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1333},"end":{"line":24,"column":17,"offset":1349},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The complete installation can be found on the advanced installation page, describing the complete set of instructions. However for simplicity we will give a summarized version, as probably you will already have a development environment set up.","position":{"start":{"line":26,"column":1,"offset":1351},"end":{"line":26,"column":245,"offset":1595},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1351},"end":{"line":26,"column":245,"offset":1595},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Install development tools (C++, CMake) and V4L utils, and clone the repository. Compile the project using cmake and make.","position":{"start":{"line":28,"column":1,"offset":1597},"end":{"line":28,"column":122,"offset":1718},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1597},"end":{"line":28,"column":122,"offset":1718},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo apt-get -y update\nsudo apt-get install -y git cmake subversion dh-autoreconf libcurl4-openssl-dev yasm libx264-dev pkg-config libssl-dev\ncd && sudo git clone https://github.com/kerberos-io/machinery\ncd machinery && mkdir build && cd build\ncmake .. && make -j8 && make check && sudo make install","position":{"start":{"line":30,"column":1,"offset":1720},"end":{"line":36,"column":4,"offset":2029},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Testing","position":{"start":{"line":38,"column":5,"offset":2035},"end":{"line":38,"column":12,"offset":2042},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2031},"end":{"line":38,"column":12,"offset":2042},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"We strongly recommend testing as a best practice in complex projects. Therefore the machinery uses the popular C++ test library: Google Test and Google Mock. The tests can be found in the test directory. You can run the test by executing following command:","position":{"start":{"line":40,"column":1,"offset":2044},"end":{"line":40,"column":257,"offset":2300},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2044},"end":{"line":40,"column":257,"offset":2300},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"make check","position":{"start":{"line":42,"column":1,"offset":2302},"end":{"line":44,"column":4,"offset":2322},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Adding a new class","position":{"start":{"line":46,"column":5,"offset":2328},"end":{"line":46,"column":23,"offset":2346},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":2324},"end":{"line":46,"column":23,"offset":2346},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This paragraph will tell you how to create a new condition, algorithm, expositor, io or capture device. For simplicity we will show how to create a new algorithm; the steps are identical if you want to create for example a new capture device; only the directory will differ.","position":{"start":{"line":48,"column":1,"offset":2348},"end":{"line":48,"column":275,"offset":2622},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":2348},"end":{"line":48,"column":275,"offset":2622},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Create the header file","position":{"start":{"line":50,"column":6,"offset":2629},"end":{"line":50,"column":28,"offset":2651},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2624},"end":{"line":50,"column":28,"offset":2651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"First we will need to create a new header file in the include/kerberos/machinery/algorithm directory. You can copy an existing algorithm header file, and start from there. You will end up with the following header file:","position":{"start":{"line":52,"column":1,"offset":2653},"end":{"line":52,"column":220,"offset":2872},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":2653},"end":{"line":52,"column":220,"offset":2872},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"//\n// Class: AnotherAlgorithm\n// Description: Another algorithm\n// Created: ...\n// Author: ...\n// Mail: ...\n// Website: ...\n//\n// The copyright to the computer program(s) herein\n// is the property of kerberos.io, Belgium.\n// The program(s) may be used and/or copied .\n//\n/////////////////////////////////////////////////////\n#ifndef __AnotherAlgorithm_H_INCLUDED__ // if AnotherAlgorithm.h hasn't been included yet...\n#define __AnotherAlgorithm_H_INCLUDED__ // #define this so the compiler knows it has been included\n#include \"machinery/algorithm/Algorithm.h\"\nnamespace kerberos\n{\n\tchar AnotherAlgorithmName[] = \"AnotherAlgorithm\";\n\tclass AnotherAlgorithm : public AlgorithmCreator\n\t{\n \tprivate:\n \t\tImage m_result;\n \tint m_parameter;\n \tpublic:\n \tAnotherAlgorithm(){}\n \tvoid setup(const StringMap & settings);\n \tvoid initialize(ImageVector & images);\n \tImage evaluate(ImageVector & images, JSON & data);\n \tvoid setParameter(int parameter);\n\t};\n}\n#endif","position":{"start":{"line":54,"column":1,"offset":2874},"end":{"line":88,"column":4,"offset":3959},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"When creating a new class you will need to inherit from it corresponding creator, for the algorithm example: AlgorithmCreator. The creator class requires two template parameters. The first one is a unique name for the class, this name will be used to make some kind of dependency injection possible; and is used in the configurations files. The second parameter is the class itself.","position":{"start":{"line":90,"column":1,"offset":3961},"end":{"line":90,"column":383,"offset":4343},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":3961},"end":{"line":90,"column":383,"offset":4343},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The inheritance of the creator class can be a little bit strange, but it is required and needed to register the class automatically with the factory. When the code gets compiled, the classes will be automatically registered with the factory, and you can create instances of those classes by using the name we've defined in the first template parameter. For example we could create a new instance of our previously created class with the following command.","position":{"start":{"line":92,"column":1,"offset":4345},"end":{"line":92,"column":456,"offset":4800},"indent":[]}}],"position":{"start":{"line":92,"column":1,"offset":4345},"end":{"line":92,"column":456,"offset":4800},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"Algorithm * anotherAlgorithm = Factory::getInstance()->create(\"AnotherAlgorithm\");","position":{"start":{"line":94,"column":1,"offset":4802},"end":{"line":96,"column":4,"offset":4905},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Create the source file","position":{"start":{"line":98,"column":6,"offset":4912},"end":{"line":98,"column":28,"offset":4934},"indent":[]}}],"position":{"start":{"line":98,"column":1,"offset":4907},"end":{"line":98,"column":28,"offset":4934},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Ofcourse we also need to have an implementation file, therefore we need to create a new source file in the src/kerberos/machinery/algorithm directory. Just like the previous example, you can copy an existing class and implement the member functions you've declared in the header file. An example would be:","position":{"start":{"line":100,"column":1,"offset":4936},"end":{"line":100,"column":306,"offset":5241},"indent":[]}}],"position":{"start":{"line":100,"column":1,"offset":4936},"end":{"line":100,"column":306,"offset":5241},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"#include \"machinery/algorithm/AnotherAlgorithm.h\"\nnamespace kerberos\n{\n void AnotherAlgorithm::setup(const StringMap & settings)\n {\n Algorithm::setup(settings);\n int parameter = std::atoi(settings.at(\"algorithms.AnotherAlgorithm.parameter\").c_str());\n setParameter(parameter);\n }\n void AnotherAlgorithm::initialize(ImageVector & images)\n {\n ....\n }\n Image AnotherAlgorithm::evaluate(ImageVector & images, JSON & data)\n {\n Image evaluation;\n ... do something ..\n return evaluation;\n }\n void AnotherAlgorithm::setParameter(int parameter)\n {\n m_parameter = parameter;\n }\n}","position":{"start":{"line":102,"column":1,"offset":5243},"end":{"line":127,"column":4,"offset":5914},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Modify the CMakeLists.txt file","position":{"start":{"line":129,"column":6,"offset":5921},"end":{"line":129,"column":36,"offset":5951},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":5916},"end":{"line":129,"column":36,"offset":5951},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Open the CMakeLists.txt in the src/kerberos directory file and append the name of the algorithm class to the KERBEROS_FACTORY_ENTITIES variable; for example machinery/algorithm/AnotherAlgorithm.cpp.","position":{"start":{"line":131,"column":1,"offset":5953},"end":{"line":131,"column":199,"offset":6151},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":5953},"end":{"line":131,"column":199,"offset":6151},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"# -------------------------------------------------------\n# Entities that have to be registered with the factory\n# - classes are registered on compile time, so they\n# don't belong to a library. New algorithms, expositors\n# or Io classes belong here.\nset(KERBEROS_FACTORY_ENTITIES\n capture/USBCamera.cpp\n machinery/condition/Time.cpp\n machinery/condition/Enabled.cpp\n machinery/algorithm/DifferentialCollins.cpp\n machinery/algorithm/DifferentialCollinsWithColor.cpp\n machinery/algorithm/AnotherAlgorithm.cpp\n machinery/expositor/RectangleExpositor.cpp\n machinery/expositor/HullExpositor.cpp\n machinery/heuristic/Sequence.cpp\n machinery/io/IoDisk.cpp\n machinery/io/IoTCP.cpp\n machinery/io/IoMongoDB.cpp\n)","position":{"start":{"line":133,"column":1,"offset":6153},"end":{"line":153,"column":4,"offset":6907},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Create a new entry in the config file","position":{"start":{"line":155,"column":6,"offset":6914},"end":{"line":155,"column":43,"offset":6951},"indent":[]}}],"position":{"start":{"line":155,"column":1,"offset":6909},"end":{"line":155,"column":43,"offset":6951},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Open the algorithm.xml file in the config directory, and add a new tag with exactly the same name you've used in the header file; so in our example \"AnotherAlgorithm\". Within the new tag we can add properties that we will be use to configure our algorithm, in our example we defined a field parameter so we can add this field in the config file.","position":{"start":{"line":157,"column":1,"offset":6953},"end":{"line":157,"column":346,"offset":7298},"indent":[]}}],"position":{"start":{"line":157,"column":1,"offset":6953},"end":{"line":157,"column":346,"offset":7298},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One thing you will need to do is to attach a type to a property. The type will be used by the web to automatically render the properties. For simplicity we can use the type number, this will show an input box on the settings page of the web where we are able to add numbers.","position":{"start":{"line":159,"column":1,"offset":7300},"end":{"line":159,"column":275,"offset":7574},"indent":[]}}],"position":{"start":{"line":159,"column":1,"offset":7300},"end":{"line":159,"column":275,"offset":7574},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"\n\t\n\t\t5\n \n","position":{"start":{"line":161,"column":1,"offset":7576},"end":{"line":167,"column":4,"offset":7697},"indent":[1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"You can retrieve the parameter in the setup function with the settings parameter.","position":{"start":{"line":169,"column":1,"offset":7699},"end":{"line":169,"column":82,"offset":7780},"indent":[]}}],"position":{"start":{"line":169,"column":1,"offset":7699},"end":{"line":169,"column":82,"offset":7780},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"settings.at(\"algorithms.AnotherAlgorithm.parameter\")","position":{"start":{"line":171,"column":1,"offset":7782},"end":{"line":173,"column":4,"offset":7844},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Compile","position":{"start":{"line":175,"column":5,"offset":7850},"end":{"line":175,"column":12,"offset":7857},"indent":[]}}],"position":{"start":{"line":175,"column":1,"offset":7846},"end":{"line":175,"column":12,"offset":7857},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Hurray, we've made it! So now you can compile the code again, and if you're using an IDE don't forget to include the new source file! If you are compiling from the command-line you just have to go to the build folder and write make.","position":{"start":{"line":177,"column":1,"offset":7859},"end":{"line":177,"column":233,"offset":8091},"indent":[]}}],"position":{"start":{"line":177,"column":1,"offset":7859},"end":{"line":177,"column":233,"offset":8091},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Web","position":{"start":{"line":179,"column":4,"offset":8096},"end":{"line":179,"column":7,"offset":8099},"indent":[]}}],"position":{"start":{"line":179,"column":1,"offset":8093},"end":{"line":179,"column":7,"offset":8099},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Contributing to ","position":{"start":{"line":181,"column":1,"offset":8101},"end":{"line":181,"column":17,"offset":8117},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web","children":[{"type":"text","value":"the web repository","position":{"start":{"line":181,"column":18,"offset":8118},"end":{"line":181,"column":36,"offset":8136},"indent":[]}}],"position":{"start":{"line":181,"column":17,"offset":8117},"end":{"line":181,"column":73,"offset":8173},"indent":[]}},{"type":"text","value":" requires both front- and back-end skillls, more precisely BackboneJS (JavaScript) and Laravel 5.4 (PHP).","position":{"start":{"line":181,"column":73,"offset":8173},"end":{"line":181,"column":178,"offset":8278},"indent":[]}}],"position":{"start":{"line":181,"column":1,"offset":8101},"end":{"line":181,"column":178,"offset":8278},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":183,"column":5,"offset":8284},"end":{"line":183,"column":18,"offset":8297},"indent":[]}}],"position":{"start":{"line":183,"column":1,"offset":8280},"end":{"line":183,"column":18,"offset":8297},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Make sure you have following services installed on your working station.","position":{"start":{"line":185,"column":1,"offset":8299},"end":{"line":185,"column":73,"offset":8371},"indent":[]}}],"position":{"start":{"line":185,"column":1,"offset":8299},"end":{"line":185,"column":73,"offset":8371},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":">","position":{"start":{"line":187,"column":2,"offset":8374},"end":{"line":187,"column":4,"offset":8376},"indent":[]}},{"type":"text","value":"= PHP 7.1.0, NodeJS and NPM and Nginx or Apache","position":{"start":{"line":187,"column":4,"offset":8376},"end":{"line":187,"column":51,"offset":8423},"indent":[]}}],"position":{"start":{"line":187,"column":2,"offset":8374},"end":{"line":187,"column":51,"offset":8423},"indent":[]}}],"position":{"start":{"line":187,"column":1,"offset":8373},"end":{"line":187,"column":51,"offset":8423},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Installation","position":{"start":{"line":189,"column":5,"offset":8429},"end":{"line":189,"column":17,"offset":8441},"indent":[]}}],"position":{"start":{"line":189,"column":1,"offset":8425},"end":{"line":189,"column":17,"offset":8441},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Clone the repository to your working station.","position":{"start":{"line":191,"column":1,"offset":8443},"end":{"line":191,"column":46,"offset":8488},"indent":[]}}],"position":{"start":{"line":191,"column":1,"offset":8443},"end":{"line":191,"column":46,"offset":8488},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"git clone https://github.com/kerberos-io/web\ncd web","position":{"start":{"line":193,"column":1,"offset":8490},"end":{"line":196,"column":4,"offset":8551},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Install the PHP libraries using the dependency mananger, ","position":{"start":{"line":198,"column":1,"offset":8553},"end":{"line":198,"column":58,"offset":8610},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Composer","position":{"start":{"line":198,"column":60,"offset":8612},"end":{"line":198,"column":68,"offset":8620},"indent":[]}}],"position":{"start":{"line":198,"column":58,"offset":8610},"end":{"line":198,"column":70,"offset":8622},"indent":[]}},{"type":"text","value":". If you haven't installed composer execute following commands.","position":{"start":{"line":198,"column":70,"offset":8622},"end":{"line":198,"column":133,"offset":8685},"indent":[]}}],"position":{"start":{"line":198,"column":1,"offset":8553},"end":{"line":198,"column":133,"offset":8685},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"php -r \"readfile('https://getcomposer.org/installer');\" > composer-setup.php\nphp -r \"if (hash('SHA384', file_get_contents('composer-setup.php')) === '41e71d86b40f28e771d4bb662b997f79625196afcca95a5abf44391188c695c6c1456e16154c75a211d238cc3bc5cb47') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;\"\nphp composer-setup.php\nphp -r \"unlink('composer-setup.php');\"","position":{"start":{"line":200,"column":1,"offset":8687},"end":{"line":205,"column":4,"offset":9118},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"After a succesful installation, you can run composer install or composer update from the root of the project. All dependencies will be installed or updated if a newer version is detected.","position":{"start":{"line":207,"column":1,"offset":9120},"end":{"line":207,"column":188,"offset":9307},"indent":[]}}],"position":{"start":{"line":207,"column":1,"offset":9120},"end":{"line":207,"column":188,"offset":9307},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"composer update","position":{"start":{"line":209,"column":1,"offset":9309},"end":{"line":211,"column":4,"offset":9334},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Besides PHP, the project also relies on BackboneJS (Javascript) for the front-end. Therefore a couple JavaScript dependencies should be installed.","position":{"start":{"line":213,"column":1,"offset":9336},"end":{"line":213,"column":147,"offset":9482},"indent":[]}}],"position":{"start":{"line":213,"column":1,"offset":9336},"end":{"line":213,"column":147,"offset":9482},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"npm -g install bower\ncd public\nbower update","position":{"start":{"line":215,"column":1,"offset":9484},"end":{"line":219,"column":4,"offset":9537},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"When everything is installed properly, you need too link the web project with your applicationn server. Read more on the ","position":{"start":{"line":221,"column":1,"offset":9539},"end":{"line":221,"column":122,"offset":9660},"indent":[]}},{"type":"link","title":null,"url":"https://laravel.com/docs/5.8/deployment","children":[{"type":"text","value":"Laravel documentation website","position":{"start":{"line":221,"column":123,"offset":9661},"end":{"line":221,"column":152,"offset":9690},"indent":[]}}],"position":{"start":{"line":221,"column":122,"offset":9660},"end":{"line":221,"column":194,"offset":9732},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":221,"column":194,"offset":9732},"end":{"line":221,"column":195,"offset":9733},"indent":[]}}],"position":{"start":{"line":221,"column":1,"offset":9539},"end":{"line":221,"column":195,"offset":9733},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":224,"column":1,"offset":9736},"end":{"line":224,"column":31,"offset":9766},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":224,"column":31,"offset":9766}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Contribute`}

\n

{`In this document we describe the different things you need to know if you would like to add a new feature to Kerberos Open Source, or change some of its behaviour for your own use case.`}

\n

{`Before starting, as you might have read already, you need to know that Kerberos Open Source consists of two solutions. A front-end, also called `}{`web`}{`, which allows you to review the recordings and to configure the back-end settings. A back-end, also called `}{`machinery`}{`, which is computer vision solution that processes the video stream of surveillance camera.`}

\n

{`Once you start changing or adding features to Kerberos Open Source, there is a big chance you will need to modify the previously mentioned solutions. That's why we will discuss how you can contribute to one or both solutions.`}

\n

{`Machinery`}

\n

{`Contributing to the `}{`machinery repository`}{` requires C++ skills. This section describes all the technical stuff you will need to know. If you want to contribute, the first thing you will need to do is installing the source code on your working station.`}

\n

{`Prerequisites`}

\n
\n

{`A Linux OS, or Mac OSX (Window is not supported).`}

\n
\n

{`Installation`}

\n

{`The complete installation can be found on the advanced installation page, describing the complete set of instructions. However for simplicity we will give a summarized version, as probably you will already have a development environment set up.`}

\n

{`Install development tools (C++, CMake) and V4L utils, and clone the repository. Compile the project using cmake and make.`}

\n 
{`sudo`}{` `}{`apt`}{`-`}{`get`}{` -`}{`y`}{` `}{`update`}{`\n`}{`sudo`}{` `}{`apt`}{`-`}{`get`}{` `}{`install`}{` -`}{`y`}{` `}{`git`}{` `}{`cmake`}{` `}{`subversion`}{` `}{`dh`}{`-`}{`autoreconf`}{` `}{`libcurl4`}{`-`}{`openssl`}{`-`}{`dev`}{` `}{`yasm`}{` `}{`libx264`}{`-`}{`dev`}{` `}{`pkg`}{`-`}{`config`}{` `}{`libssl`}{`-`}{`dev`}{`\n`}{`cd`}{` && `}{`sudo`}{` `}{`git`}{` `}{`clone`}{` https:`}{`//github.com/kerberos-io/machinery`}{`\n`}{`cd`}{` `}{`machinery`}{` && `}{`mkdir`}{` `}{`build`}{` && `}{`cd`}{` `}{`build`}{`\n`}{`cmake`}{` .. && `}{`make`}{` -`}{`j8`}{` && `}{`make`}{` `}{`check`}{` && `}{`sudo`}{` `}{`make`}{` `}{`install`}
\n

{`Testing`}

\n

{`We strongly recommend testing as a best practice in complex projects. Therefore the machinery uses the popular C++ test library: Google Test and Google Mock. The tests can be found in the test directory. You can run the test by executing following command:`}

\n 
{`make`}{` `}{`check`}
\n

{`Adding a new class`}

\n

{`This paragraph will tell you how to create a new condition, algorithm, expositor, io or capture device. For simplicity we will show how to create a new algorithm; the steps are identical if you want to create for example a new capture device; only the directory will differ.`}

\n

{`Create the header file`}

\n

{`First we will need to create a new header file in the include/kerberos/machinery/algorithm directory. You can copy an existing algorithm header file, and start from there. You will end up with the following header file:`}

\n 
{`//`}{`\n`}{`//  Class: AnotherAlgorithm`}{`\n`}{`//  Description: Another algorithm`}{`\n`}{`//  Created:     ...`}{`\n`}{`//  Author:      ...`}{`\n`}{`//  Mail:        ...`}{`\n`}{`//  Website:     ...`}{`\n`}{`//`}{`\n`}{`//  The copyright to the computer program(s) herein`}{`\n`}{`//  is the property of kerberos.io, Belgium.`}{`\n`}{`//  The program(s) may be used and/or copied .`}{`\n`}{`//`}{`\n`}{`/////////////////////////////////////////////////////`}{`\n`}{`#`}{`ifndef`}{` `}{`__AnotherAlgorithm_H_INCLUDED__`}{`   `}{`// if AnotherAlgorithm.h hasn't been included yet...`}{`\n`}{`#`}{`define`}{` `}{`__AnotherAlgorithm_H_INCLUDED__`}{`   `}{`// #define this so the compiler knows it has been included`}{`\n`}{`#`}{`include`}{` `}{`\"machinery/algorithm/Algorithm.h\"`}{`\n`}{`namespace`}{` `}{`kerberos`}{`\n`}{`{`}{`\n`}{`\t`}{`char`}{` `}{`AnotherAlgorithmName`}{`[] = `}{`\"AnotherAlgorithm\"`}{`;`}{`\n`}{`\t`}{`class`}{` `}{`AnotherAlgorithm`}{` : `}{`public`}{` `}{`AlgorithmCreator`}{`<`}{`AnotherAlgorithmName`}{`, `}{`AnotherAlgorithm`}{`>`}{`\n`}{`\t{`}{`\n`}{`    \t`}{`private`}{`:`}{`\n`}{`    \t\t`}{`Image`}{` `}{`m_result`}{`;`}{`\n`}{`        \t`}{`int`}{` `}{`m_parameter`}{`;`}{`\n`}{`    \t`}{`public`}{`:`}{`\n`}{`        \t`}{`AnotherAlgorithm`}{`(){}`}{`\n`}{`        \t`}{`void`}{` `}{`setup`}{`(`}{`const`}{` `}{`StringMap`}{` & `}{`settings`}{`);`}{`\n`}{`        \t`}{`void`}{` `}{`initialize`}{`(`}{`ImageVector`}{` & `}{`images`}{`);`}{`\n`}{`        \t`}{`Image`}{` `}{`evaluate`}{`(`}{`ImageVector`}{` & `}{`images`}{`, `}{`JSON`}{` & `}{`data`}{`);`}{`\n`}{`        \t`}{`void`}{` `}{`setParameter`}{`(`}{`int`}{` `}{`parameter`}{`);`}{`\n`}{`\t};`}{`\n`}{`}`}{`\n`}{`#`}{`endif`}
\n

{`When creating a new class you will need to inherit from it corresponding creator, for the algorithm example: AlgorithmCreator. The creator class requires two template parameters. The first one is a unique name for the class, this name will be used to make some kind of dependency injection possible; and is used in the configurations files. The second parameter is the class itself.`}

\n

{`The inheritance of the creator class can be a little bit strange, but it is required and needed to register the class automatically with the factory. When the code gets compiled, the classes will be automatically registered with the factory, and you can create instances of those classes by using the name we've defined in the first template parameter. For example we could create a new instance of our previously created class with the following command.`}

\n 
{`Algorithm`}{` * `}{`anotherAlgorithm`}{` = `}{`Factory`}{`<`}{`Algorithm`}{`>::`}{`getInstance`}{`()->`}{`create`}{`(`}{`\"AnotherAlgorithm\"`}{`);`}
\n

{`Create the source file`}

\n

{`Ofcourse we also need to have an implementation file, therefore we need to create a new source file in the src/kerberos/machinery/algorithm directory. Just like the previous example, you can copy an existing class and implement the member functions you've declared in the header file. An example would be:`}

\n 
{`#`}{`include`}{` `}{`\"machinery/algorithm/AnotherAlgorithm.h\"`}{`\n`}{`namespace`}{` `}{`kerberos`}{`\n`}{`{`}{`\n`}{`    `}{`void`}{` AnotherAlgorithm::`}{`setup`}{`(`}{`const`}{` `}{`StringMap`}{` & `}{`settings`}{`)`}{`\n`}{`    {`}{`\n`}{`        Algorithm::`}{`setup`}{`(`}{`settings`}{`);`}{`\n`}{`        `}{`int`}{` `}{`parameter`}{` = std::`}{`atoi`}{`(`}{`settings`}{`.`}{`at`}{`(`}{`\"algorithms.AnotherAlgorithm.parameter\"`}{`).`}{`c_str`}{`());`}{`\n`}{`        `}{`setParameter`}{`(`}{`parameter`}{`);`}{`\n`}{`    }`}{`\n`}{`    `}{`void`}{` AnotherAlgorithm::`}{`initialize`}{`(`}{`ImageVector`}{` & `}{`images`}{`)`}{`\n`}{`    {`}{`\n`}{`        ....`}{`\n`}{`    }`}{`\n`}{`    `}{`Image`}{` AnotherAlgorithm::`}{`evaluate`}{`(`}{`ImageVector`}{` & `}{`images`}{`, `}{`JSON`}{` & `}{`data`}{`)`}{`\n`}{`    {`}{`\n`}{`        `}{`Image`}{` `}{`evaluation`}{`;`}{`\n`}{`        ... `}{`do`}{` `}{`something`}{` ..`}{`\n`}{`        `}{`return`}{` `}{`evaluation`}{`;`}{`\n`}{`    }`}{`\n`}{`    `}{`void`}{` AnotherAlgorithm::`}{`setParameter`}{`(`}{`int`}{` `}{`parameter`}{`)`}{`\n`}{`    {`}{`\n`}{`        `}{`m_parameter`}{` = `}{`parameter`}{`;`}{`\n`}{`    }`}{`\n`}{`}`}
\n

{`Modify the CMakeLists.txt file`}

\n

{`Open the CMakeLists.txt in the src/kerberos directory file and append the name of the algorithm class to the KERBEROS_FACTORY_ENTITIES variable; for example machinery/algorithm/AnotherAlgorithm.cpp.`}

\n 
{`# -------------------------------------------------------`}{`\n`}{`# `}{`Entities`}{` `}{`that`}{` `}{`have`}{` `}{`to`}{` `}{`be`}{` `}{`registered`}{` `}{`with`}{` `}{`the`}{` `}{`factory`}{`\n`}{`#   - `}{`classes`}{` `}{`are`}{` `}{`registered`}{` `}{`on`}{` `}{`compile`}{` `}{`time`}{`, `}{`so`}{` `}{`they`}{`\n`}{`#   `}{`don`}{`'t belong to a library. New algorithms, expositor`}{`s`}{`\n`}{`#   `}{`or`}{` `}{`Io`}{` `}{`classes`}{` `}{`belong`}{` `}{`here`}{`.`}{`\n`}{`set`}{`(`}{`KERBEROS_FACTORY_ENTITIES`}{`\n`}{`    `}{`capture`}{`/`}{`USBCamera`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`condition`}{`/`}{`Time`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`condition`}{`/`}{`Enabled`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`algorithm`}{`/`}{`DifferentialCollins`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`algorithm`}{`/`}{`DifferentialCollinsWithColor`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`algorithm`}{`/`}{`AnotherAlgorithm`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`expositor`}{`/`}{`RectangleExpositor`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`expositor`}{`/`}{`HullExpositor`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`heuristic`}{`/`}{`Sequence`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`io`}{`/`}{`IoDisk`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`io`}{`/`}{`IoTCP`}{`.`}{`cpp`}{`\n`}{`    `}{`machinery`}{`/`}{`io`}{`/`}{`IoMongoDB`}{`.`}{`cpp`}{`\n`}{`)`}
\n

{`Create a new entry in the config file`}

\n

{`Open the algorithm.xml file in the config directory, and add a new tag with exactly the same name you've used in the header file; so in our example \"AnotherAlgorithm\". Within the new tag we can add properties that we will be use to configure our algorithm, in our example we defined a field parameter so we can add this field in the config file.`}

\n

{`One thing you will need to do is to attach a type to a property. The type will be used by the web to automatically render the properties. For simplicity we can use the type number, this will show an input box on the settings page of the web where we are able to add numbers.`}

\n 
{`<`}{`algorithms`}{`>`}{`\n`}{`\t<`}{`AnotherAlgorithm`}{`>`}{`\n`}{`\t\t<`}{`parameter`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`5`}{`{`parameter`}{`>`}{`\n`}{`    {`AnotherAlgorithm`}{`>`}{`\n`}{`{`algorithms`}{`>`}
\n

{`You can retrieve the parameter in the setup function with the settings parameter.`}

\n 
{`settings`}{`.`}{`at`}{`(`}{`\"algorithms.AnotherAlgorithm.parameter\"`}{`)`}
\n

{`Compile`}

\n

{`Hurray, we've made it! So now you can compile the code again, and if you're using an IDE don't forget to include the new source file! If you are compiling from the command-line you just have to go to the build folder and write make.`}

\n

{`Web`}

\n

{`Contributing to `}{`the web repository`}{` requires both front- and back-end skillls, more precisely BackboneJS (JavaScript) and Laravel 5.4 (PHP).`}

\n

{`Prerequisites`}

\n

{`Make sure you have following services installed on your working station.`}

\n
\n

{`>`}{`= PHP 7.1.0, NodeJS and NPM and Nginx or Apache`}

\n
\n

{`Installation`}

\n

{`Clone the repository to your working station.`}

\n 
{`git`}{` `}{`clone`}{` https:`}{`//github.com/kerberos-io/web`}{`\n`}{`cd`}{` `}{`web`}
\n

{`Install the PHP libraries using the dependency mananger, `}{`Composer`}{`. If you haven't installed composer execute following commands.`}

\n 
{`php`}{` -`}{`r`}{` `}{`\"readfile('https://getcomposer.org/installer');\"`}{` > `}{`composer`}{`-`}{`setup`}{`.`}{`php`}{`\n`}{`php`}{` -`}{`r`}{` `}{`\"if (hash('SHA384', file_get_contents('composer-setup.php')) === '41e71d86b40f28e771d4bb662b997f79625196afcca95a5abf44391188c695c6c1456e16154c75a211d238cc3bc5cb47') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;\"`}{`\n`}{`php`}{` `}{`composer`}{`-`}{`setup`}{`.`}{`php`}{`\n`}{`php`}{` -`}{`r`}{` `}{`\"unlink('composer-setup.php');\"`}
\n

{`After a succesful installation, you can run composer install or composer update from the root of the project. All dependencies will be installed or updated if a newer version is detected.`}

\n 
{`composer`}{` `}{`update`}
\n

{`Besides PHP, the project also relies on BackboneJS (Javascript) for the front-end. Therefore a couple JavaScript dependencies should be installed.`}

\n 
{`npm`}{` -`}{`g`}{` `}{`install`}{` `}{`bower`}{`\n`}{`cd`}{` `}{`public`}{`\n`}{`bower`}{` `}{`update`}
\n

{`When everything is installed properly, you need too link the web project with your applicationn server. Read more on the `}{`Laravel documentation website`}{`.`}

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-1e6346fbfee72e21329fb6063c61726a.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-1e6346fbfee72e21329fb6063c61726a.json new file mode 100644 index 0000000..80144a5 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-1e6346fbfee72e21329fb6063c61726a.json @@ -0,0 +1 @@ +{"expireTime":9007200861829638000,"key":"gatsby-plugin-mdx-entire-payload-b680f5ef9484d1619788ba381562106e-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":396,"offset":1049},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":396,"offset":1049},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Despite the flexible storage capabilities, Kerberos Storage is also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":198,"offset":1248},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":198,"offset":1248},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":22,"column":4,"offset":1253},"end":{"line":22,"column":18,"offset":1267},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1250},"end":{"line":22,"column":18,"offset":1267},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":24,"column":1,"offset":1269},"end":{"line":24,"column":291,"offset":1559},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":24,"column":292,"offset":1560},"end":{"line":24,"column":309,"offset":1577},"indent":[]}}],"position":{"start":{"line":24,"column":291,"offset":1559},"end":{"line":24,"column":318,"offset":1586},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":24,"column":318,"offset":1586},"end":{"line":24,"column":319,"offset":1587},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1269},"end":{"line":24,"column":319,"offset":1587},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":26,"column":1,"offset":1589},"end":{"line":26,"column":56,"offset":1644},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1589},"end":{"line":26,"column":56,"offset":1644},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":28,"column":4,"offset":1649},"end":{"line":28,"column":20,"offset":1665},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1646},"end":{"line":28,"column":20,"offset":1665},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":30,"column":1,"offset":1667},"end":{"line":30,"column":253,"offset":1919},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1667},"end":{"line":30,"column":253,"offset":1919},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":32,"column":6,"offset":1926},"end":{"line":32,"column":35,"offset":1955},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":1925},"end":{"line":32,"column":70,"offset":1990},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":1925},"end":{"line":32,"column":70,"offset":1990},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1921},"end":{"line":32,"column":70,"offset":1990},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":33,"column":6,"offset":1996},"end":{"line":33,"column":29,"offset":2019},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":1995},"end":{"line":33,"column":83,"offset":2073},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":1995},"end":{"line":33,"column":83,"offset":2073},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1991},"end":{"line":33,"column":83,"offset":2073},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":34,"column":6,"offset":2079},"end":{"line":34,"column":28,"offset":2101},"indent":[]}}],"position":{"start":{"line":34,"column":5,"offset":2078},"end":{"line":34,"column":57,"offset":2130},"indent":[]}}],"position":{"start":{"line":34,"column":5,"offset":2078},"end":{"line":34,"column":57,"offset":2130},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2074},"end":{"line":34,"column":57,"offset":2130},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":35,"column":6,"offset":2136},"end":{"line":35,"column":11,"offset":2141},"indent":[]}}],"position":{"start":{"line":35,"column":5,"offset":2135},"end":{"line":35,"column":29,"offset":2159},"indent":[]}}],"position":{"start":{"line":35,"column":5,"offset":2135},"end":{"line":35,"column":29,"offset":2159},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2131},"end":{"line":35,"column":29,"offset":2159},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1921},"end":{"line":35,"column":29,"offset":2159},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":37,"column":1,"offset":2161},"end":{"line":37,"column":190,"offset":2350},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2161},"end":{"line":37,"column":190,"offset":2350},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":39,"column":1,"offset":2352},"end":{"line":39,"column":99,"offset":2450},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2352},"end":{"line":39,"column":99,"offset":2450},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":41,"column":1,"offset":2452},"end":{"line":41,"column":220,"offset":2671},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2452},"end":{"line":41,"column":220,"offset":2671},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":43,"column":1,"offset":2673},"end":{"line":43,"column":98,"offset":2770},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2673},"end":{"line":43,"column":98,"offset":2770},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":45,"column":5,"offset":2776},"end":{"line":45,"column":11,"offset":2782},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2772},"end":{"line":45,"column":11,"offset":2782},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":47,"column":1,"offset":2784},"end":{"line":47,"column":303,"offset":3086},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2784},"end":{"line":47,"column":303,"offset":3086},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":49,"column":6,"offset":3093},"end":{"line":49,"column":18,"offset":3105},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":3092},"end":{"line":49,"column":46,"offset":3133},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":3092},"end":{"line":49,"column":46,"offset":3133},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3088},"end":{"line":49,"column":46,"offset":3133},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":50,"column":6,"offset":3139},"end":{"line":50,"column":29,"offset":3162},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":3138},"end":{"line":50,"column":59,"offset":3192},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":3138},"end":{"line":50,"column":59,"offset":3192},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3134},"end":{"line":50,"column":59,"offset":3192},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3088},"end":{"line":50,"column":59,"offset":3192},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":52,"column":1,"offset":3194},"end":{"line":52,"column":368,"offset":3561},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3194},"end":{"line":52,"column":368,"offset":3561},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":54,"column":1,"offset":3563},"end":{"line":54,"column":66,"offset":3628},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3563},"end":{"line":54,"column":66,"offset":3628},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":56,"column":5,"offset":3634},"end":{"line":56,"column":21,"offset":3650},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3630},"end":{"line":56,"column":21,"offset":3650},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":58,"column":1,"offset":3652},"end":{"line":58,"column":237,"offset":3888},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3652},"end":{"line":58,"column":237,"offset":3888},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":60,"column":1,"offset":3890},"end":{"line":60,"column":105,"offset":3994},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":3890},"end":{"line":60,"column":105,"offset":3994},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":62,"column":1,"offset":3996},"end":{"line":62,"column":45,"offset":4040},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":3996},"end":{"line":62,"column":45,"offset":4040},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":64,"column":3,"offset":4044},"end":{"line":64,"column":380,"offset":4421},"indent":[]}}],"position":{"start":{"line":64,"column":3,"offset":4044},"end":{"line":64,"column":380,"offset":4421},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4042},"end":{"line":65,"column":1,"offset":4422},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":66,"column":3,"offset":4425},"end":{"line":67,"column":49,"offset":4739},"indent":[2]}}],"position":{"start":{"line":66,"column":3,"offset":4425},"end":{"line":67,"column":49,"offset":4739},"indent":[2]}}],"position":{"start":{"line":66,"column":1,"offset":4423},"end":{"line":67,"column":49,"offset":4739},"indent":[1]}}],"position":{"start":{"line":64,"column":1,"offset":4042},"end":{"line":67,"column":49,"offset":4739},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":69,"column":5,"offset":4745},"end":{"line":69,"column":13,"offset":4753},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4741},"end":{"line":69,"column":13,"offset":4753},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":71,"column":1,"offset":4755},"end":{"line":71,"column":156,"offset":4910},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":71,"column":156,"offset":4910},"end":{"line":71,"column":177,"offset":4931},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":71,"column":177,"offset":4931},"end":{"line":71,"column":188,"offset":4942},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":71,"column":188,"offset":4942},"end":{"line":71,"column":193,"offset":4947},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":71,"column":193,"offset":4947},"end":{"line":71,"column":379,"offset":5133},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":4755},"end":{"line":71,"column":379,"offset":5133},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":73,"column":1,"offset":5135},"end":{"line":73,"column":68,"offset":5202},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5135},"end":{"line":73,"column":68,"offset":5202},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":75,"column":4,"offset":5207},"end":{"line":75,"column":13,"offset":5216},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5204},"end":{"line":75,"column":13,"offset":5216},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":77,"column":1,"offset":5218},"end":{"line":77,"column":44,"offset":5261},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":77,"column":46,"offset":5263},"end":{"line":77,"column":68,"offset":5285},"indent":[]}}],"position":{"start":{"line":77,"column":44,"offset":5261},"end":{"line":77,"column":70,"offset":5287},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":77,"column":70,"offset":5287},"end":{"line":77,"column":106,"offset":5323},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":77,"column":108,"offset":5325},"end":{"line":77,"column":129,"offset":5346},"indent":[]}}],"position":{"start":{"line":77,"column":106,"offset":5323},"end":{"line":77,"column":131,"offset":5348},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":77,"column":131,"offset":5348},"end":{"line":77,"column":159,"offset":5376},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":5218},"end":{"line":77,"column":159,"offset":5376},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":80,"column":1,"offset":5379},"end":{"line":80,"column":31,"offset":5409},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":80,"column":31,"offset":5409}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio.`}

\n

{`Despite the flexible storage capabilities, Kerberos Storage is also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-263a8f304b788b344d25211460e0a988.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-263a8f304b788b344d25211460e0a988.json new file mode 100644 index 0000000..2dbb742 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-263a8f304b788b344d25211460e0a988.json @@ -0,0 +1 @@ +{"expireTime":9007200861750190000,"key":"gatsby-plugin-mdx-entire-payload-655dfe741b5a9ff43d6f3e850a24db1d-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Welcome to the Kerberos Enterprise Edge installation. This is the way to go if you want to install Kerberos Enterprise on your Baremetal infrastructure or inside your Private Cloud.","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":182,"offset":416},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":182,"offset":416},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":14,"column":1,"offset":418},"end":{"line":14,"column":91,"offset":508},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":418},"end":{"line":14,"column":91,"offset":508},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before we can actual start installing the different deployments in our cluster, we need to make sure we have one available.","position":{"start":{"line":16,"column":1,"offset":510},"end":{"line":16,"column":124,"offset":633},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":510},"end":{"line":16,"column":124,"offset":633},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":18,"column":3,"offset":637},"end":{"line":18,"column":16,"offset":650},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":635},"end":{"line":18,"column":16,"offset":650},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Docker","position":{"start":{"line":20,"column":4,"offset":655},"end":{"line":20,"column":10,"offset":661},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":652},"end":{"line":20,"column":10,"offset":661},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you have a fresh Linux installation, make sure you have Docker installed. If not the case, this is how you can install it on a Ubuntu OSS.","position":{"start":{"line":22,"column":1,"offset":663},"end":{"line":22,"column":142,"offset":804},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":663},"end":{"line":22,"column":142,"offset":804},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"apt install docker.io -y","position":{"start":{"line":24,"column":1,"offset":806},"end":{"line":24,"column":29,"offset":834},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":26,"column":4,"offset":839},"end":{"line":26,"column":14,"offset":849},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":836},"end":{"line":26,"column":14,"offset":849},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After Docker being installed go ahead and install the different Kubernetes servicess and tools.","position":{"start":{"line":28,"column":1,"offset":851},"end":{"line":28,"column":96,"offset":946},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":851},"end":{"line":28,"column":96,"offset":946},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"apt update -y\napt install apt-transport-https curl -y\ncurl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add\napt-add-repository \"deb http://apt.kubernetes.io/ kubernetes-xenial main\"\napt update -y && apt install kubeadm kubelet kubectl kubernetes-cni -y","position":{"start":{"line":30,"column":1,"offset":948},"end":{"line":34,"column":75,"offset":1242},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Make sure you disable swap, this is required by Kubernetes.","position":{"start":{"line":36,"column":1,"offset":1244},"end":{"line":36,"column":60,"offset":1303},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":1244},"end":{"line":36,"column":60,"offset":1303},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"swapoff -a","position":{"start":{"line":38,"column":1,"offset":1305},"end":{"line":38,"column":15,"offset":1319},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"And if you want to make it permanent after every boot.","position":{"start":{"line":40,"column":1,"offset":1321},"end":{"line":40,"column":55,"offset":1375},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1321},"end":{"line":40,"column":55,"offset":1375},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"sudo sed -i.bak '/ swap / s/^\\(.*\\)$/#\\1/g' /etc/fstab","position":{"start":{"line":42,"column":1,"offset":1377},"end":{"line":42,"column":59,"offset":1435},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":44,"column":3,"offset":1439},"end":{"line":44,"column":15,"offset":1451},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":1437},"end":{"line":44,"column":15,"offset":1451},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before initiating a new Kubernetes cluster, make sure you have properly cleaned up previous installation (if this was the case ofc).","position":{"start":{"line":46,"column":1,"offset":1453},"end":{"line":46,"column":133,"offset":1585},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":1453},"end":{"line":46,"column":133,"offset":1585},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubeadm reset\nrm -rf $HOME/.kube","position":{"start":{"line":48,"column":1,"offset":1587},"end":{"line":49,"column":23,"offset":1627},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Initiate a new Kubernetes cluster using following command. This will use the current CIDR. If you want to use another CIDR, specify following arguments: ","position":{"start":{"line":51,"column":1,"offset":1629},"end":{"line":51,"column":154,"offset":1782},"indent":[]}},{"type":"inlineCode","value":"--pod-network-cidr=10.244.0.0/16","position":{"start":{"line":51,"column":154,"offset":1782},"end":{"line":51,"column":188,"offset":1816},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":51,"column":188,"offset":1816},"end":{"line":51,"column":189,"offset":1817},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":1629},"end":{"line":51,"column":189,"offset":1817},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubeadm init","position":{"start":{"line":53,"column":1,"offset":1819},"end":{"line":53,"column":17,"offset":1835},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once successful you should see the following. Note the ","position":{"start":{"line":55,"column":1,"offset":1837},"end":{"line":55,"column":56,"offset":1892},"indent":[]}},{"type":"inlineCode","value":"discovery token","position":{"start":{"line":55,"column":56,"offset":1892},"end":{"line":55,"column":73,"offset":1909},"indent":[]}},{"type":"text","value":" which you need to use to connect additional nodes to your cluster.","position":{"start":{"line":55,"column":73,"offset":1909},"end":{"line":55,"column":140,"offset":1976},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":1837},"end":{"line":55,"column":140,"offset":1976},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"Your Kubernetes control-plane has initialized successfully!\n\nTo start using your cluster, you need to run the following as a regular user:\n\n mkdir -p $HOME/.kube\n sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config\n sudo chown $(id -u):$(id -g) $HOME/.kube/config\n\nYou should now deploy a pod network to the cluster.\nRun \"kubectl apply -f [podnetwork].yaml\" with one of the options listed at:\n https://kubernetes.io/docs/concepts/cluster-administration/addons/\n\nThen you can join any number of worker nodes by running the following on each as root:\n\nkubeadm join 192.168.1.103:6443 --token ej7ckt.uof7o2iplqf0r2up \\\n --discovery-token-ca-cert-hash sha256:9cbcc00d34be2dbd605174802d9e52fbcdd617324c237bf58767b369fa586209","position":{"start":{"line":57,"column":1,"offset":1978},"end":{"line":72,"column":111,"offset":2753},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Now we have a Kubernetes cluster, we need to make sure we add make it available in our ","position":{"start":{"line":74,"column":1,"offset":2755},"end":{"line":74,"column":88,"offset":2842},"indent":[]}},{"type":"inlineCode","value":"kubeconfig","position":{"start":{"line":74,"column":88,"offset":2842},"end":{"line":74,"column":100,"offset":2854},"indent":[]}},{"type":"text","value":". This will allow us to query our Kubernetes cluster with the ","position":{"start":{"line":74,"column":100,"offset":2854},"end":{"line":74,"column":162,"offset":2916},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":74,"column":162,"offset":2916},"end":{"line":74,"column":171,"offset":2925},"indent":[]}},{"type":"text","value":" command.","position":{"start":{"line":74,"column":171,"offset":2925},"end":{"line":74,"column":180,"offset":2934},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":2755},"end":{"line":74,"column":180,"offset":2934},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"mkdir -p $HOME/.kube\ncp -i /etc/kubernetes/admin.conf $HOME/.kube/config\nchown $(id -u):$(id -g) $HOME/.kube/config","position":{"start":{"line":76,"column":1,"offset":2936},"end":{"line":78,"column":47,"offset":3063},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Untaint all nodes","position":{"start":{"line":80,"column":4,"offset":3068},"end":{"line":80,"column":21,"offset":3085},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":3065},"end":{"line":80,"column":21,"offset":3085},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By default, and in this example, we only have one node our master node. In a production scenario we would have additional worker nodes. By default the master nodes are marked as ","position":{"start":{"line":82,"column":1,"offset":3087},"end":{"line":82,"column":179,"offset":3265},"indent":[]}},{"type":"inlineCode","value":"tainted","position":{"start":{"line":82,"column":179,"offset":3265},"end":{"line":82,"column":188,"offset":3274},"indent":[]}},{"type":"text","value":", this means they cannot run workloads. To allow master nodes to run workloads, we need to untaint them. If we wouldn't do this our pods would never be scheduled, as we do not have worker nodes at this moment.","position":{"start":{"line":82,"column":188,"offset":3274},"end":{"line":82,"column":397,"offset":3483},"indent":[]}}],"position":{"start":{"line":82,"column":1,"offset":3087},"end":{"line":82,"column":397,"offset":3483},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl taint nodes --all node-role.kubernetes.io/master-","position":{"start":{"line":84,"column":1,"offset":3485},"end":{"line":84,"column":62,"offset":3546},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Calico","position":{"start":{"line":86,"column":4,"offset":3551},"end":{"line":86,"column":10,"offset":3557},"indent":[]}}],"position":{"start":{"line":86,"column":1,"offset":3548},"end":{"line":86,"column":10,"offset":3557},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Calico is an open source networking and network security solution for containers, virtual machines, and native host-based workloads. (","position":{"start":{"line":88,"column":1,"offset":3559},"end":{"line":88,"column":135,"offset":3693},"indent":[]}},{"type":"link","title":null,"url":"https://www.projectcalico.org/","children":[{"type":"text","value":"https://www.projectcalico.org/","position":{"start":{"line":88,"column":135,"offset":3693},"end":{"line":88,"column":165,"offset":3723},"indent":[]}}],"position":{"start":{"line":88,"column":135,"offset":3693},"end":{"line":88,"column":165,"offset":3723},"indent":[]}},{"type":"text","value":"). We will use it as our network layer in our Kubernetes cluster. You could use otthers like Flannel aswell, but we prefer Calico.","position":{"start":{"line":88,"column":165,"offset":3723},"end":{"line":88,"column":295,"offset":3853},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":3559},"end":{"line":88,"column":295,"offset":3853},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"curl https://docs.projectcalico.org/manifests/calico.yaml -O\nkubectl apply -f calico.yaml","position":{"start":{"line":90,"column":1,"offset":3855},"end":{"line":91,"column":33,"offset":3952},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":93,"column":4,"offset":3957},"end":{"line":93,"column":23,"offset":3976},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":3954},"end":{"line":93,"column":23,"offset":3976},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.","position":{"start":{"line":95,"column":1,"offset":3978},"end":{"line":95,"column":323,"offset":4300},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":3978},"end":{"line":95,"column":323,"offset":4300},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/enterprise\nkubectl create -f ./enterprise/yaml/factory/clusterrole.yaml","position":{"start":{"line":97,"column":1,"offset":4302},"end":{"line":98,"column":65,"offset":4422},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"This will make several actions, permissions, inside your cluster available. We need this to be able to create deployments from the Kerberos Enterprise web app.","position":{"start":{"line":100,"column":1,"offset":4424},"end":{"line":100,"column":160,"offset":4583},"indent":[]}}],"position":{"start":{"line":100,"column":1,"offset":4424},"end":{"line":100,"column":160,"offset":4583},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"MetalLB","position":{"start":{"line":102,"column":4,"offset":4588},"end":{"line":102,"column":11,"offset":4595},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":4585},"end":{"line":102,"column":11,"offset":4595},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In the Edge world, we do not have fancy Load balancers and Public IP from which we can benefit. To overcome this solutions such as MetalLB - Baremetal Load Balancer - have been developed (","position":{"start":{"line":104,"column":1,"offset":4597},"end":{"line":104,"column":189,"offset":4785},"indent":[]}},{"type":"link","title":null,"url":"https://metallb.universe.tf/installation/","children":[{"type":"text","value":"https://metallb.universe.tf/installation/","position":{"start":{"line":104,"column":189,"offset":4785},"end":{"line":104,"column":230,"offset":4826},"indent":[]}}],"position":{"start":{"line":104,"column":189,"offset":4785},"end":{"line":104,"column":230,"offset":4826},"indent":[]}},{"type":"text","value":"). MetalLB will dedicate an internal IP address, or IP range, which will be assigned to one or more Load Balancers.","position":{"start":{"line":104,"column":230,"offset":4826},"end":{"line":104,"column":345,"offset":4941},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":4597},"end":{"line":104,"column":345,"offset":4941},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f https://raw.githubusercontent.com/metallb/metallb/v0.9.5/manifests/namespace.yaml\nkubectl apply -f https://raw.githubusercontent.com/metallb/metallb/v0.9.5/manifests/metallb.yaml\nkubectl create secret generic -n metallb-system memberlist --from-literal=secretkey=\"$(openssl rand -base64 128)\"","position":{"start":{"line":106,"column":1,"offset":4943},"end":{"line":108,"column":118,"offset":5264},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"After installing the different MetalLB components, we need to create a ","position":{"start":{"line":110,"column":1,"offset":5266},"end":{"line":110,"column":72,"offset":5337},"indent":[]}},{"type":"inlineCode","value":"configmap.yaml","position":{"start":{"line":110,"column":72,"offset":5337},"end":{"line":110,"column":88,"offset":5353},"indent":[]}},{"type":"text","value":" file. This file contains information of how MetalLB can get and use internal IP's as LoadBalancers.","position":{"start":{"line":110,"column":88,"offset":5353},"end":{"line":110,"column":188,"offset":5453},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":5266},"end":{"line":110,"column":188,"offset":5453},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" apiVersion: v1\n kind: ConfigMap\n metadata:\n namespace: metallb-system\n name: config\n data:\n config: |\n address-pools:\n - name: default\n protocol: layer2\n addresses:\n--> - 192.168.1.200-192.168.1.210","position":{"start":{"line":112,"column":1,"offset":5455},"end":{"line":123,"column":42,"offset":5743},"indent":[1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"You can change the IP range above to match your needs. MetalLB will use this range as a referance to assign IP addresses to your LoadBalancers. Once ready you can apply the configration map.","position":{"start":{"line":125,"column":1,"offset":5745},"end":{"line":125,"column":191,"offset":5935},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":5745},"end":{"line":125,"column":191,"offset":5935},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./enterprise/yaml/metallb/configmap.yaml","position":{"start":{"line":127,"column":1,"offset":5937},"end":{"line":127,"column":62,"offset":5998},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Helm","position":{"start":{"line":129,"column":4,"offset":6003},"end":{"line":129,"column":8,"offset":6007},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":6000},"end":{"line":129,"column":8,"offset":6007},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before we can start with the real work, I know we had to do a lot of preparation, we have to install another helpful tool ","position":{"start":{"line":131,"column":1,"offset":6009},"end":{"line":131,"column":123,"offset":6131},"indent":[]}},{"type":"inlineCode","value":"Helm","position":{"start":{"line":131,"column":123,"offset":6131},"end":{"line":131,"column":129,"offset":6137},"indent":[]}},{"type":"text","value":". Helm is a package manager for Kubernetes, and really makes you life easier.","position":{"start":{"line":131,"column":129,"offset":6137},"end":{"line":131,"column":206,"offset":6214},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":6009},"end":{"line":131,"column":206,"offset":6214},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3\nchmod 700 get_helm.sh\n./get_helm.sh","position":{"start":{"line":133,"column":1,"offset":6216},"end":{"line":135,"column":18,"offset":6359},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"This will make sure helm 3 is installed.","position":{"start":{"line":137,"column":1,"offset":6361},"end":{"line":137,"column":41,"offset":6401},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":6361},"end":{"line":137,"column":41,"offset":6401},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Traefik","position":{"start":{"line":139,"column":4,"offset":6406},"end":{"line":139,"column":11,"offset":6413},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":6403},"end":{"line":139,"column":11,"offset":6413},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To access the Kerberos Enterprise web application, we will create a service in the next paragraphs. This service will expose the web application as an Ingress. Thanks to our previous installation with MetalLB and Traefik (what we will do now), we will have a neat solution for managing our hostnames and Load Balancing IPs.","position":{"start":{"line":141,"column":1,"offset":6415},"end":{"line":141,"column":324,"offset":6738},"indent":[]}}],"position":{"start":{"line":141,"column":1,"offset":6415},"end":{"line":141,"column":324,"offset":6738},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The idea is that Traefik, will have a dedicated IP address assigned from MetalLB, and will resolve the Ingress of our Kerberos Enterprise web app. Let's go ahead with installing Traefik.","position":{"start":{"line":143,"column":1,"offset":6740},"end":{"line":143,"column":187,"offset":6926},"indent":[]}}],"position":{"start":{"line":143,"column":1,"offset":6740},"end":{"line":143,"column":187,"offset":6926},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add stable https://charts.helm.sh/stable\nhelm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik","position":{"start":{"line":145,"column":1,"offset":6928},"end":{"line":146,"column":81,"offset":7063},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"MongoDB","position":{"start":{"line":148,"column":4,"offset":7068},"end":{"line":148,"column":11,"offset":7075},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":7065},"end":{"line":148,"column":11,"offset":7075},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use ","position":{"start":{"line":150,"column":1,"offset":7077},"end":{"line":150,"column":192,"offset":7268},"indent":[]}},{"type":"inlineCode","value":"helm","position":{"start":{"line":150,"column":192,"offset":7268},"end":{"line":150,"column":198,"offset":7274},"indent":[]}},{"type":"text","value":" to install a MongoDB instance inside your cluster.","position":{"start":{"line":150,"column":198,"offset":7274},"end":{"line":150,"column":249,"offset":7325},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":7077},"end":{"line":150,"column":249,"offset":7325},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before we can move into the installation of MongoDB, in contrary with the cloud installation, we will need to create a Persistent Volume (PV). For simplicity we will use ","position":{"start":{"line":152,"column":1,"offset":7327},"end":{"line":152,"column":171,"offset":7497},"indent":[]}},{"type":"inlineCode","value":"local-storage","position":{"start":{"line":152,"column":171,"offset":7497},"end":{"line":152,"column":186,"offset":7512},"indent":[]}},{"type":"text","value":", and make sure the volume is assigned to a specific node (hostname).","position":{"start":{"line":152,"column":186,"offset":7512},"end":{"line":152,"column":255,"offset":7581},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":7327},"end":{"line":152,"column":255,"offset":7581},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Create a folder on the node (VM), where you want to persist the data of MongoDB.","position":{"start":{"line":154,"column":1,"offset":7583},"end":{"line":154,"column":81,"offset":7663},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":7583},"end":{"line":154,"column":81,"offset":7663},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"mkdir /home/mongodb/","position":{"start":{"line":156,"column":1,"offset":7665},"end":{"line":156,"column":25,"offset":7689},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once done open the ","position":{"start":{"line":158,"column":1,"offset":7691},"end":{"line":158,"column":20,"offset":7710},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/mongodb/volume.yaml","position":{"start":{"line":158,"column":20,"offset":7710},"end":{"line":158,"column":59,"offset":7749},"indent":[]}},{"type":"text","value":" file and make sure to change capacity, local path (if changed) and the hostname attribute (VM/machine, on which the directory is made available).","position":{"start":{"line":158,"column":59,"offset":7749},"end":{"line":158,"column":205,"offset":7895},"indent":[]}}],"position":{"start":{"line":158,"column":1,"offset":7691},"end":{"line":158,"column":205,"offset":7895},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n capacity:\n--> storage: 10Gi\n accessModes:\n - ReadWriteOnce\n persistentVolumeReclaimPolicy: Recycle\n storageClassName: local-storage\n local:\n--> path: /home/mongodb/\n nodeAffinity:\n required:\n nodeSelectorTerms:\n - matchExpressions:\n - key: kubernetes.io/hostname\n operator: In\n values:\n--> - hostname","position":{"start":{"line":160,"column":1,"offset":7897},"end":{"line":176,"column":29,"offset":8389},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"After modified properly you can go ahead with creating the PV.","position":{"start":{"line":178,"column":1,"offset":8391},"end":{"line":178,"column":63,"offset":8453},"indent":[]}}],"position":{"start":{"line":178,"column":1,"offset":8391},"end":{"line":178,"column":63,"offset":8453},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl create -f ./enterprise/yaml/mongodb/volume.yaml","position":{"start":{"line":180,"column":1,"offset":8455},"end":{"line":180,"column":60,"offset":8514},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Have a look into the ","position":{"start":{"line":182,"column":1,"offset":8516},"end":{"line":182,"column":22,"offset":8537},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/mongodb/values.yaml","position":{"start":{"line":182,"column":22,"offset":8537},"end":{"line":182,"column":61,"offset":8576},"indent":[]}},{"type":"text","value":" file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of MongoDB. ","position":{"start":{"line":182,"column":61,"offset":8576},"end":{"line":182,"column":218,"offset":8733},"indent":[]}}],"position":{"start":{"line":182,"column":1,"offset":8516},"end":{"line":182,"column":218,"offset":8733},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values-edge.yaml","position":{"start":{"line":184,"column":1,"offset":8735},"end":{"line":185,"column":93,"offset":8888},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.","position":{"start":{"line":187,"column":1,"offset":8890},"end":{"line":187,"column":170,"offset":9059},"indent":[]}}],"position":{"start":{"line":187,"column":1,"offset":8890},"end":{"line":187,"column":170,"offset":9059},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)\necho $MONGODB_ROOT_PASSWORD","position":{"start":{"line":189,"column":1,"offset":9061},"end":{"line":190,"column":32,"offset":9237},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Enterprise Web App - The Factory","position":{"start":{"line":192,"column":4,"offset":9242},"end":{"line":192,"column":45,"offset":9283},"indent":[]}}],"position":{"start":{"line":192,"column":1,"offset":9239},"end":{"line":192,"column":45,"offset":9283},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the ","position":{"start":{"line":194,"column":1,"offset":9285},"end":{"line":194,"column":138,"offset":9422},"indent":[]}},{"type":"inlineCode","value":"Factory","position":{"start":{"line":194,"column":138,"offset":9422},"end":{"line":194,"column":147,"offset":9431},"indent":[]}},{"type":"text","value":". It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.","position":{"start":{"line":194,"column":147,"offset":9431},"end":{"line":194,"column":309,"offset":9593},"indent":[]}}],"position":{"start":{"line":194,"column":1,"offset":9285},"end":{"line":194,"column":309,"offset":9593},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the ","position":{"start":{"line":196,"column":1,"offset":9595},"end":{"line":196,"column":289,"offset":9883},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":196,"column":289,"offset":9883},"end":{"line":196,"column":298,"offset":9892},"indent":[]}},{"type":"text","value":" command.","position":{"start":{"line":196,"column":298,"offset":9892},"end":{"line":196,"column":307,"offset":9901},"indent":[]}}],"position":{"start":{"line":196,"column":1,"offset":9595},"end":{"line":196,"column":307,"offset":9901},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing the Factory web app, open the ","position":{"start":{"line":198,"column":1,"offset":9903},"end":{"line":198,"column":49,"offset":9951},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":198,"column":49,"offset":9951},"end":{"line":198,"column":92,"offset":9994},"indent":[]}},{"type":"text","value":" configuration file. At the bottom file you will find two endpoints, similar to the traefik config file. Update the domain names to your own domain, and add these to your DNS server (pointing to the same IP as the traefik EXTERNAL-IP).","position":{"start":{"line":198,"column":92,"offset":9994},"end":{"line":198,"column":327,"offset":10229},"indent":[]}}],"position":{"start":{"line":198,"column":1,"offset":9903},"end":{"line":198,"column":327,"offset":10229},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 80\n--> - host: api.factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 8081","position":{"start":{"line":200,"column":1,"offset":10231},"end":{"line":215,"column":36,"offset":10663},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":217,"column":1,"offset":10665},"end":{"line":217,"column":99,"offset":10763},"indent":[]}}],"position":{"start":{"line":217,"column":1,"offset":10665},"end":{"line":217,"column":99,"offset":10763},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":219,"column":1,"offset":10765},"end":{"line":222,"column":30,"offset":10884},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.","position":{"start":{"line":224,"column":1,"offset":10886},"end":{"line":224,"column":118,"offset":11003},"indent":[]}}],"position":{"start":{"line":224,"column":1,"offset":10886},"end":{"line":224,"column":118,"offset":11003},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":226,"column":1,"offset":11005},"end":{"line":226,"column":63,"offset":11067},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":228,"column":4,"offset":11072},"end":{"line":228,"column":26,"offset":11094},"indent":[]}}],"position":{"start":{"line":228,"column":1,"offset":11069},"end":{"line":228,"column":26,"offset":11094},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":230,"column":1,"offset":11096},"end":{"line":230,"column":94,"offset":11189},"indent":[]}}],"position":{"start":{"line":230,"column":1,"offset":11096},"end":{"line":230,"column":94,"offset":11189},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":232,"column":5,"offset":11195},"end":{"line":232,"column":12,"offset":11202},"indent":[]}}],"position":{"start":{"line":232,"column":5,"offset":11195},"end":{"line":232,"column":12,"offset":11202},"indent":[]}}],"position":{"start":{"line":232,"column":1,"offset":11191},"end":{"line":232,"column":12,"offset":11202},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":233,"column":5,"offset":11207},"end":{"line":233,"column":12,"offset":11214},"indent":[]}}],"position":{"start":{"line":233,"column":5,"offset":11207},"end":{"line":233,"column":12,"offset":11214},"indent":[]}}],"position":{"start":{"line":233,"column":1,"offset":11203},"end":{"line":233,"column":12,"offset":11214},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Factory","position":{"start":{"line":234,"column":5,"offset":11219},"end":{"line":234,"column":12,"offset":11226},"indent":[]}}],"position":{"start":{"line":234,"column":5,"offset":11219},"end":{"line":234,"column":12,"offset":11226},"indent":[]}}],"position":{"start":{"line":234,"column":1,"offset":11215},"end":{"line":234,"column":12,"offset":11226},"indent":[]}}],"position":{"start":{"line":232,"column":1,"offset":11191},"end":{"line":234,"column":12,"offset":11226},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":236,"column":1,"offset":11228},"end":{"line":236,"column":26,"offset":11253},"indent":[]}}],"position":{"start":{"line":236,"column":1,"offset":11228},"end":{"line":236,"column":26,"offset":11253},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nfactory-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-758d5c5ddd-qsfq9 1/1 Running 0 5m31s\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":238,"column":1,"offset":11255},"end":{"line":242,"column":73,"offset":11567},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":244,"column":4,"offset":11572},"end":{"line":244,"column":21,"offset":11589},"indent":[]}}],"position":{"start":{"line":244,"column":1,"offset":11569},"end":{"line":244,"column":21,"offset":11589},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain ","position":{"start":{"line":246,"column":1,"offset":11591},"end":{"line":246,"column":152,"offset":11742},"indent":[]}},{"type":"inlineCode","value":"factory.domain.com","position":{"start":{"line":246,"column":152,"offset":11742},"end":{"line":246,"column":172,"offset":11762},"indent":[]}},{"type":"text","value":" in your browser you will see the Factory login page showing up.","position":{"start":{"line":246,"column":172,"offset":11762},"end":{"line":246,"column":236,"offset":11826},"indent":[]}}],"position":{"start":{"line":246,"column":1,"offset":11591},"end":{"line":246,"column":236,"offset":11826},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Factory","position":{"start":{"line":248,"column":1,"offset":11828},"end":{"line":248,"column":71,"offset":11898},"indent":[]}}],"position":{"start":{"line":248,"column":1,"offset":11828},"end":{"line":248,"column":71,"offset":11898},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":251,"column":1,"offset":11901},"end":{"line":251,"column":31,"offset":11931},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":251,"column":31,"offset":11931}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Introduction`}

\n

{`Welcome to the Kerberos Enterprise Edge installation. This is the way to go if you want to install Kerberos Enterprise on your Baremetal infrastructure or inside your Private Cloud.`}

\n

\"architecture

\n

{`Before we can actual start installing the different deployments in our cluster, we need to make sure we have one available.`}

\n

{`Prerequisites`}

\n

{`Docker`}

\n

{`If you have a fresh Linux installation, make sure you have Docker installed. If not the case, this is how you can install it on a Ubuntu OSS.`}

\n 
{`apt install docker.io -y`}
\n

{`Kubernetes`}

\n

{`After Docker being installed go ahead and install the different Kubernetes servicess and tools.`}

\n 
{`apt update -y`}{`\n`}{`apt install apt-transport-https curl -y`}{`\n`}{`curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add`}{`\n`}{`apt-add-repository \"deb http://apt.kubernetes.io/ kubernetes-xenial main\"`}{`\n`}{`apt update -y && apt install kubeadm kubelet kubectl kubernetes-cni -y`}
\n

{`Make sure you disable swap, this is required by Kubernetes.`}

\n 
{`swapoff -a`}
\n

{`And if you want to make it permanent after every boot.`}

\n 
{`sudo sed -i.bak '/ swap / s/^\\\\(.*\\\\)$/#\\\\1/g' /etc/fstab`}
\n

{`Installation`}

\n

{`Before initiating a new Kubernetes cluster, make sure you have properly cleaned up previous installation (if this was the case ofc).`}

\n 
{`kubeadm reset`}{`\n`}{`rm -rf $HOME/.kube`}
\n

{`Initiate a new Kubernetes cluster using following command. This will use the current CIDR. If you want to use another CIDR, specify following arguments: `}{`--pod-network-cidr=10.244.0.0/16`}{`.`}

\n 
{`kubeadm init`}
\n

{`Once successful you should see the following. Note the `}{`discovery token`}{` which you need to use to connect additional nodes to your cluster.`}

\n 
{`Your Kubernetes control-plane has initialized successfully!`}{`\n`}{`\n`}{`To start using your cluster, you need to run the following as a regular user:`}{`\n`}{`\n`}{`  mkdir -p $HOME/.kube`}{`\n`}{`  sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config`}{`\n`}{`  sudo chown $(id -u):$(id -g) $HOME/.kube/config`}{`\n`}{`\n`}{`You should now deploy a pod network to the cluster.`}{`\n`}{`Run \"kubectl apply -f [podnetwork].yaml\" with one of the options listed at:`}{`\n`}{`  https://kubernetes.io/docs/concepts/cluster-administration/addons/`}{`\n`}{`\n`}{`Then you can join any number of worker nodes by running the following on each as root:`}{`\n`}{`\n`}{`kubeadm join 192.168.1.103:6443 --token ej7ckt.uof7o2iplqf0r2up \\\\`}{`\n`}{`    --discovery-token-ca-cert-hash sha256:9cbcc00d34be2dbd605174802d9e52fbcdd617324c237bf58767b369fa586209`}
\n

{`Now we have a Kubernetes cluster, we need to make sure we add make it available in our `}{`kubeconfig`}{`. This will allow us to query our Kubernetes cluster with the `}{`kubectl`}{` command.`}

\n 
{`mkdir -p $HOME/.kube`}{`\n`}{`cp -i /etc/kubernetes/admin.conf $HOME/.kube/config`}{`\n`}{`chown $(id -u):$(id -g) $HOME/.kube/config`}
\n

{`Untaint all nodes`}

\n

{`By default, and in this example, we only have one node our master node. In a production scenario we would have additional worker nodes. By default the master nodes are marked as `}{`tainted`}{`, this means they cannot run workloads. To allow master nodes to run workloads, we need to untaint them. If we wouldn't do this our pods would never be scheduled, as we do not have worker nodes at this moment.`}

\n 
{`kubectl taint nodes --all node-role.kubernetes.io/master-`}
\n

{`Calico`}

\n

{`Calico is an open source networking and network security solution for containers, virtual machines, and native host-based workloads. (`}{`https://www.projectcalico.org/`}{`). We will use it as our network layer in our Kubernetes cluster. You could use otthers like Flannel aswell, but we prefer Calico.`}

\n 
{`curl https://docs.projectcalico.org/manifests/calico.yaml -O`}{`\n`}{`kubectl apply -f calico.yaml`}
\n

{`Kerberos Enterprise`}

\n

{`Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.`}

\n 
{`git clone https://github.com/kerberos-io/enterprise`}{`\n`}{`kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml`}
\n

{`This will make several actions, permissions, inside your cluster available. We need this to be able to create deployments from the Kerberos Enterprise web app.`}

\n

{`MetalLB`}

\n

{`In the Edge world, we do not have fancy Load balancers and Public IP from which we can benefit. To overcome this solutions such as MetalLB - Baremetal Load Balancer - have been developed (`}{`https://metallb.universe.tf/installation/`}{`). MetalLB will dedicate an internal IP address, or IP range, which will be assigned to one or more Load Balancers.`}

\n 
{`kubectl apply -f https://raw.githubusercontent.com/metallb/metallb/v0.9.5/manifests/namespace.yaml`}{`\n`}{`kubectl apply -f https://raw.githubusercontent.com/metallb/metallb/v0.9.5/manifests/metallb.yaml`}{`\n`}{`kubectl create secret generic -n metallb-system memberlist --from-literal=secretkey=\"$(openssl rand -base64 128)\"`}
\n

{`After installing the different MetalLB components, we need to create a `}{`configmap.yaml`}{` file. This file contains information of how MetalLB can get and use internal IP's as LoadBalancers.`}

\n 
{`  apiVersion: v1`}{`\n`}{`  kind: ConfigMap`}{`\n`}{`  metadata:`}{`\n`}{`    namespace: metallb-system`}{`\n`}{`    name: config`}{`\n`}{`  data:`}{`\n`}{`    config: |`}{`\n`}{`      address-pools:`}{`\n`}{`      - name: default`}{`\n`}{`        protocol: layer2`}{`\n`}{`        addresses:`}{`\n`}{`-->     - 192.168.1.200-192.168.1.210`}
\n

{`You can change the IP range above to match your needs. MetalLB will use this range as a referance to assign IP addresses to your LoadBalancers. Once ready you can apply the configration map.`}

\n 
{`kubectl apply -f ./enterprise/yaml/metallb/configmap.yaml`}
\n

{`Helm`}

\n

{`Before we can start with the real work, I know we had to do a lot of preparation, we have to install another helpful tool `}{`Helm`}{`. Helm is a package manager for Kubernetes, and really makes you life easier.`}

\n 
{`curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3`}{`\n`}{`chmod 700 get_helm.sh`}{`\n`}{`./get_helm.sh`}
\n

{`This will make sure helm 3 is installed.`}

\n

{`Traefik`}

\n

{`To access the Kerberos Enterprise web application, we will create a service in the next paragraphs. This service will expose the web application as an Ingress. Thanks to our previous installation with MetalLB and Traefik (what we will do now), we will have a neat solution for managing our hostnames and Load Balancing IPs.`}

\n

{`The idea is that Traefik, will have a dedicated IP address assigned from MetalLB, and will resolve the Ingress of our Kerberos Enterprise web app. Let's go ahead with installing Traefik.`}

\n 
{`helm repo add stable https://charts.helm.sh/stable`}{`\n`}{`helm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik`}
\n

{`MongoDB`}

\n

{`When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use `}{`helm`}{` to install a MongoDB instance inside your cluster.`}

\n

{`Before we can move into the installation of MongoDB, in contrary with the cloud installation, we will need to create a Persistent Volume (PV). For simplicity we will use `}{`local-storage`}{`, and make sure the volume is assigned to a specific node (hostname).`}

\n

{`Create a folder on the node (VM), where you want to persist the data of MongoDB.`}

\n 
{`mkdir /home/mongodb/`}
\n

{`Once done open the `}{`./enterprise/yaml/mongodb/volume.yaml`}{` file and make sure to change capacity, local path (if changed) and the hostname attribute (VM/machine, on which the directory is made available).`}

\n 
{`    spec:`}{`\n`}{`      capacity:`}{`\n`}{`-->    storage: 10Gi`}{`\n`}{`      accessModes:`}{`\n`}{`      - ReadWriteOnce`}{`\n`}{`      persistentVolumeReclaimPolicy: Recycle`}{`\n`}{`      storageClassName: local-storage`}{`\n`}{`      local:`}{`\n`}{`-->    path: /home/mongodb/`}{`\n`}{`      nodeAffinity:`}{`\n`}{`        required:`}{`\n`}{`          nodeSelectorTerms:`}{`\n`}{`          - matchExpressions:`}{`\n`}{`            - key: kubernetes.io/hostname`}{`\n`}{`              operator: In`}{`\n`}{`              values:`}{`\n`}{`-->           - hostname`}
\n

{`After modified properly you can go ahead with creating the PV.`}

\n 
{`kubectl create -f ./enterprise/yaml/mongodb/volume.yaml`}
\n

{`Have a look into the `}{`./enterprise/yaml/mongodb/values.yaml`}{` file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of MongoDB. `}

\n 
{`helm repo add bitnami https://charts.bitnami.com/bitnami`}{`\n`}{`helm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values-edge.yaml`}
\n

{`Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.`}

\n 
{`export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)`}{`\n`}{`echo $MONGODB_ROOT_PASSWORD`}
\n

{`Kerberos Enterprise Web App - The Factory`}

\n

{`The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the `}{`Factory`}{`. It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.`}

\n

{`The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the `}{`kubectl`}{` command.`}

\n

{`Before installing the Factory web app, open the `}{`./enterprise/yaml/factory/deployment.yaml`}{` configuration file. At the bottom file you will find two endpoints, similar to the traefik config file. Update the domain names to your own domain, and add these to your DNS server (pointing to the same IP as the traefik EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 8081`}
\n

{`Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.`}

\n 
{`kubectl apply -f ./enterprise/yaml/factory/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Factory`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`factory-6f5c877d7c-hf77p          1/1     Running   0          2d11h`}{`\n`}{`mongodb-758d5c5ddd-qsfq9          1/1     Running   0          5m31s`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain `}{`factory.domain.com`}{` in your browser you will see the Factory login page showing up.`}

\n

\"Factory\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-28c23f6b92668641777e341932e3a946.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-28c23f6b92668641777e341932e3a946.json index bd7f947..dad42eb 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-28c23f6b92668641777e341932e3a946.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-28c23f6b92668641777e341932e3a946.json @@ -1 +1 @@ -{"expireTime":9007200861747672000,"key":"gatsby-plugin-mdx-entire-payload-5a587a4c07886e792dfc60544b7f0675-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise can be installed where Kubernetes can be installed. This means that it can run at the Edge - Baremetal -, in the cloud - VMs - or at Kubernetes service providers - SAAS - such as GCP, Azure, AWS, DigitalOcean, and the list goes on.","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":252,"offset":486},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":252,"offset":486},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Although you might except Kubernetes at the Edge or Kubernetes in the cloud, there are no differences, well sorry to say there are. As Kubernetes service providers implemented features such as LoadBalancers, Persistent Volumes, and others, they have automated and integrated a huge portion of the Kubernetes stack with their related PAAS services. To be more concrete if you are running a Kubernetes Cluster on GCP, you will use the LoadBalancing and Storage services from GCP.","position":{"start":{"line":14,"column":1,"offset":488},"end":{"line":14,"column":478,"offset":965},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":488},"end":{"line":14,"column":478,"offset":965},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-enterprise-kubernetes.png","alt":"enterprise kubernetes","position":{"start":{"line":16,"column":1,"offset":967},"end":{"line":16,"column":81,"offset":1047},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":967},"end":{"line":16,"column":81,"offset":1047},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Compared to Kubernetes at the Edge, there are no predefined LoadBalancers, Storage capabilities, and more. This means more administration work for you, but - with great power comes great responsibility - so no worries. In the end there are alternative functionalties available, for features which you find out-of-the-box at the Kubernetes service providers, you just have to spend more time on configuring and installing those services/pods/deployments yourself.","position":{"start":{"line":18,"column":1,"offset":1049},"end":{"line":18,"column":463,"offset":1511},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1049},"end":{"line":18,"column":463,"offset":1511},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Installation on a Kubernetes Service Provider","position":{"start":{"line":20,"column":4,"offset":1516},"end":{"line":20,"column":49,"offset":1561},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1513},"end":{"line":20,"column":49,"offset":1561},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Installing Kerberos Enterprise on a Kubernetes Service Provider (Azure, GCP, AWS) is straight forward, as you can create a Kubernetes cluster in a few clicks, get access to public Load Balancers, storage and more. Running Kerberos Enterprise in such a cluster is just a matter of copy-pasting some configuration (yaml) files, and executing some ","position":{"start":{"line":22,"column":1,"offset":1563},"end":{"line":22,"column":346,"offset":1908},"indent":[]}},{"type":"inlineCode","value":"kubectl apply","position":{"start":{"line":22,"column":346,"offset":1908},"end":{"line":22,"column":361,"offset":1923},"indent":[]}},{"type":"text","value":" commands.","position":{"start":{"line":22,"column":361,"offset":1923},"end":{"line":22,"column":371,"offset":1933},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1563},"end":{"line":22,"column":371,"offset":1933},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":24,"column":1,"offset":1935},"end":{"line":24,"column":97,"offset":2031},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1935},"end":{"line":24,"column":97,"offset":2031},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Install Kerberos Enterprise on a Kubernetes Service Provider by ","position":{"start":{"line":26,"column":1,"offset":2033},"end":{"line":26,"column":65,"offset":2097},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/installation-cloud","children":[{"type":"text","value":"following this step-by-step installation guide","position":{"start":{"line":26,"column":66,"offset":2098},"end":{"line":26,"column":112,"offset":2144},"indent":[]}}],"position":{"start":{"line":26,"column":65,"offset":2097},"end":{"line":26,"column":145,"offset":2177},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":26,"column":145,"offset":2177},"end":{"line":26,"column":146,"offset":2178},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":2033},"end":{"line":26,"column":146,"offset":2178},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Installation in Private Cloud or Baremetal","position":{"start":{"line":28,"column":4,"offset":2183},"end":{"line":28,"column":46,"offset":2225},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":2180},"end":{"line":28,"column":46,"offset":2225},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"No need to install Kerberos Enterprise on a Kubernetes Service Provider, you could install it on your own Kubernetes cluster in your private cloud, or even better inside your own premise. The closer you bring Kerberos Enterprise to your surveillance infrastructure, the more benefits you will experience (low latency, low bandwidth, etc).","position":{"start":{"line":30,"column":1,"offset":2227},"end":{"line":30,"column":339,"offset":2565},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2227},"end":{"line":30,"column":339,"offset":2565},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":32,"column":1,"offset":2567},"end":{"line":32,"column":91,"offset":2657},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2567},"end":{"line":32,"column":91,"offset":2657},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In contradiction to the Kubernetes Service Provider, you will have some work todo. Setting up Kubernetes Cluster, play with MetalLB, Persistent Volumes and claims. Don't be scared, it's pretty ssttraight forward as well. You can't simple expect a: click, click, 💥 approach.","position":{"start":{"line":34,"column":1,"offset":2659},"end":{"line":34,"column":275,"offset":2933},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2659},"end":{"line":34,"column":275,"offset":2933},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Install Kerberos Enterprise on a Private cloud or Baremetal by ","position":{"start":{"line":36,"column":1,"offset":2935},"end":{"line":36,"column":64,"offset":2998},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/installation-edge","children":[{"type":"text","value":"following this step-by-step installation guide","position":{"start":{"line":36,"column":65,"offset":2999},"end":{"line":36,"column":111,"offset":3045},"indent":[]}}],"position":{"start":{"line":36,"column":64,"offset":2998},"end":{"line":36,"column":143,"offset":3077},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":36,"column":143,"offset":3077},"end":{"line":36,"column":144,"offset":3078},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2935},"end":{"line":36,"column":144,"offset":3078},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":39,"column":1,"offset":3081},"end":{"line":39,"column":31,"offset":3111},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":39,"column":31,"offset":3111}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Installation`}

\n

{`Kerberos Enterprise can be installed where Kubernetes can be installed. This means that it can run at the Edge - Baremetal -, in the cloud - VMs - or at Kubernetes service providers - SAAS - such as GCP, Azure, AWS, DigitalOcean, and the list goes on.`}

\n

{`Although you might except Kubernetes at the Edge or Kubernetes in the cloud, there are no differences, well sorry to say there are. As Kubernetes service providers implemented features such as LoadBalancers, Persistent Volumes, and others, they have automated and integrated a huge portion of the Kubernetes stack with their related PAAS services. To be more concrete if you are running a Kubernetes Cluster on GCP, you will use the LoadBalancing and Storage services from GCP.`}

\n

\"enterprise

\n

{`Compared to Kubernetes at the Edge, there are no predefined LoadBalancers, Storage capabilities, and more. This means more administration work for you, but - with great power comes great responsibility - so no worries. In the end there are alternative functionalties available, for features which you find out-of-the-box at the Kubernetes service providers, you just have to spend more time on configuring and installing those services/pods/deployments yourself.`}

\n

{`Installation on a Kubernetes Service Provider`}

\n

{`Installing Kerberos Enterprise on a Kubernetes Service Provider (Azure, GCP, AWS) is straight forward, as you can create a Kubernetes cluster in a few clicks, get access to public Load Balancers, storage and more. Running Kerberos Enterprise in such a cluster is just a matter of copy-pasting some configuration (yaml) files, and executing some `}{`kubectl apply`}{` commands.`}

\n

\"architecture

\n

{`Install Kerberos Enterprise on a Kubernetes Service Provider by `}{`following this step-by-step installation guide`}{`.`}

\n

{`Installation in Private Cloud or Baremetal`}

\n

{`No need to install Kerberos Enterprise on a Kubernetes Service Provider, you could install it on your own Kubernetes cluster in your private cloud, or even better inside your own premise. The closer you bring Kerberos Enterprise to your surveillance infrastructure, the more benefits you will experience (low latency, low bandwidth, etc).`}

\n

\"architecture

\n

{`In contradiction to the Kubernetes Service Provider, you will have some work todo. Setting up Kubernetes Cluster, play with MetalLB, Persistent Volumes and claims. Don't be scared, it's pretty ssttraight forward as well. You can't simple expect a: click, click, 💥 approach.`}

\n

{`Install Kerberos Enterprise on a Private cloud or Baremetal by `}{`following this step-by-step installation guide`}{`.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750176000,"key":"gatsby-plugin-mdx-entire-payload-5a587a4c07886e792dfc60544b7f0675-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise can be installed where Kubernetes can be installed. This means that it can run at the Edge - Baremetal -, in the cloud - VMs - or at Kubernetes service providers - SAAS - such as GCP, Azure, AWS, DigitalOcean, and the list goes on.","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":252,"offset":486},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":252,"offset":486},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Although you might except Kubernetes at the Edge or Kubernetes in the cloud, there are no differences, well sorry to say there are. As Kubernetes service providers implemented features such as LoadBalancers, Persistent Volumes, and others, they have automated and integrated a huge portion of the Kubernetes stack with their related PAAS services. To be more concrete if you are running a Kubernetes Cluster on GCP, you will use the LoadBalancing and Storage services from GCP.","position":{"start":{"line":14,"column":1,"offset":488},"end":{"line":14,"column":478,"offset":965},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":488},"end":{"line":14,"column":478,"offset":965},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-enterprise-kubernetes.png","alt":"enterprise kubernetes","position":{"start":{"line":16,"column":1,"offset":967},"end":{"line":16,"column":81,"offset":1047},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":967},"end":{"line":16,"column":81,"offset":1047},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Compared to Kubernetes at the Edge, there are no predefined LoadBalancers, Storage capabilities, and more. This means more administration work for you, but - with great power comes great responsibility - so no worries. In the end there are alternative functionalties available, for features which you find out-of-the-box at the Kubernetes service providers, you just have to spend more time on configuring and installing those services/pods/deployments yourself.","position":{"start":{"line":18,"column":1,"offset":1049},"end":{"line":18,"column":463,"offset":1511},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1049},"end":{"line":18,"column":463,"offset":1511},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Installation on a Kubernetes Service Provider","position":{"start":{"line":20,"column":4,"offset":1516},"end":{"line":20,"column":49,"offset":1561},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1513},"end":{"line":20,"column":49,"offset":1561},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Installing Kerberos Enterprise on a Kubernetes Service Provider (Azure, GCP, AWS) is straight forward, as you can create a Kubernetes cluster in a few clicks, get access to public Load Balancers, storage and more. Running Kerberos Enterprise in such a cluster is just a matter of copy-pasting some configuration (yaml) files, and executing some ","position":{"start":{"line":22,"column":1,"offset":1563},"end":{"line":22,"column":346,"offset":1908},"indent":[]}},{"type":"inlineCode","value":"kubectl apply","position":{"start":{"line":22,"column":346,"offset":1908},"end":{"line":22,"column":361,"offset":1923},"indent":[]}},{"type":"text","value":" commands.","position":{"start":{"line":22,"column":361,"offset":1923},"end":{"line":22,"column":371,"offset":1933},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1563},"end":{"line":22,"column":371,"offset":1933},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":24,"column":1,"offset":1935},"end":{"line":24,"column":97,"offset":2031},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1935},"end":{"line":24,"column":97,"offset":2031},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Install Kerberos Enterprise on a Kubernetes Service Provider by ","position":{"start":{"line":26,"column":1,"offset":2033},"end":{"line":26,"column":65,"offset":2097},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/installation-cloud","children":[{"type":"text","value":"following this step-by-step installation guide","position":{"start":{"line":26,"column":66,"offset":2098},"end":{"line":26,"column":112,"offset":2144},"indent":[]}}],"position":{"start":{"line":26,"column":65,"offset":2097},"end":{"line":26,"column":145,"offset":2177},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":26,"column":145,"offset":2177},"end":{"line":26,"column":146,"offset":2178},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":2033},"end":{"line":26,"column":146,"offset":2178},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Installation in Private Cloud or Baremetal","position":{"start":{"line":28,"column":4,"offset":2183},"end":{"line":28,"column":46,"offset":2225},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":2180},"end":{"line":28,"column":46,"offset":2225},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"No need to install Kerberos Enterprise on a Kubernetes Service Provider, you could install it on your own Kubernetes cluster in your private cloud, or even better inside your own premise. The closer you bring Kerberos Enterprise to your surveillance infrastructure, the more benefits you will experience (low latency, low bandwidth, etc).","position":{"start":{"line":30,"column":1,"offset":2227},"end":{"line":30,"column":339,"offset":2565},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2227},"end":{"line":30,"column":339,"offset":2565},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":32,"column":1,"offset":2567},"end":{"line":32,"column":91,"offset":2657},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2567},"end":{"line":32,"column":91,"offset":2657},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In contradiction to the Kubernetes Service Provider, you will have some work todo. Setting up Kubernetes Cluster, play with MetalLB, Persistent Volumes and claims. Don't be scared, it's pretty ssttraight forward as well. You can't simple expect a: click, click, 💥 approach.","position":{"start":{"line":34,"column":1,"offset":2659},"end":{"line":34,"column":275,"offset":2933},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2659},"end":{"line":34,"column":275,"offset":2933},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Install Kerberos Enterprise on a Private cloud or Baremetal by ","position":{"start":{"line":36,"column":1,"offset":2935},"end":{"line":36,"column":64,"offset":2998},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/installation-edge","children":[{"type":"text","value":"following this step-by-step installation guide","position":{"start":{"line":36,"column":65,"offset":2999},"end":{"line":36,"column":111,"offset":3045},"indent":[]}}],"position":{"start":{"line":36,"column":64,"offset":2998},"end":{"line":36,"column":143,"offset":3077},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":36,"column":143,"offset":3077},"end":{"line":36,"column":144,"offset":3078},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2935},"end":{"line":36,"column":144,"offset":3078},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":39,"column":1,"offset":3081},"end":{"line":39,"column":31,"offset":3111},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":39,"column":31,"offset":3111}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Installation`}

\n

{`Kerberos Enterprise can be installed where Kubernetes can be installed. This means that it can run at the Edge - Baremetal -, in the cloud - VMs - or at Kubernetes service providers - SAAS - such as GCP, Azure, AWS, DigitalOcean, and the list goes on.`}

\n

{`Although you might except Kubernetes at the Edge or Kubernetes in the cloud, there are no differences, well sorry to say there are. As Kubernetes service providers implemented features such as LoadBalancers, Persistent Volumes, and others, they have automated and integrated a huge portion of the Kubernetes stack with their related PAAS services. To be more concrete if you are running a Kubernetes Cluster on GCP, you will use the LoadBalancing and Storage services from GCP.`}

\n

\"enterprise

\n

{`Compared to Kubernetes at the Edge, there are no predefined LoadBalancers, Storage capabilities, and more. This means more administration work for you, but - with great power comes great responsibility - so no worries. In the end there are alternative functionalties available, for features which you find out-of-the-box at the Kubernetes service providers, you just have to spend more time on configuring and installing those services/pods/deployments yourself.`}

\n

{`Installation on a Kubernetes Service Provider`}

\n

{`Installing Kerberos Enterprise on a Kubernetes Service Provider (Azure, GCP, AWS) is straight forward, as you can create a Kubernetes cluster in a few clicks, get access to public Load Balancers, storage and more. Running Kerberos Enterprise in such a cluster is just a matter of copy-pasting some configuration (yaml) files, and executing some `}{`kubectl apply`}{` commands.`}

\n

\"architecture

\n

{`Install Kerberos Enterprise on a Kubernetes Service Provider by `}{`following this step-by-step installation guide`}{`.`}

\n

{`Installation in Private Cloud or Baremetal`}

\n

{`No need to install Kerberos Enterprise on a Kubernetes Service Provider, you could install it on your own Kubernetes cluster in your private cloud, or even better inside your own premise. The closer you bring Kerberos Enterprise to your surveillance infrastructure, the more benefits you will experience (low latency, low bandwidth, etc).`}

\n

\"architecture

\n

{`In contradiction to the Kubernetes Service Provider, you will have some work todo. Setting up Kubernetes Cluster, play with MetalLB, Persistent Volumes and claims. Don't be scared, it's pretty ssttraight forward as well. You can't simple expect a: click, click, 💥 approach.`}

\n

{`Install Kerberos Enterprise on a Private cloud or Baremetal by `}{`following this step-by-step installation guide`}{`.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2be2590779b804ede018a8925fff1146.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2be2590779b804ede018a8925fff1146.json index 8ea8298..2958e3b 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2be2590779b804ede018a8925fff1146.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2be2590779b804ede018a8925fff1146.json @@ -1 +1 @@ -{"expireTime":9007200861747672000,"key":"gatsby-plugin-mdx-entire-payload-288833c279b8ca663cd64d85ba356e57-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Release notes","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":16,"offset":174},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":16,"offset":174},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1.0.0","position":{"start":{"line":10,"column":5,"offset":180},"end":{"line":10,"column":10,"offset":185},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":176},"end":{"line":10,"column":10,"offset":185},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Factory","position":{"start":{"line":12,"column":6,"offset":192},"end":{"line":12,"column":13,"offset":199},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":187},"end":{"line":12,"column":13,"offset":199},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"React application using the Kubernetes and Docker Golang SDK.","position":{"start":{"line":14,"column":3,"offset":203},"end":{"line":14,"column":64,"offset":264},"indent":[]}}],"position":{"start":{"line":14,"column":3,"offset":203},"end":{"line":14,"column":64,"offset":264},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":201},"end":{"line":14,"column":64,"offset":264},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Possibility to add deployments one by one or in bulk (Excel).","position":{"start":{"line":15,"column":3,"offset":267},"end":{"line":15,"column":64,"offset":328},"indent":[]}}],"position":{"start":{"line":15,"column":3,"offset":267},"end":{"line":15,"column":64,"offset":328},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":265},"end":{"line":15,"column":64,"offset":328},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Configure machinery deployments: select a region of interest, specify recording time (pre, andd post recording), specify time interval.","position":{"start":{"line":16,"column":3,"offset":331},"end":{"line":16,"column":138,"offset":466},"indent":[]}}],"position":{"start":{"line":16,"column":3,"offset":331},"end":{"line":16,"column":138,"offset":466},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":329},"end":{"line":16,"column":138,"offset":466},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Global configuration page, where you specify your cloud credentials at a single place.","position":{"start":{"line":17,"column":3,"offset":469},"end":{"line":17,"column":89,"offset":555},"indent":[]}}],"position":{"start":{"line":17,"column":3,"offset":469},"end":{"line":17,"column":89,"offset":555},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":467},"end":{"line":17,"column":89,"offset":555},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":201},"end":{"line":17,"column":89,"offset":555},"indent":[1,1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":20,"column":1,"offset":558},"end":{"line":20,"column":31,"offset":588},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":20,"column":31,"offset":588}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Release notes`}

\n

{`1.0.0`}

\n

{`Factory`}

\n
    \n
  • {`React application using the Kubernetes and Docker Golang SDK.`}
    • \n
  • {`Possibility to add deployments one by one or in bulk (Excel).`}
    • \n
  • {`Configure machinery deployments: select a region of interest, specify recording time (pre, andd post recording), specify time interval.`}
    • \n
  • {`Global configuration page, where you specify your cloud credentials at a single place.`}
    • \n
\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750177000,"key":"gatsby-plugin-mdx-entire-payload-288833c279b8ca663cd64d85ba356e57-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Release notes","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":16,"offset":174},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":16,"offset":174},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1.0.0","position":{"start":{"line":10,"column":5,"offset":180},"end":{"line":10,"column":10,"offset":185},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":176},"end":{"line":10,"column":10,"offset":185},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Factory","position":{"start":{"line":12,"column":6,"offset":192},"end":{"line":12,"column":13,"offset":199},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":187},"end":{"line":12,"column":13,"offset":199},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"React application using the Kubernetes and Docker Golang SDK.","position":{"start":{"line":14,"column":3,"offset":203},"end":{"line":14,"column":64,"offset":264},"indent":[]}}],"position":{"start":{"line":14,"column":3,"offset":203},"end":{"line":14,"column":64,"offset":264},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":201},"end":{"line":14,"column":64,"offset":264},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Possibility to add deployments one by one or in bulk (Excel).","position":{"start":{"line":15,"column":3,"offset":267},"end":{"line":15,"column":64,"offset":328},"indent":[]}}],"position":{"start":{"line":15,"column":3,"offset":267},"end":{"line":15,"column":64,"offset":328},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":265},"end":{"line":15,"column":64,"offset":328},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Configure machinery deployments: select a region of interest, specify recording time (pre, andd post recording), specify time interval.","position":{"start":{"line":16,"column":3,"offset":331},"end":{"line":16,"column":138,"offset":466},"indent":[]}}],"position":{"start":{"line":16,"column":3,"offset":331},"end":{"line":16,"column":138,"offset":466},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":329},"end":{"line":16,"column":138,"offset":466},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Global configuration page, where you specify your cloud credentials at a single place.","position":{"start":{"line":17,"column":3,"offset":469},"end":{"line":17,"column":89,"offset":555},"indent":[]}}],"position":{"start":{"line":17,"column":3,"offset":469},"end":{"line":17,"column":89,"offset":555},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":467},"end":{"line":17,"column":89,"offset":555},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":201},"end":{"line":17,"column":89,"offset":555},"indent":[1,1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":20,"column":1,"offset":558},"end":{"line":20,"column":31,"offset":588},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":20,"column":31,"offset":588}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Release notes`}

\n

{`1.0.0`}

\n

{`Factory`}

\n
    \n
  • {`React application using the Kubernetes and Docker Golang SDK.`}
    • \n
  • {`Possibility to add deployments one by one or in bulk (Excel).`}
    • \n
  • {`Configure machinery deployments: select a region of interest, specify recording time (pre, andd post recording), specify time interval.`}
    • \n
  • {`Global configuration page, where you specify your cloud credentials at a single place.`}
    • \n
\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2c3ddf334fe23d42280849c4b96aa930.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2c3ddf334fe23d42280849c4b96aa930.json index 40f117e..9705c3a 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2c3ddf334fe23d42280849c4b96aa930.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2c3ddf334fe23d42280849c4b96aa930.json @@ -1 +1 @@ -{"expireTime":9007200861747672000,"key":"gatsby-plugin-mdx-entire-payload-e33397a78cd5cc18828790f323062ecb-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":15,"offset":173},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":15,"offset":173},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The ","position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":5,"offset":179},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Kerberos(dot)io","position":{"start":{"line":10,"column":7,"offset":181},"end":{"line":10,"column":22,"offset":196},"indent":[]}}],"position":{"start":{"line":10,"column":5,"offset":179},"end":{"line":10,"column":24,"offset":198},"indent":[]}},{"type":"text","value":" project, is a video surveillance solution, which was initiated back in 2014. Over the years it has evolved into a trusted, stable and feature-rich video surveillance system. To set the expectations, watch the video below to understand what it can and can't do. If you want to install Kerberos(dot)io, it's recommended to have a look ","position":{"start":{"line":10,"column":24,"offset":198},"end":{"line":10,"column":358,"offset":532},"indent":[]}},{"type":"link","title":null,"url":"/architectures","children":[{"type":"text","value":"at the architectures page","position":{"start":{"line":10,"column":359,"offset":533},"end":{"line":10,"column":384,"offset":558},"indent":[]}}],"position":{"start":{"line":10,"column":358,"offset":532},"end":{"line":10,"column":401,"offset":575},"indent":[]}},{"type":"text","value":" to find the best solution for your usecase.","position":{"start":{"line":10,"column":401,"offset":575},"end":{"line":10,"column":445,"offset":619},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":445,"offset":619},"indent":[]}},{"type":"jsx","value":"
","position":{"start":{"line":12,"column":1,"offset":621},"end":{"line":12,"column":186,"offset":806},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"The name: Kerberos.io","position":{"start":{"line":14,"column":4,"offset":811},"end":{"line":14,"column":25,"offset":832},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":808},"end":{"line":14,"column":25,"offset":832},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Many people are confused, and don't understand why this project is called Kerberos(dot)io. If you've been in the IT world for a while you will notice that Kerberos is already used for the authentication protocol ","position":{"start":{"line":16,"column":1,"offset":834},"end":{"line":16,"column":213,"offset":1046},"indent":[]}},{"type":"link","title":null,"url":"https://en.wikipedia.org/wiki/Kerberos_(protocol)","children":[{"type":"text","value":"Kerberos","position":{"start":{"line":16,"column":214,"offset":1047},"end":{"line":16,"column":222,"offset":1055},"indent":[]}}],"position":{"start":{"line":16,"column":213,"offset":1046},"end":{"line":16,"column":274,"offset":1107},"indent":[]}},{"type":"text","value":".\nWe believe that the name Kerberos(dot)io makes sense for this project as well, with a strong emphasize on the suffix ","position":{"start":{"line":16,"column":274,"offset":1107},"end":{"line":17,"column":118,"offset":1226},"indent":[1]}},{"type":"strong","children":[{"type":"text","value":".io","position":{"start":{"line":17,"column":120,"offset":1228},"end":{"line":17,"column":123,"offset":1231},"indent":[]}}],"position":{"start":{"line":17,"column":118,"offset":1226},"end":{"line":17,"column":125,"offset":1233},"indent":[]}},{"type":"text","value":", which stands for input and output devices (e.g. any type of camera). Kerberos(dot)io can be seen as a kind of security protocol driven by hardware devices such as surveillance cameras. To make writing easier we will from now on, refer to Kerberos instead of Kerberos(dot)io.","position":{"start":{"line":17,"column":125,"offset":1233},"end":{"line":17,"column":401,"offset":1509},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":834},"end":{"line":17,"column":401,"offset":1509},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Why Kerberos","position":{"start":{"line":19,"column":4,"offset":1514},"end":{"line":19,"column":16,"offset":1526},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":1511},"end":{"line":19,"column":16,"offset":1526},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"As burglary is very common, we believe that video surveillance is a trivial tool in our daily lifes which helps us to feel a little bit more secure. Responding to this need, a lot of companies have started developing their own video surveillance software in the past few years.","position":{"start":{"line":21,"column":1,"offset":1528},"end":{"line":21,"column":278,"offset":1805},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1528},"end":{"line":21,"column":278,"offset":1805},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nowadays we have a myriad of expensive cameras, recorders, and software solutions which are mainly outdated and difficult to install and use. Kerberos goal is to solve these problems and to provide every human being or enterprise in this world to have their own ecological, affordable, easy-to-use and innovative surveillance solution.","position":{"start":{"line":23,"column":1,"offset":1807},"end":{"line":23,"column":336,"offset":2142},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1807},"end":{"line":23,"column":336,"offset":2142},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"What is Kerberos","position":{"start":{"line":25,"column":4,"offset":2147},"end":{"line":25,"column":20,"offset":2163},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":2144},"end":{"line":25,"column":20,"offset":2163},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos is a video surveillance solution, that uses computer vision algorithms to detect changes, and that can trigger actions (notifications, api, etc). It comes in two flavors, Kerberos Open Source and Kerberos Enterprise. Kerberos can be deployed to any ARM device, Linux OS, Docker, Balenca Cloud, or cluster such as Kubernetes.","position":{"start":{"line":27,"column":1,"offset":2165},"end":{"line":27,"column":334,"offset":2498},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":2165},"end":{"line":27,"column":334,"offset":2498},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Agent","position":{"start":{"line":29,"column":5,"offset":2504},"end":{"line":29,"column":19,"offset":2518},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":2500},"end":{"line":29,"column":19,"offset":2518},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When you install Kerberos Open Source or Kerberos Enterprise we will refer to it as the Kerberos agent. A Kerberos agent, is a software solution that processes the video stream of a single surveillance camera, makes and visualises recordings and takes actions (for example sending notifications).","position":{"start":{"line":31,"column":1,"offset":2520},"end":{"line":31,"column":297,"offset":2816},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":2520},"end":{"line":31,"column":297,"offset":2816},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":34,"column":1,"offset":2819},"end":{"line":34,"column":31,"offset":2849},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":34,"column":31,"offset":2849}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Introduction`}

\n

{`The `}{`Kerberos(dot)io`}{` project, is a video surveillance solution, which was initiated back in 2014. Over the years it has evolved into a trusted, stable and feature-rich video surveillance system. To set the expectations, watch the video below to understand what it can and can't do. If you want to install Kerberos(dot)io, it's recommended to have a look `}{`at the architectures page`}{` to find the best solution for your usecase.`}

\n
\n

{`The name: Kerberos.io`}

\n

{`Many people are confused, and don't understand why this project is called Kerberos(dot)io. If you've been in the IT world for a while you will notice that Kerberos is already used for the authentication protocol `}{`Kerberos`}{`.\nWe believe that the name Kerberos(dot)io makes sense for this project as well, with a strong emphasize on the suffix `}{`.io`}{`, which stands for input and output devices (e.g. any type of camera). Kerberos(dot)io can be seen as a kind of security protocol driven by hardware devices such as surveillance cameras. To make writing easier we will from now on, refer to Kerberos instead of Kerberos(dot)io.`}

\n

{`Why Kerberos`}

\n

{`As burglary is very common, we believe that video surveillance is a trivial tool in our daily lifes which helps us to feel a little bit more secure. Responding to this need, a lot of companies have started developing their own video surveillance software in the past few years.`}

\n

{`Nowadays we have a myriad of expensive cameras, recorders, and software solutions which are mainly outdated and difficult to install and use. Kerberos goal is to solve these problems and to provide every human being or enterprise in this world to have their own ecological, affordable, easy-to-use and innovative surveillance solution.`}

\n

{`What is Kerberos`}

\n

{`Kerberos is a video surveillance solution, that uses computer vision algorithms to detect changes, and that can trigger actions (notifications, api, etc). It comes in two flavors, Kerberos Open Source and Kerberos Enterprise. Kerberos can be deployed to any ARM device, Linux OS, Docker, Balenca Cloud, or cluster such as Kubernetes.`}

\n

{`Kerberos Agent`}

\n

{`When you install Kerberos Open Source or Kerberos Enterprise we will refer to it as the Kerberos agent. A Kerberos agent, is a software solution that processes the video stream of a single surveillance camera, makes and visualises recordings and takes actions (for example sending notifications).`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750176000,"key":"gatsby-plugin-mdx-entire-payload-e33397a78cd5cc18828790f323062ecb-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":15,"offset":173},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":15,"offset":173},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The ","position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":5,"offset":179},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Kerberos(dot)io","position":{"start":{"line":10,"column":7,"offset":181},"end":{"line":10,"column":22,"offset":196},"indent":[]}}],"position":{"start":{"line":10,"column":5,"offset":179},"end":{"line":10,"column":24,"offset":198},"indent":[]}},{"type":"text","value":" project, is a video surveillance solution, which was initiated back in 2014. Over the years it has evolved into a trusted, stable and feature-rich video surveillance system. To set the expectations, watch the video below to understand what it can and can't do. If you want to install Kerberos(dot)io, it's recommended to have a look ","position":{"start":{"line":10,"column":24,"offset":198},"end":{"line":10,"column":358,"offset":532},"indent":[]}},{"type":"link","title":null,"url":"/architectures","children":[{"type":"text","value":"at the architectures page","position":{"start":{"line":10,"column":359,"offset":533},"end":{"line":10,"column":384,"offset":558},"indent":[]}}],"position":{"start":{"line":10,"column":358,"offset":532},"end":{"line":10,"column":401,"offset":575},"indent":[]}},{"type":"text","value":" to find the best solution for your usecase.","position":{"start":{"line":10,"column":401,"offset":575},"end":{"line":10,"column":445,"offset":619},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":445,"offset":619},"indent":[]}},{"type":"jsx","value":"
","position":{"start":{"line":12,"column":1,"offset":621},"end":{"line":12,"column":186,"offset":806},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"The name: Kerberos.io","position":{"start":{"line":14,"column":4,"offset":811},"end":{"line":14,"column":25,"offset":832},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":808},"end":{"line":14,"column":25,"offset":832},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Many people are confused, and don't understand why this project is called Kerberos(dot)io. If you've been in the IT world for a while you will notice that Kerberos is already used for the authentication protocol ","position":{"start":{"line":16,"column":1,"offset":834},"end":{"line":16,"column":213,"offset":1046},"indent":[]}},{"type":"link","title":null,"url":"https://en.wikipedia.org/wiki/Kerberos_(protocol)","children":[{"type":"text","value":"Kerberos","position":{"start":{"line":16,"column":214,"offset":1047},"end":{"line":16,"column":222,"offset":1055},"indent":[]}}],"position":{"start":{"line":16,"column":213,"offset":1046},"end":{"line":16,"column":274,"offset":1107},"indent":[]}},{"type":"text","value":".\nWe believe that the name Kerberos(dot)io makes sense for this project as well, with a strong emphasize on the suffix ","position":{"start":{"line":16,"column":274,"offset":1107},"end":{"line":17,"column":118,"offset":1226},"indent":[1]}},{"type":"strong","children":[{"type":"text","value":".io","position":{"start":{"line":17,"column":120,"offset":1228},"end":{"line":17,"column":123,"offset":1231},"indent":[]}}],"position":{"start":{"line":17,"column":118,"offset":1226},"end":{"line":17,"column":125,"offset":1233},"indent":[]}},{"type":"text","value":", which stands for input and output devices (e.g. any type of camera). Kerberos(dot)io can be seen as a kind of security protocol driven by hardware devices such as surveillance cameras. To make writing easier we will from now on, refer to Kerberos instead of Kerberos(dot)io.","position":{"start":{"line":17,"column":125,"offset":1233},"end":{"line":17,"column":401,"offset":1509},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":834},"end":{"line":17,"column":401,"offset":1509},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Why Kerberos","position":{"start":{"line":19,"column":4,"offset":1514},"end":{"line":19,"column":16,"offset":1526},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":1511},"end":{"line":19,"column":16,"offset":1526},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"As burglary is very common, we believe that video surveillance is a trivial tool in our daily lifes which helps us to feel a little bit more secure. Responding to this need, a lot of companies have started developing their own video surveillance software in the past few years.","position":{"start":{"line":21,"column":1,"offset":1528},"end":{"line":21,"column":278,"offset":1805},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1528},"end":{"line":21,"column":278,"offset":1805},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nowadays we have a myriad of expensive cameras, recorders, and software solutions which are mainly outdated and difficult to install and use. Kerberos goal is to solve these problems and to provide every human being or enterprise in this world to have their own ecological, affordable, easy-to-use and innovative surveillance solution.","position":{"start":{"line":23,"column":1,"offset":1807},"end":{"line":23,"column":336,"offset":2142},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1807},"end":{"line":23,"column":336,"offset":2142},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"What is Kerberos","position":{"start":{"line":25,"column":4,"offset":2147},"end":{"line":25,"column":20,"offset":2163},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":2144},"end":{"line":25,"column":20,"offset":2163},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos is a video surveillance solution, that uses computer vision algorithms to detect changes, and that can trigger actions (notifications, api, etc). It comes in two flavors, Kerberos Open Source and Kerberos Enterprise. Kerberos can be deployed to any ARM device, Linux OS, Docker, Balenca Cloud, or cluster such as Kubernetes.","position":{"start":{"line":27,"column":1,"offset":2165},"end":{"line":27,"column":334,"offset":2498},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":2165},"end":{"line":27,"column":334,"offset":2498},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Agent","position":{"start":{"line":29,"column":5,"offset":2504},"end":{"line":29,"column":19,"offset":2518},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":2500},"end":{"line":29,"column":19,"offset":2518},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When you install Kerberos Open Source or Kerberos Enterprise we will refer to it as the Kerberos agent. A Kerberos agent, is a software solution that processes the video stream of a single surveillance camera, makes and visualises recordings and takes actions (for example sending notifications).","position":{"start":{"line":31,"column":1,"offset":2520},"end":{"line":31,"column":297,"offset":2816},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":2520},"end":{"line":31,"column":297,"offset":2816},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":34,"column":1,"offset":2819},"end":{"line":34,"column":31,"offset":2849},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":34,"column":31,"offset":2849}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Introduction`}

\n

{`The `}{`Kerberos(dot)io`}{` project, is a video surveillance solution, which was initiated back in 2014. Over the years it has evolved into a trusted, stable and feature-rich video surveillance system. To set the expectations, watch the video below to understand what it can and can't do. If you want to install Kerberos(dot)io, it's recommended to have a look `}{`at the architectures page`}{` to find the best solution for your usecase.`}

\n
\n

{`The name: Kerberos.io`}

\n

{`Many people are confused, and don't understand why this project is called Kerberos(dot)io. If you've been in the IT world for a while you will notice that Kerberos is already used for the authentication protocol `}{`Kerberos`}{`.\nWe believe that the name Kerberos(dot)io makes sense for this project as well, with a strong emphasize on the suffix `}{`.io`}{`, which stands for input and output devices (e.g. any type of camera). Kerberos(dot)io can be seen as a kind of security protocol driven by hardware devices such as surveillance cameras. To make writing easier we will from now on, refer to Kerberos instead of Kerberos(dot)io.`}

\n

{`Why Kerberos`}

\n

{`As burglary is very common, we believe that video surveillance is a trivial tool in our daily lifes which helps us to feel a little bit more secure. Responding to this need, a lot of companies have started developing their own video surveillance software in the past few years.`}

\n

{`Nowadays we have a myriad of expensive cameras, recorders, and software solutions which are mainly outdated and difficult to install and use. Kerberos goal is to solve these problems and to provide every human being or enterprise in this world to have their own ecological, affordable, easy-to-use and innovative surveillance solution.`}

\n

{`What is Kerberos`}

\n

{`Kerberos is a video surveillance solution, that uses computer vision algorithms to detect changes, and that can trigger actions (notifications, api, etc). It comes in two flavors, Kerberos Open Source and Kerberos Enterprise. Kerberos can be deployed to any ARM device, Linux OS, Docker, Balenca Cloud, or cluster such as Kubernetes.`}

\n

{`Kerberos Agent`}

\n

{`When you install Kerberos Open Source or Kerberos Enterprise we will refer to it as the Kerberos agent. A Kerberos agent, is a software solution that processes the video stream of a single surveillance camera, makes and visualises recordings and takes actions (for example sending notifications).`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2d3b1915be7b1fc5305dcfd6ffd0508e.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2d3b1915be7b1fc5305dcfd6ffd0508e.json index 73ba489..4f0e8cc 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2d3b1915be7b1fc5305dcfd6ffd0508e.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2d3b1915be7b1fc5305dcfd6ffd0508e.json @@ -1 +1 @@ -{"expireTime":9007200861747673000,"key":"gatsby-plugin-mdx-entire-payload-1312887ada4a7f63b8eebd77ef6812cb-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Cloud","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":8,"offset":166},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":8,"offset":166},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When installing a Kerberos agent inside your local network, it's possible to review your activity by using the agent's web interface. By nature, you will not be able to access the web interface from the cloud (outside your local network). On top of that, the Kerberos agent doesn't come with a consolidated overview. This means that you will need to open multiple web interfaces, one for each connected surveillance camera.","position":{"start":{"line":10,"column":1,"offset":168},"end":{"line":10,"column":424,"offset":591},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":168},"end":{"line":10,"column":424,"offset":591},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To simplify and resolve all of these challenges, Kerberos Cloud was developed.","position":{"start":{"line":12,"column":1,"offset":593},"end":{"line":12,"column":79,"offset":671},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":593},"end":{"line":12,"column":79,"offset":671},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.kerberos.io","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":4,"offset":676},"end":{"line":14,"column":18,"offset":690},"indent":[]}}],"position":{"start":{"line":14,"column":3,"offset":675},"end":{"line":14,"column":46,"offset":718},"indent":[]}},{"type":"text","value":" is a cloud solution which allows you to have a single overview of all the media recordings generated by your surveillance cameras. It's not a solution for processing your surveillance cameras in the cloud. For processing of your surveillance cameras, a Kerberos agent is used.","position":{"start":{"line":14,"column":46,"offset":718},"end":{"line":14,"column":323,"offset":995},"indent":[]}}],"position":{"start":{"line":14,"column":3,"offset":675},"end":{"line":14,"column":323,"offset":995},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":673},"end":{"line":14,"column":323,"offset":995},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A brief list of the key features of Kerberos Cloud are:","position":{"start":{"line":16,"column":1,"offset":997},"end":{"line":16,"column":56,"offset":1052},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":997},"end":{"line":16,"column":56,"offset":1052},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secured storage","position":{"start":{"line":18,"column":3,"offset":1056},"end":{"line":18,"column":18,"offset":1071},"indent":[]}}],"position":{"start":{"line":18,"column":3,"offset":1056},"end":{"line":18,"column":18,"offset":1071},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1054},"end":{"line":18,"column":18,"offset":1071},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Consolidated overview","position":{"start":{"line":19,"column":3,"offset":1074},"end":{"line":19,"column":24,"offset":1095},"indent":[]}}],"position":{"start":{"line":19,"column":3,"offset":1074},"end":{"line":19,"column":24,"offset":1095},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":1072},"end":{"line":19,"column":24,"offset":1095},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Advanced searching","position":{"start":{"line":20,"column":3,"offset":1098},"end":{"line":20,"column":21,"offset":1116},"indent":[]}}],"position":{"start":{"line":20,"column":3,"offset":1098},"end":{"line":20,"column":21,"offset":1116},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1096},"end":{"line":20,"column":21,"offset":1116},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Machine learning","position":{"start":{"line":21,"column":3,"offset":1119},"end":{"line":21,"column":19,"offset":1135},"indent":[]}}],"position":{"start":{"line":21,"column":3,"offset":1119},"end":{"line":21,"column":19,"offset":1135},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1117},"end":{"line":21,"column":19,"offset":1135},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Alerts","position":{"start":{"line":22,"column":3,"offset":1138},"end":{"line":22,"column":9,"offset":1144},"indent":[]}}],"position":{"start":{"line":22,"column":3,"offset":1138},"end":{"line":22,"column":9,"offset":1144},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1136},"end":{"line":22,"column":9,"offset":1144},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Live streaming","position":{"start":{"line":23,"column":3,"offset":1147},"end":{"line":23,"column":17,"offset":1161},"indent":[]}}],"position":{"start":{"line":23,"column":3,"offset":1147},"end":{"line":23,"column":17,"offset":1161},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1145},"end":{"line":23,"column":17,"offset":1161},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Accounts","position":{"start":{"line":24,"column":3,"offset":1164},"end":{"line":24,"column":11,"offset":1172},"indent":[]}}],"position":{"start":{"line":24,"column":3,"offset":1164},"end":{"line":24,"column":11,"offset":1172},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1162},"end":{"line":24,"column":11,"offset":1172},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Logging","position":{"start":{"line":25,"column":3,"offset":1175},"end":{"line":25,"column":10,"offset":1182},"indent":[]}}],"position":{"start":{"line":25,"column":3,"offset":1175},"end":{"line":25,"column":10,"offset":1182},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1173},"end":{"line":25,"column":10,"offset":1182},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1054},"end":{"line":25,"column":10,"offset":1182},"indent":[1,1,1,1,1,1,1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"Checkout ","position":{"start":{"line":27,"column":3,"offset":1186},"end":{"line":27,"column":12,"offset":1195},"indent":[]}},{"type":"link","title":null,"url":"https://app-demo.kerberos.io","children":[{"type":"text","value":"the demo environment","position":{"start":{"line":27,"column":13,"offset":1196},"end":{"line":27,"column":33,"offset":1216},"indent":[]}}],"position":{"start":{"line":27,"column":12,"offset":1195},"end":{"line":27,"column":64,"offset":1247},"indent":[]}},{"type":"text","value":" to see and feel the Kerberos Cloud solution yourself.","position":{"start":{"line":27,"column":64,"offset":1247},"end":{"line":27,"column":118,"offset":1301},"indent":[]}}],"position":{"start":{"line":27,"column":3,"offset":1186},"end":{"line":27,"column":118,"offset":1301},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1184},"end":{"line":27,"column":118,"offset":1301},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Architecture","position":{"start":{"line":29,"column":4,"offset":1306},"end":{"line":29,"column":16,"offset":1318},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1303},"end":{"line":29,"column":16,"offset":1318},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A simplified architecture is found below. In this architecture the Kerberos agents are installed on-premise, next to the surveillance cameras. Once one of the agents recorded something it will send the recording to our ","position":{"start":{"line":31,"column":1,"offset":1320},"end":{"line":31,"column":220,"offset":1539},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":31,"column":221,"offset":1540},"end":{"line":31,"column":237,"offset":1556},"indent":[]}}],"position":{"start":{"line":31,"column":220,"offset":1539},"end":{"line":31,"column":261,"offset":1580},"indent":[]}},{"type":"text","value":", using the credentials you've defined inside the agent.","position":{"start":{"line":31,"column":261,"offset":1580},"end":{"line":31,"column":317,"offset":1636},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1320},"end":{"line":31,"column":317,"offset":1636},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"As soon as the recording is succesfully received several engines will be executed, that will further process the recording and extract metadata from it (classification, origin of the surveillance camera, etc). A lot of processing is happening behind the scenes (by what we call microservices).","position":{"start":{"line":33,"column":1,"offset":1638},"end":{"line":33,"column":294,"offset":1931},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1638},"end":{"line":33,"column":294,"offset":1931},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By using a browser you can navigate to Kerberos Cloud, and review all the recordings made by the Kerberos agents. On top of that you will receive more context about the recordings, get notifications, view a livestream and much more.","position":{"start":{"line":35,"column":1,"offset":1933},"end":{"line":35,"column":233,"offset":2165},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1933},"end":{"line":35,"column":233,"offset":2165},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":37,"column":1,"offset":2167},"end":{"line":37,"column":56,"offset":2222},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2167},"end":{"line":37,"column":56,"offset":2222},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Public or Private edition","position":{"start":{"line":39,"column":5,"offset":2228},"end":{"line":39,"column":30,"offset":2253},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2224},"end":{"line":39,"column":30,"offset":2253},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"They are two different versions of using and deploying Kerberos Cloud, we have the public and private dition. What's the difference?","position":{"start":{"line":41,"column":1,"offset":2255},"end":{"line":41,"column":133,"offset":2387},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2255},"end":{"line":41,"column":133,"offset":2387},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Public edition of Kerberos Cloud, is running all its services in what we often call the public cloud; and to be more specific on AWS and GCP. The Public cloud is mainly built for people who want to have a low cost and small scale VMS in the cloud. It's easy to (un)subscribe to the system, and you can connect your Kerberos agents in a matter of seconds.","position":{"start":{"line":43,"column":1,"offset":2389},"end":{"line":43,"column":359,"offset":2747},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2389},"end":{"line":43,"column":359,"offset":2747},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand we also have the private edition, which is available for enterprises. In contrary to the public edition, a customer can deploy the entire Kerberos Cloud platform (with all its microservices) where it wants (on-premise or cloud). Both public and private edition are built on Kubernetes, this means that you will need to\nhave a Kubernetes cluster available at the location you which to install Kerberos Cloud.","position":{"start":{"line":45,"column":1,"offset":2749},"end":{"line":46,"column":89,"offset":3174},"indent":[1]}}],"position":{"start":{"line":45,"column":1,"offset":2749},"end":{"line":46,"column":89,"offset":3174},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"For more information about the licensing of Kerberos Cloud private edition, please get in touch with cedric@verstraeten.io. The licensing model of Kerberos Cloud public edition can be found online.","position":{"start":{"line":48,"column":1,"offset":3176},"end":{"line":48,"column":198,"offset":3373},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":3176},"end":{"line":48,"column":198,"offset":3373},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Features","position":{"start":{"line":50,"column":4,"offset":3378},"end":{"line":50,"column":12,"offset":3386},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3375},"end":{"line":50,"column":12,"offset":3386},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"So you might wonder, what's actually inside the platform? Please find a concrete list of functionalities below, this should give you more insights about how it looks like and what the capabilities are.","position":{"start":{"line":52,"column":1,"offset":3388},"end":{"line":52,"column":202,"offset":3589},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3388},"end":{"line":52,"column":202,"offset":3589},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Secured storage","position":{"start":{"line":54,"column":4,"offset":3594},"end":{"line":54,"column":19,"offset":3609},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3591},"end":{"line":54,"column":19,"offset":3609},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Cloud allows you to store your data in the cloud, and make it available using a secured web interface. This is how it works.","position":{"start":{"line":56,"column":1,"offset":3611},"end":{"line":56,"column":134,"offset":3744},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3611},"end":{"line":56,"column":134,"offset":3744},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed a Kerberos agent, and created an account on ","position":{"start":{"line":58,"column":1,"offset":3746},"end":{"line":58,"column":67,"offset":3812},"indent":[]}},{"type":"link","title":null,"url":"https://cloud.kerberos.io","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":58,"column":68,"offset":3813},"end":{"line":58,"column":82,"offset":3827},"indent":[]}}],"position":{"start":{"line":58,"column":67,"offset":3812},"end":{"line":58,"column":110,"offset":3855},"indent":[]}},{"type":"text","value":", you will be able to connect both systems together. By entering credentials received from Kerberos Cloud, into your Kerberos agent, your media recordings will be send to our cloud storage.","position":{"start":{"line":58,"column":110,"offset":3855},"end":{"line":58,"column":299,"offset":4044},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3746},"end":{"line":58,"column":299,"offset":4044},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"You can link one or more Kerberos agents to your Kerberos Cloud account.","position":{"start":{"line":60,"column":3,"offset":4048},"end":{"line":60,"column":75,"offset":4120},"indent":[]}}],"position":{"start":{"line":60,"column":3,"offset":4048},"end":{"line":60,"column":75,"offset":4120},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4046},"end":{"line":60,"column":75,"offset":4120},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-linking.png","alt":"cloud linking","position":{"start":{"line":62,"column":1,"offset":4122},"end":{"line":62,"column":65,"offset":4186},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4122},"end":{"line":62,"column":65,"offset":4186},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After linking your media recorded by a Kerberos agent will be send to our secure cloud storage, Kerberos Storage. By default our own ","position":{"start":{"line":64,"column":1,"offset":4188},"end":{"line":64,"column":134,"offset":4321},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":64,"column":135,"offset":4322},"end":{"line":64,"column":151,"offset":4338},"indent":[]}}],"position":{"start":{"line":64,"column":134,"offset":4321},"end":{"line":64,"column":175,"offset":4362},"indent":[]}},{"type":"text","value":" service is used, however you can install your own ","position":{"start":{"line":64,"column":175,"offset":4362},"end":{"line":64,"column":226,"offset":4413},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":64,"column":227,"offset":4414},"end":{"line":64,"column":243,"offset":4430},"indent":[]}}],"position":{"start":{"line":64,"column":226,"offset":4413},"end":{"line":64,"column":267,"offset":4454},"indent":[]}},{"type":"text","value":" and link it to our public cloud. By doing this all the recordings are stored in your own datacenter of choice, and only metadata is stored inside Kerberos Cloud.","position":{"start":{"line":64,"column":267,"offset":4454},"end":{"line":64,"column":429,"offset":4616},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4188},"end":{"line":64,"column":429,"offset":4616},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-network-onprem.png","alt":"cloud","position":{"start":{"line":66,"column":1,"offset":4618},"end":{"line":66,"column":58,"offset":4675},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":4618},"end":{"line":66,"column":58,"offset":4675},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once stored your media recordings will be processed by different functions and algorithms to send alerts, apply machine learning and much more.","position":{"start":{"line":68,"column":1,"offset":4677},"end":{"line":68,"column":144,"offset":4820},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":4677},"end":{"line":68,"column":144,"offset":4820},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"Kerberos Cloud is much more than a storage service, you get intelligent capabilities as well. Read on to discover more.","position":{"start":{"line":70,"column":3,"offset":4824},"end":{"line":70,"column":122,"offset":4943},"indent":[]}}],"position":{"start":{"line":70,"column":3,"offset":4824},"end":{"line":70,"column":122,"offset":4943},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":4822},"end":{"line":70,"column":122,"offset":4943},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Consolidated overview","position":{"start":{"line":72,"column":4,"offset":4948},"end":{"line":72,"column":25,"offset":4969},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":4945},"end":{"line":72,"column":25,"offset":4969},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Cloud will group your media recordings (coming from one or more Kerberos agents) into time bundles. We do this to simplify the searching of a specific event. Less data is shown at once, and when needed you can drill down a level deeper to see more details.","position":{"start":{"line":74,"column":1,"offset":4971},"end":{"line":74,"column":266,"offset":5236},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":4971},"end":{"line":74,"column":266,"offset":5236},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-overview.png","alt":"cloud overview","position":{"start":{"line":76,"column":1,"offset":5238},"end":{"line":76,"column":67,"offset":5304},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":5238},"end":{"line":76,"column":67,"offset":5304},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In a sneak peek you will see how many media recordings were generated during a certain time period, and which Kerberos agents were involved. For example, this might give you an indication of a particular event (more about in the machine learning section).","position":{"start":{"line":78,"column":1,"offset":5306},"end":{"line":78,"column":256,"offset":5561},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":5306},"end":{"line":78,"column":256,"offset":5561},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Security","position":{"start":{"line":80,"column":5,"offset":5567},"end":{"line":80,"column":13,"offset":5575},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":5563},"end":{"line":80,"column":13,"offset":5575},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you're inside your Kerberos Cloud account, you will see all the available media recordings of your Kerberos agents in a single interface. So how does this work?","position":{"start":{"line":82,"column":1,"offset":5577},"end":{"line":82,"column":166,"offset":5742},"indent":[]}}],"position":{"start":{"line":82,"column":1,"offset":5577},"end":{"line":82,"column":166,"offset":5742},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When you open Kerberos Cloud we will generate temporary and private links for every media recording within your account. This link includes a random and unique hash, and is only available for a couple of minutes. So this means that your recording cannot be shared afterwards, or the risk someone else accessing that link is minimised.","position":{"start":{"line":84,"column":1,"offset":5744},"end":{"line":84,"column":335,"offset":6078},"indent":[]}}],"position":{"start":{"line":84,"column":1,"offset":5744},"end":{"line":84,"column":335,"offset":6078},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Advanced searching","position":{"start":{"line":86,"column":4,"offset":6083},"end":{"line":86,"column":22,"offset":6101},"indent":[]}}],"position":{"start":{"line":86,"column":1,"offset":6080},"end":{"line":86,"column":22,"offset":6101},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to showing all your recordings in one overview, we also give you the capabilities to search for a recording more easily. For example you can search for recordings within a specific time boundary, recordings generated by a specific Kerberos agent, recordings which are marked as important, classified recordings such as pedestrians or animals, and more.","position":{"start":{"line":88,"column":1,"offset":6103},"end":{"line":88,"column":358,"offset":6460},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":6103},"end":{"line":88,"column":358,"offset":6460},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-search.png","alt":"cloud search","position":{"start":{"line":90,"column":1,"offset":6462},"end":{"line":90,"column":63,"offset":6524},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":6462},"end":{"line":90,"column":63,"offset":6524},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Machine learning","position":{"start":{"line":92,"column":4,"offset":6529},"end":{"line":92,"column":20,"offset":6545},"indent":[]}}],"position":{"start":{"line":92,"column":1,"offset":6526},"end":{"line":92,"column":20,"offset":6545},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"With Kerberos Cloud you will get far more than just a nice interface for finding back your recordings. When a recording is uploaded to Kerberos Cloud, we will execute all kind of algorithms. One of these algorithms is classification. This algorithm is used to classify/recognise all the objects inside your recording. Any human, vehicle or animal in the recording will be labeled.","position":{"start":{"line":94,"column":1,"offset":6547},"end":{"line":94,"column":381,"offset":6927},"indent":[]}}],"position":{"start":{"line":94,"column":1,"offset":6547},"end":{"line":94,"column":381,"offset":6927},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to classifying, the algorithm is also tracing the classified objects. By doing this we can label the recording with the object of interest. For example at the image below you see the traject of a pedestrian walking by (710 pixels).","position":{"start":{"line":96,"column":1,"offset":6929},"end":{"line":96,"column":237,"offset":7165},"indent":[]}}],"position":{"start":{"line":96,"column":1,"offset":6929},"end":{"line":96,"column":237,"offset":7165},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-ml.png","alt":"cloud ml","position":{"start":{"line":98,"column":1,"offset":7167},"end":{"line":98,"column":55,"offset":7221},"indent":[]}}],"position":{"start":{"line":98,"column":1,"offset":7167},"end":{"line":98,"column":55,"offset":7221},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Alerts","position":{"start":{"line":100,"column":4,"offset":7226},"end":{"line":100,"column":10,"offset":7232},"indent":[]}}],"position":{"start":{"line":100,"column":1,"offset":7223},"end":{"line":100,"column":10,"offset":7232},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When a specific event occurred, a notification can be send to one or more channels. A user can compose an event by selecting one or more conditions. Once the event is triggered, a notification is sent to all the enabled channels.","position":{"start":{"line":102,"column":1,"offset":7234},"end":{"line":102,"column":230,"offset":7463},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":7234},"end":{"line":102,"column":230,"offset":7463},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Notifications","position":{"start":{"line":104,"column":5,"offset":7469},"end":{"line":104,"column":18,"offset":7482},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":7465},"end":{"line":104,"column":18,"offset":7482},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":" Kerberos Cloud supports different types of notifications:","position":{"start":{"line":106,"column":1,"offset":7484},"end":{"line":106,"column":59,"offset":7542},"indent":[]}}],"position":{"start":{"line":106,"column":1,"offset":7484},"end":{"line":106,"column":59,"offset":7542},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Detections","position":{"start":{"line":108,"column":6,"offset":7549},"end":{"line":108,"column":16,"offset":7559},"indent":[]}}],"position":{"start":{"line":108,"column":4,"offset":7547},"end":{"line":108,"column":18,"offset":7561},"indent":[]}},{"type":"text","value":": send a notification if a recording was received from a specific Kerberos agent, within a time range, with a specific classification, etc.","position":{"start":{"line":108,"column":18,"offset":7561},"end":{"line":108,"column":157,"offset":7700},"indent":[]}}],"position":{"start":{"line":108,"column":4,"offset":7547},"end":{"line":108,"column":157,"offset":7700},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":7544},"end":{"line":108,"column":157,"offset":7700},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Devices","position":{"start":{"line":109,"column":6,"offset":7706},"end":{"line":109,"column":13,"offset":7713},"indent":[]}}],"position":{"start":{"line":109,"column":4,"offset":7704},"end":{"line":109,"column":15,"offset":7715},"indent":[]}},{"type":"text","value":": when one of your Kerberos agents stopped working, a notification can be send.","position":{"start":{"line":109,"column":15,"offset":7715},"end":{"line":109,"column":94,"offset":7794},"indent":[]}}],"position":{"start":{"line":109,"column":4,"offset":7704},"end":{"line":109,"column":94,"offset":7794},"indent":[]}}],"position":{"start":{"line":109,"column":1,"offset":7701},"end":{"line":109,"column":94,"offset":7794},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"High upload","position":{"start":{"line":110,"column":6,"offset":7800},"end":{"line":110,"column":17,"offset":7811},"indent":[]}}],"position":{"start":{"line":110,"column":4,"offset":7798},"end":{"line":110,"column":19,"offset":7813},"indent":[]}},{"type":"text","value":": when a lot of recordings are generated within a specific period of time, a notification can be send.","position":{"start":{"line":110,"column":19,"offset":7813},"end":{"line":110,"column":121,"offset":7915},"indent":[]}}],"position":{"start":{"line":110,"column":4,"offset":7798},"end":{"line":110,"column":121,"offset":7915},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":7795},"end":{"line":110,"column":121,"offset":7915},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":7544},"end":{"line":110,"column":121,"offset":7915},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-notifications.png","alt":"cloud notifications","position":{"start":{"line":112,"column":1,"offset":7917},"end":{"line":112,"column":77,"offset":7993},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":7917},"end":{"line":112,"column":77,"offset":7993},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Channels","position":{"start":{"line":114,"column":5,"offset":7999},"end":{"line":114,"column":13,"offset":8007},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":7995},"end":{"line":114,"column":13,"offset":8007},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":" Kerberos Cloud supports different types of channels, towards notifications can be send:","position":{"start":{"line":116,"column":1,"offset":8009},"end":{"line":116,"column":89,"offset":8097},"indent":[]}}],"position":{"start":{"line":116,"column":1,"offset":8009},"end":{"line":116,"column":89,"offset":8097},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Browser","position":{"start":{"line":118,"column":6,"offset":8104},"end":{"line":118,"column":13,"offset":8111},"indent":[]}}],"position":{"start":{"line":118,"column":4,"offset":8102},"end":{"line":118,"column":15,"offset":8113},"indent":[]}},{"type":"text","value":": notifications inside the browser (if the used browser supports this).","position":{"start":{"line":118,"column":15,"offset":8113},"end":{"line":118,"column":86,"offset":8184},"indent":[]}}],"position":{"start":{"line":118,"column":4,"offset":8102},"end":{"line":118,"column":86,"offset":8184},"indent":[]}}],"position":{"start":{"line":118,"column":1,"offset":8099},"end":{"line":118,"column":86,"offset":8184},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"E-mail","position":{"start":{"line":119,"column":6,"offset":8190},"end":{"line":119,"column":12,"offset":8196},"indent":[]}}],"position":{"start":{"line":119,"column":4,"offset":8188},"end":{"line":119,"column":14,"offset":8198},"indent":[]}},{"type":"text","value":": a personal email can be send.","position":{"start":{"line":119,"column":14,"offset":8198},"end":{"line":119,"column":45,"offset":8229},"indent":[]}}],"position":{"start":{"line":119,"column":4,"offset":8188},"end":{"line":119,"column":45,"offset":8229},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":8185},"end":{"line":119,"column":45,"offset":8229},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Slack","position":{"start":{"line":120,"column":6,"offset":8235},"end":{"line":120,"column":11,"offset":8240},"indent":[]}}],"position":{"start":{"line":120,"column":4,"offset":8233},"end":{"line":120,"column":13,"offset":8242},"indent":[]}},{"type":"text","value":": send a message to a slack channel.","position":{"start":{"line":120,"column":13,"offset":8242},"end":{"line":120,"column":49,"offset":8278},"indent":[]}}],"position":{"start":{"line":120,"column":4,"offset":8233},"end":{"line":120,"column":49,"offset":8278},"indent":[]}}],"position":{"start":{"line":120,"column":1,"offset":8230},"end":{"line":120,"column":49,"offset":8278},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Alexa","position":{"start":{"line":121,"column":6,"offset":8284},"end":{"line":121,"column":11,"offset":8289},"indent":[]}}],"position":{"start":{"line":121,"column":4,"offset":8282},"end":{"line":121,"column":13,"offset":8291},"indent":[]}},{"type":"text","value":": send a notification to Alexa skill (","position":{"start":{"line":121,"column":13,"offset":8291},"end":{"line":121,"column":51,"offset":8329},"indent":[]}},{"type":"link","title":null,"url":"https://www.amazon.com/Thomptronics-Notify-Me/dp/B07BB2FYFS","children":[{"type":"text","value":"Notify Me","position":{"start":{"line":121,"column":52,"offset":8330},"end":{"line":121,"column":61,"offset":8339},"indent":[]}}],"position":{"start":{"line":121,"column":51,"offset":8329},"end":{"line":121,"column":123,"offset":8401},"indent":[]}},{"type":"text","value":").","position":{"start":{"line":121,"column":123,"offset":8401},"end":{"line":121,"column":125,"offset":8403},"indent":[]}}],"position":{"start":{"line":121,"column":4,"offset":8282},"end":{"line":121,"column":125,"offset":8403},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":8279},"end":{"line":121,"column":125,"offset":8403},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Telegram","position":{"start":{"line":122,"column":6,"offset":8409},"end":{"line":122,"column":14,"offset":8417},"indent":[]}}],"position":{"start":{"line":122,"column":4,"offset":8407},"end":{"line":122,"column":16,"offset":8419},"indent":[]}},{"type":"text","value":": send a message to a Telegram channel.","position":{"start":{"line":122,"column":16,"offset":8419},"end":{"line":122,"column":55,"offset":8458},"indent":[]}}],"position":{"start":{"line":122,"column":4,"offset":8407},"end":{"line":122,"column":55,"offset":8458},"indent":[]}}],"position":{"start":{"line":122,"column":1,"offset":8404},"end":{"line":122,"column":55,"offset":8458},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Pushbullet","position":{"start":{"line":123,"column":6,"offset":8464},"end":{"line":123,"column":16,"offset":8474},"indent":[]}}],"position":{"start":{"line":123,"column":4,"offset":8462},"end":{"line":123,"column":18,"offset":8476},"indent":[]}},{"type":"text","value":": send a message to a Pushbullet channel.","position":{"start":{"line":123,"column":18,"offset":8476},"end":{"line":123,"column":59,"offset":8517},"indent":[]}}],"position":{"start":{"line":123,"column":4,"offset":8462},"end":{"line":123,"column":59,"offset":8517},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":8459},"end":{"line":123,"column":59,"offset":8517},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Pushover","position":{"start":{"line":124,"column":6,"offset":8523},"end":{"line":124,"column":14,"offset":8531},"indent":[]}}],"position":{"start":{"line":124,"column":4,"offset":8521},"end":{"line":124,"column":16,"offset":8533},"indent":[]}},{"type":"text","value":": send a message to a Pushover channel.","position":{"start":{"line":124,"column":16,"offset":8533},"end":{"line":124,"column":55,"offset":8572},"indent":[]}}],"position":{"start":{"line":124,"column":4,"offset":8521},"end":{"line":124,"column":55,"offset":8572},"indent":[]}}],"position":{"start":{"line":124,"column":1,"offset":8518},"end":{"line":124,"column":55,"offset":8572},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Webhook","position":{"start":{"line":125,"column":6,"offset":8578},"end":{"line":125,"column":13,"offset":8585},"indent":[]}}],"position":{"start":{"line":125,"column":4,"offset":8576},"end":{"line":125,"column":15,"offset":8587},"indent":[]}},{"type":"text","value":": trigger a webhook (POST).","position":{"start":{"line":125,"column":15,"offset":8587},"end":{"line":125,"column":42,"offset":8614},"indent":[]}}],"position":{"start":{"line":125,"column":4,"offset":8576},"end":{"line":125,"column":42,"offset":8614},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":8573},"end":{"line":125,"column":42,"offset":8614},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"IFTTT","position":{"start":{"line":126,"column":6,"offset":8620},"end":{"line":126,"column":11,"offset":8625},"indent":[]}}],"position":{"start":{"line":126,"column":4,"offset":8618},"end":{"line":126,"column":13,"offset":8627},"indent":[]}},{"type":"text","value":": send a message to IFTTT.","position":{"start":{"line":126,"column":13,"offset":8627},"end":{"line":126,"column":39,"offset":8653},"indent":[]}}],"position":{"start":{"line":126,"column":4,"offset":8618},"end":{"line":126,"column":39,"offset":8653},"indent":[]}}],"position":{"start":{"line":126,"column":1,"offset":8615},"end":{"line":126,"column":39,"offset":8653},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"SMS","position":{"start":{"line":127,"column":6,"offset":8659},"end":{"line":127,"column":9,"offset":8662},"indent":[]}}],"position":{"start":{"line":127,"column":4,"offset":8657},"end":{"line":127,"column":11,"offset":8664},"indent":[]}},{"type":"text","value":": send a text message to a mobile number.","position":{"start":{"line":127,"column":11,"offset":8664},"end":{"line":127,"column":52,"offset":8705},"indent":[]}}],"position":{"start":{"line":127,"column":4,"offset":8657},"end":{"line":127,"column":52,"offset":8705},"indent":[]}}],"position":{"start":{"line":127,"column":1,"offset":8654},"end":{"line":127,"column":52,"offset":8705},"indent":[]}}],"position":{"start":{"line":118,"column":1,"offset":8099},"end":{"line":127,"column":52,"offset":8705},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-channels.png","alt":"cloud notifications","position":{"start":{"line":129,"column":1,"offset":8707},"end":{"line":129,"column":72,"offset":8778},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":8707},"end":{"line":129,"column":72,"offset":8778},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Live streaming","position":{"start":{"line":131,"column":4,"offset":8783},"end":{"line":131,"column":18,"offset":8797},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":8780},"end":{"line":131,"column":18,"offset":8797},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Cloud allows you to live stream from your Kerberos agents to your Kerberos Cloud account.","position":{"start":{"line":133,"column":1,"offset":8799},"end":{"line":133,"column":99,"offset":8897},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":8799},"end":{"line":133,"column":99,"offset":8897},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For Kerberos Open Source a low resolution livestream is made available, this will allow you to see what is happening in front of your surveillance camera in real-time. The stream is shared over MQTT (TCPS) and visualised in the Kerberos Cloud webinterface using secure websockets (WSS). No port forwarding needs to be enabled.","position":{"start":{"line":135,"column":1,"offset":8899},"end":{"line":135,"column":327,"offset":9225},"indent":[]}}],"position":{"start":{"line":135,"column":1,"offset":8899},"end":{"line":135,"column":327,"offset":9225},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-livestream.png","alt":"cloud livestream","position":{"start":{"line":137,"column":1,"offset":9227},"end":{"line":137,"column":71,"offset":9297},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":9227},"end":{"line":137,"column":71,"offset":9297},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For Kerberos Enterprise a HD livestream is made available. The full resolution and FPS is send through a concept called WebRTC. This WebRTC technology, is used my all major conferencing tools such as Zoom, Teams, etc.","position":{"start":{"line":139,"column":1,"offset":9299},"end":{"line":139,"column":218,"offset":9516},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":9299},"end":{"line":139,"column":218,"offset":9516},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-livestream-webrtc.png","alt":"cloud livestream webrtc","position":{"start":{"line":141,"column":1,"offset":9518},"end":{"line":141,"column":85,"offset":9602},"indent":[]}}],"position":{"start":{"line":141,"column":1,"offset":9518},"end":{"line":141,"column":85,"offset":9602},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Accounts","position":{"start":{"line":143,"column":4,"offset":9607},"end":{"line":143,"column":12,"offset":9615},"indent":[]}}],"position":{"start":{"line":143,"column":1,"offset":9604},"end":{"line":143,"column":12,"offset":9615},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"It's possible to create multiple accounts (also called subaccounts) within your main account. Their are two different roles:","position":{"start":{"line":145,"column":1,"offset":9617},"end":{"line":145,"column":125,"offset":9741},"indent":[]}}],"position":{"start":{"line":145,"column":1,"offset":9617},"end":{"line":145,"column":125,"offset":9741},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Guest: will only see your media recordings. A guest cannot modify, delete or create something.","position":{"start":{"line":147,"column":3,"offset":9745},"end":{"line":147,"column":97,"offset":9839},"indent":[]}}],"position":{"start":{"line":147,"column":3,"offset":9745},"end":{"line":147,"column":97,"offset":9839},"indent":[]}}],"position":{"start":{"line":147,"column":1,"offset":9743},"end":{"line":147,"column":97,"offset":9839},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Editor: has full access, same permissions as the main account.","position":{"start":{"line":148,"column":3,"offset":9842},"end":{"line":148,"column":65,"offset":9904},"indent":[]}}],"position":{"start":{"line":148,"column":3,"offset":9842},"end":{"line":148,"column":65,"offset":9904},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":9840},"end":{"line":148,"column":65,"offset":9904},"indent":[]}}],"position":{"start":{"line":147,"column":1,"offset":9743},"end":{"line":148,"column":65,"offset":9904},"indent":[1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-accounts.png","alt":"cloud accounts","position":{"start":{"line":150,"column":1,"offset":9906},"end":{"line":150,"column":67,"offset":9972},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":9906},"end":{"line":150,"column":67,"offset":9972},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Logging","position":{"start":{"line":152,"column":4,"offset":9977},"end":{"line":152,"column":11,"offset":9984},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":9974},"end":{"line":152,"column":11,"offset":9984},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"All algorithms or functions which are applied to your recording on the Kerberos Cloud platform, are shown on the logging page. You can use this to debug.","position":{"start":{"line":154,"column":1,"offset":9986},"end":{"line":154,"column":154,"offset":10139},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":9986},"end":{"line":154,"column":154,"offset":10139},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-logging.png","alt":"cloud logging","position":{"start":{"line":156,"column":1,"offset":10141},"end":{"line":156,"column":65,"offset":10205},"indent":[]}}],"position":{"start":{"line":156,"column":1,"offset":10141},"end":{"line":156,"column":65,"offset":10205},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":159,"column":1,"offset":10208},"end":{"line":159,"column":31,"offset":10238},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":159,"column":31,"offset":10238}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Cloud`}

\n

{`When installing a Kerberos agent inside your local network, it's possible to review your activity by using the agent's web interface. By nature, you will not be able to access the web interface from the cloud (outside your local network). On top of that, the Kerberos agent doesn't come with a consolidated overview. This means that you will need to open multiple web interfaces, one for each connected surveillance camera.`}

\n

{`To simplify and resolve all of these challenges, Kerberos Cloud was developed.`}

\n
\n

{`Kerberos Cloud`}{` is a cloud solution which allows you to have a single overview of all the media recordings generated by your surveillance cameras. It's not a solution for processing your surveillance cameras in the cloud. For processing of your surveillance cameras, a Kerberos agent is used.`}

\n
\n

{`A brief list of the key features of Kerberos Cloud are:`}

\n
    \n
  • {`Secured storage`}
    • \n
  • {`Consolidated overview`}
    • \n
  • {`Advanced searching`}
    • \n
  • {`Machine learning`}
    • \n
  • {`Alerts`}
    • \n
  • {`Live streaming`}
    • \n
  • {`Accounts`}
    • \n
  • {`Logging`}
    • \n
\n
\n

{`Checkout `}{`the demo environment`}{` to see and feel the Kerberos Cloud solution yourself.`}

\n
\n

{`Architecture`}

\n

{`A simplified architecture is found below. In this architecture the Kerberos agents are installed on-premise, next to the surveillance cameras. Once one of the agents recorded something it will send the recording to our `}{`Kerberos Storage`}{`, using the credentials you've defined inside the agent.`}

\n

{`As soon as the recording is succesfully received several engines will be executed, that will further process the recording and extract metadata from it (classification, origin of the surveillance camera, etc). A lot of processing is happening behind the scenes (by what we call microservices).`}

\n

{`By using a browser you can navigate to Kerberos Cloud, and review all the recordings made by the Kerberos agents. On top of that you will receive more context about the recordings, get notifications, view a livestream and much more.`}

\n

\"cloud\"

\n

{`Public or Private edition`}

\n

{`They are two different versions of using and deploying Kerberos Cloud, we have the public and private dition. What's the difference?`}

\n

{`The Public edition of Kerberos Cloud, is running all its services in what we often call the public cloud; and to be more specific on AWS and GCP. The Public cloud is mainly built for people who want to have a low cost and small scale VMS in the cloud. It's easy to (un)subscribe to the system, and you can connect your Kerberos agents in a matter of seconds.`}

\n

{`On the other hand we also have the private edition, which is available for enterprises. In contrary to the public edition, a customer can deploy the entire Kerberos Cloud platform (with all its microservices) where it wants (on-premise or cloud). Both public and private edition are built on Kubernetes, this means that you will need to\nhave a Kubernetes cluster available at the location you which to install Kerberos Cloud.`}

\n

{`For more information about the licensing of Kerberos Cloud private edition, please get in touch with cedric@verstraeten.io. The licensing model of Kerberos Cloud public edition can be found online.`}

\n

{`Features`}

\n

{`So you might wonder, what's actually inside the platform? Please find a concrete list of functionalities below, this should give you more insights about how it looks like and what the capabilities are.`}

\n

{`Secured storage`}

\n

{`Kerberos Cloud allows you to store your data in the cloud, and make it available using a secured web interface. This is how it works.`}

\n

{`Once you've installed a Kerberos agent, and created an account on `}{`Kerberos Cloud`}{`, you will be able to connect both systems together. By entering credentials received from Kerberos Cloud, into your Kerberos agent, your media recordings will be send to our cloud storage.`}

\n
\n

{`You can link one or more Kerberos agents to your Kerberos Cloud account.`}

\n
\n

\"cloud

\n

{`After linking your media recorded by a Kerberos agent will be send to our secure cloud storage, Kerberos Storage. By default our own `}{`Kerberos Storage`}{` service is used, however you can install your own `}{`Kerberos Storage`}{` and link it to our public cloud. By doing this all the recordings are stored in your own datacenter of choice, and only metadata is stored inside Kerberos Cloud.`}

\n

\"cloud\"

\n

{`Once stored your media recordings will be processed by different functions and algorithms to send alerts, apply machine learning and much more.`}

\n
\n

{`Kerberos Cloud is much more than a storage service, you get intelligent capabilities as well. Read on to discover more.`}

\n
\n

{`Consolidated overview`}

\n

{`Kerberos Cloud will group your media recordings (coming from one or more Kerberos agents) into time bundles. We do this to simplify the searching of a specific event. Less data is shown at once, and when needed you can drill down a level deeper to see more details.`}

\n

\"cloud

\n

{`In a sneak peek you will see how many media recordings were generated during a certain time period, and which Kerberos agents were involved. For example, this might give you an indication of a particular event (more about in the machine learning section).`}

\n

{`Security`}

\n

{`Once you're inside your Kerberos Cloud account, you will see all the available media recordings of your Kerberos agents in a single interface. So how does this work?`}

\n

{`When you open Kerberos Cloud we will generate temporary and private links for every media recording within your account. This link includes a random and unique hash, and is only available for a couple of minutes. So this means that your recording cannot be shared afterwards, or the risk someone else accessing that link is minimised.`}

\n

{`Advanced searching`}

\n

{`Next to showing all your recordings in one overview, we also give you the capabilities to search for a recording more easily. For example you can search for recordings within a specific time boundary, recordings generated by a specific Kerberos agent, recordings which are marked as important, classified recordings such as pedestrians or animals, and more.`}

\n

\"cloud

\n

{`Machine learning`}

\n

{`With Kerberos Cloud you will get far more than just a nice interface for finding back your recordings. When a recording is uploaded to Kerberos Cloud, we will execute all kind of algorithms. One of these algorithms is classification. This algorithm is used to classify/recognise all the objects inside your recording. Any human, vehicle or animal in the recording will be labeled.`}

\n

{`Next to classifying, the algorithm is also tracing the classified objects. By doing this we can label the recording with the object of interest. For example at the image below you see the traject of a pedestrian walking by (710 pixels).`}

\n

\"cloud

\n

{`Alerts`}

\n

{`When a specific event occurred, a notification can be send to one or more channels. A user can compose an event by selecting one or more conditions. Once the event is triggered, a notification is sent to all the enabled channels.`}

\n

{`Notifications`}

\n

{` Kerberos Cloud supports different types of notifications:`}

\n
    \n
  • {`Detections`}{`: send a notification if a recording was received from a specific Kerberos agent, within a time range, with a specific classification, etc.`}
    • \n
  • {`Devices`}{`: when one of your Kerberos agents stopped working, a notification can be send.`}
    • \n
  • {`High upload`}{`: when a lot of recordings are generated within a specific period of time, a notification can be send.`}
    • \n
\n

\"cloud

\n

{`Channels`}

\n

{` Kerberos Cloud supports different types of channels, towards notifications can be send:`}

\n
    \n
  • {`Browser`}{`: notifications inside the browser (if the used browser supports this).`}
    • \n
  • {`E-mail`}{`: a personal email can be send.`}
    • \n
  • {`Slack`}{`: send a message to a slack channel.`}
    • \n
  • {`Alexa`}{`: send a notification to Alexa skill (`}{`Notify Me`}{`).`}
    • \n
  • {`Telegram`}{`: send a message to a Telegram channel.`}
    • \n
  • {`Pushbullet`}{`: send a message to a Pushbullet channel.`}
    • \n
  • {`Pushover`}{`: send a message to a Pushover channel.`}
    • \n
  • {`Webhook`}{`: trigger a webhook (POST).`}
    • \n
  • {`IFTTT`}{`: send a message to IFTTT.`}
    • \n
  • {`SMS`}{`: send a text message to a mobile number.`}
    • \n
\n

\"cloud

\n

{`Live streaming`}

\n

{`Kerberos Cloud allows you to live stream from your Kerberos agents to your Kerberos Cloud account.`}

\n

{`For Kerberos Open Source a low resolution livestream is made available, this will allow you to see what is happening in front of your surveillance camera in real-time. The stream is shared over MQTT (TCPS) and visualised in the Kerberos Cloud webinterface using secure websockets (WSS). No port forwarding needs to be enabled.`}

\n

\"cloud

\n

{`For Kerberos Enterprise a HD livestream is made available. The full resolution and FPS is send through a concept called WebRTC. This WebRTC technology, is used my all major conferencing tools such as Zoom, Teams, etc.`}

\n

\"cloud

\n

{`Accounts`}

\n

{`It's possible to create multiple accounts (also called subaccounts) within your main account. Their are two different roles:`}

\n
    \n
  • {`Guest: will only see your media recordings. A guest cannot modify, delete or create something.`}
    • \n
  • {`Editor: has full access, same permissions as the main account.`}
    • \n
\n

\"cloud

\n

{`Logging`}

\n

{`All algorithms or functions which are applied to your recording on the Kerberos Cloud platform, are shown on the logging page. You can use this to debug.`}

\n

\"cloud

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750177000,"key":"gatsby-plugin-mdx-entire-payload-1312887ada4a7f63b8eebd77ef6812cb-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Cloud","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":8,"offset":166},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":8,"offset":166},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When installing a Kerberos agent inside your local network, it's possible to review your activity by using the agent's web interface. By nature, you will not be able to access the web interface from the cloud (outside your local network). On top of that, the Kerberos agent doesn't come with a consolidated overview. This means that you will need to open multiple web interfaces, one for each connected surveillance camera.","position":{"start":{"line":10,"column":1,"offset":168},"end":{"line":10,"column":424,"offset":591},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":168},"end":{"line":10,"column":424,"offset":591},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To simplify and resolve all of these challenges, Kerberos Cloud was developed.","position":{"start":{"line":12,"column":1,"offset":593},"end":{"line":12,"column":79,"offset":671},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":593},"end":{"line":12,"column":79,"offset":671},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.kerberos.io","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":4,"offset":676},"end":{"line":14,"column":18,"offset":690},"indent":[]}}],"position":{"start":{"line":14,"column":3,"offset":675},"end":{"line":14,"column":46,"offset":718},"indent":[]}},{"type":"text","value":" is a cloud solution which allows you to have a single overview of all the media recordings generated by your surveillance cameras. It's not a solution for processing your surveillance cameras in the cloud. For processing of your surveillance cameras, a Kerberos agent is used.","position":{"start":{"line":14,"column":46,"offset":718},"end":{"line":14,"column":323,"offset":995},"indent":[]}}],"position":{"start":{"line":14,"column":3,"offset":675},"end":{"line":14,"column":323,"offset":995},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":673},"end":{"line":14,"column":323,"offset":995},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A brief list of the key features of Kerberos Cloud are:","position":{"start":{"line":16,"column":1,"offset":997},"end":{"line":16,"column":56,"offset":1052},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":997},"end":{"line":16,"column":56,"offset":1052},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secured storage","position":{"start":{"line":18,"column":3,"offset":1056},"end":{"line":18,"column":18,"offset":1071},"indent":[]}}],"position":{"start":{"line":18,"column":3,"offset":1056},"end":{"line":18,"column":18,"offset":1071},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1054},"end":{"line":18,"column":18,"offset":1071},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Consolidated overview","position":{"start":{"line":19,"column":3,"offset":1074},"end":{"line":19,"column":24,"offset":1095},"indent":[]}}],"position":{"start":{"line":19,"column":3,"offset":1074},"end":{"line":19,"column":24,"offset":1095},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":1072},"end":{"line":19,"column":24,"offset":1095},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Advanced searching","position":{"start":{"line":20,"column":3,"offset":1098},"end":{"line":20,"column":21,"offset":1116},"indent":[]}}],"position":{"start":{"line":20,"column":3,"offset":1098},"end":{"line":20,"column":21,"offset":1116},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1096},"end":{"line":20,"column":21,"offset":1116},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Machine learning","position":{"start":{"line":21,"column":3,"offset":1119},"end":{"line":21,"column":19,"offset":1135},"indent":[]}}],"position":{"start":{"line":21,"column":3,"offset":1119},"end":{"line":21,"column":19,"offset":1135},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1117},"end":{"line":21,"column":19,"offset":1135},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Alerts","position":{"start":{"line":22,"column":3,"offset":1138},"end":{"line":22,"column":9,"offset":1144},"indent":[]}}],"position":{"start":{"line":22,"column":3,"offset":1138},"end":{"line":22,"column":9,"offset":1144},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1136},"end":{"line":22,"column":9,"offset":1144},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Live streaming","position":{"start":{"line":23,"column":3,"offset":1147},"end":{"line":23,"column":17,"offset":1161},"indent":[]}}],"position":{"start":{"line":23,"column":3,"offset":1147},"end":{"line":23,"column":17,"offset":1161},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1145},"end":{"line":23,"column":17,"offset":1161},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Accounts","position":{"start":{"line":24,"column":3,"offset":1164},"end":{"line":24,"column":11,"offset":1172},"indent":[]}}],"position":{"start":{"line":24,"column":3,"offset":1164},"end":{"line":24,"column":11,"offset":1172},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1162},"end":{"line":24,"column":11,"offset":1172},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Logging","position":{"start":{"line":25,"column":3,"offset":1175},"end":{"line":25,"column":10,"offset":1182},"indent":[]}}],"position":{"start":{"line":25,"column":3,"offset":1175},"end":{"line":25,"column":10,"offset":1182},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1173},"end":{"line":25,"column":10,"offset":1182},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1054},"end":{"line":25,"column":10,"offset":1182},"indent":[1,1,1,1,1,1,1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"Checkout ","position":{"start":{"line":27,"column":3,"offset":1186},"end":{"line":27,"column":12,"offset":1195},"indent":[]}},{"type":"link","title":null,"url":"https://app-demo.kerberos.io","children":[{"type":"text","value":"the demo environment","position":{"start":{"line":27,"column":13,"offset":1196},"end":{"line":27,"column":33,"offset":1216},"indent":[]}}],"position":{"start":{"line":27,"column":12,"offset":1195},"end":{"line":27,"column":64,"offset":1247},"indent":[]}},{"type":"text","value":" to see and feel the Kerberos Cloud solution yourself.","position":{"start":{"line":27,"column":64,"offset":1247},"end":{"line":27,"column":118,"offset":1301},"indent":[]}}],"position":{"start":{"line":27,"column":3,"offset":1186},"end":{"line":27,"column":118,"offset":1301},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1184},"end":{"line":27,"column":118,"offset":1301},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Architecture","position":{"start":{"line":29,"column":4,"offset":1306},"end":{"line":29,"column":16,"offset":1318},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1303},"end":{"line":29,"column":16,"offset":1318},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A simplified architecture is found below. In this architecture the Kerberos agents are installed on-premise, next to the surveillance cameras. Once one of the agents recorded something it will send the recording to our ","position":{"start":{"line":31,"column":1,"offset":1320},"end":{"line":31,"column":220,"offset":1539},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":31,"column":221,"offset":1540},"end":{"line":31,"column":237,"offset":1556},"indent":[]}}],"position":{"start":{"line":31,"column":220,"offset":1539},"end":{"line":31,"column":261,"offset":1580},"indent":[]}},{"type":"text","value":", using the credentials you've defined inside the agent.","position":{"start":{"line":31,"column":261,"offset":1580},"end":{"line":31,"column":317,"offset":1636},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1320},"end":{"line":31,"column":317,"offset":1636},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"As soon as the recording is succesfully received several engines will be executed, that will further process the recording and extract metadata from it (classification, origin of the surveillance camera, etc). A lot of processing is happening behind the scenes (by what we call microservices).","position":{"start":{"line":33,"column":1,"offset":1638},"end":{"line":33,"column":294,"offset":1931},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1638},"end":{"line":33,"column":294,"offset":1931},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By using a browser you can navigate to Kerberos Cloud, and review all the recordings made by the Kerberos agents. On top of that you will receive more context about the recordings, get notifications, view a livestream and much more.","position":{"start":{"line":35,"column":1,"offset":1933},"end":{"line":35,"column":233,"offset":2165},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1933},"end":{"line":35,"column":233,"offset":2165},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":37,"column":1,"offset":2167},"end":{"line":37,"column":56,"offset":2222},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2167},"end":{"line":37,"column":56,"offset":2222},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Public or Private edition","position":{"start":{"line":39,"column":5,"offset":2228},"end":{"line":39,"column":30,"offset":2253},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2224},"end":{"line":39,"column":30,"offset":2253},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"They are two different versions of using and deploying Kerberos Cloud, we have the public and private dition. What's the difference?","position":{"start":{"line":41,"column":1,"offset":2255},"end":{"line":41,"column":133,"offset":2387},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2255},"end":{"line":41,"column":133,"offset":2387},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Public edition of Kerberos Cloud, is running all its services in what we often call the public cloud; and to be more specific on AWS and GCP. The Public cloud is mainly built for people who want to have a low cost and small scale VMS in the cloud. It's easy to (un)subscribe to the system, and you can connect your Kerberos agents in a matter of seconds.","position":{"start":{"line":43,"column":1,"offset":2389},"end":{"line":43,"column":359,"offset":2747},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2389},"end":{"line":43,"column":359,"offset":2747},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand we also have the private edition, which is available for enterprises. In contrary to the public edition, a customer can deploy the entire Kerberos Cloud platform (with all its microservices) where it wants (on-premise or cloud). Both public and private edition are built on Kubernetes, this means that you will need to\nhave a Kubernetes cluster available at the location you which to install Kerberos Cloud.","position":{"start":{"line":45,"column":1,"offset":2749},"end":{"line":46,"column":89,"offset":3174},"indent":[1]}}],"position":{"start":{"line":45,"column":1,"offset":2749},"end":{"line":46,"column":89,"offset":3174},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"For more information about the licensing of Kerberos Cloud private edition, please get in touch with cedric@verstraeten.io. The licensing model of Kerberos Cloud public edition can be found online.","position":{"start":{"line":48,"column":1,"offset":3176},"end":{"line":48,"column":198,"offset":3373},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":3176},"end":{"line":48,"column":198,"offset":3373},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Features","position":{"start":{"line":50,"column":4,"offset":3378},"end":{"line":50,"column":12,"offset":3386},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3375},"end":{"line":50,"column":12,"offset":3386},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"So you might wonder, what's actually inside the platform? Please find a concrete list of functionalities below, this should give you more insights about how it looks like and what the capabilities are.","position":{"start":{"line":52,"column":1,"offset":3388},"end":{"line":52,"column":202,"offset":3589},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3388},"end":{"line":52,"column":202,"offset":3589},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Secured storage","position":{"start":{"line":54,"column":4,"offset":3594},"end":{"line":54,"column":19,"offset":3609},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3591},"end":{"line":54,"column":19,"offset":3609},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Cloud allows you to store your data in the cloud, and make it available using a secured web interface. This is how it works.","position":{"start":{"line":56,"column":1,"offset":3611},"end":{"line":56,"column":134,"offset":3744},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3611},"end":{"line":56,"column":134,"offset":3744},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed a Kerberos agent, and created an account on ","position":{"start":{"line":58,"column":1,"offset":3746},"end":{"line":58,"column":67,"offset":3812},"indent":[]}},{"type":"link","title":null,"url":"https://cloud.kerberos.io","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":58,"column":68,"offset":3813},"end":{"line":58,"column":82,"offset":3827},"indent":[]}}],"position":{"start":{"line":58,"column":67,"offset":3812},"end":{"line":58,"column":110,"offset":3855},"indent":[]}},{"type":"text","value":", you will be able to connect both systems together. By entering credentials received from Kerberos Cloud, into your Kerberos agent, your media recordings will be send to our cloud storage.","position":{"start":{"line":58,"column":110,"offset":3855},"end":{"line":58,"column":299,"offset":4044},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3746},"end":{"line":58,"column":299,"offset":4044},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"You can link one or more Kerberos agents to your Kerberos Cloud account.","position":{"start":{"line":60,"column":3,"offset":4048},"end":{"line":60,"column":75,"offset":4120},"indent":[]}}],"position":{"start":{"line":60,"column":3,"offset":4048},"end":{"line":60,"column":75,"offset":4120},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4046},"end":{"line":60,"column":75,"offset":4120},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-linking.png","alt":"cloud linking","position":{"start":{"line":62,"column":1,"offset":4122},"end":{"line":62,"column":65,"offset":4186},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4122},"end":{"line":62,"column":65,"offset":4186},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After linking your media recorded by a Kerberos agent will be send to our secure cloud storage, Kerberos Storage. By default our own ","position":{"start":{"line":64,"column":1,"offset":4188},"end":{"line":64,"column":134,"offset":4321},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":64,"column":135,"offset":4322},"end":{"line":64,"column":151,"offset":4338},"indent":[]}}],"position":{"start":{"line":64,"column":134,"offset":4321},"end":{"line":64,"column":175,"offset":4362},"indent":[]}},{"type":"text","value":" service is used, however you can install your own ","position":{"start":{"line":64,"column":175,"offset":4362},"end":{"line":64,"column":226,"offset":4413},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":64,"column":227,"offset":4414},"end":{"line":64,"column":243,"offset":4430},"indent":[]}}],"position":{"start":{"line":64,"column":226,"offset":4413},"end":{"line":64,"column":267,"offset":4454},"indent":[]}},{"type":"text","value":" and link it to our public cloud. By doing this all the recordings are stored in your own datacenter of choice, and only metadata is stored inside Kerberos Cloud.","position":{"start":{"line":64,"column":267,"offset":4454},"end":{"line":64,"column":429,"offset":4616},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4188},"end":{"line":64,"column":429,"offset":4616},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-network-onprem.png","alt":"cloud","position":{"start":{"line":66,"column":1,"offset":4618},"end":{"line":66,"column":58,"offset":4675},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":4618},"end":{"line":66,"column":58,"offset":4675},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once stored your media recordings will be processed by different functions and algorithms to send alerts, apply machine learning and much more.","position":{"start":{"line":68,"column":1,"offset":4677},"end":{"line":68,"column":144,"offset":4820},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":4677},"end":{"line":68,"column":144,"offset":4820},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"Kerberos Cloud is much more than a storage service, you get intelligent capabilities as well. Read on to discover more.","position":{"start":{"line":70,"column":3,"offset":4824},"end":{"line":70,"column":122,"offset":4943},"indent":[]}}],"position":{"start":{"line":70,"column":3,"offset":4824},"end":{"line":70,"column":122,"offset":4943},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":4822},"end":{"line":70,"column":122,"offset":4943},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Consolidated overview","position":{"start":{"line":72,"column":4,"offset":4948},"end":{"line":72,"column":25,"offset":4969},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":4945},"end":{"line":72,"column":25,"offset":4969},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Cloud will group your media recordings (coming from one or more Kerberos agents) into time bundles. We do this to simplify the searching of a specific event. Less data is shown at once, and when needed you can drill down a level deeper to see more details.","position":{"start":{"line":74,"column":1,"offset":4971},"end":{"line":74,"column":266,"offset":5236},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":4971},"end":{"line":74,"column":266,"offset":5236},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-overview.png","alt":"cloud overview","position":{"start":{"line":76,"column":1,"offset":5238},"end":{"line":76,"column":67,"offset":5304},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":5238},"end":{"line":76,"column":67,"offset":5304},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In a sneak peek you will see how many media recordings were generated during a certain time period, and which Kerberos agents were involved. For example, this might give you an indication of a particular event (more about in the machine learning section).","position":{"start":{"line":78,"column":1,"offset":5306},"end":{"line":78,"column":256,"offset":5561},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":5306},"end":{"line":78,"column":256,"offset":5561},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Security","position":{"start":{"line":80,"column":5,"offset":5567},"end":{"line":80,"column":13,"offset":5575},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":5563},"end":{"line":80,"column":13,"offset":5575},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you're inside your Kerberos Cloud account, you will see all the available media recordings of your Kerberos agents in a single interface. So how does this work?","position":{"start":{"line":82,"column":1,"offset":5577},"end":{"line":82,"column":166,"offset":5742},"indent":[]}}],"position":{"start":{"line":82,"column":1,"offset":5577},"end":{"line":82,"column":166,"offset":5742},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When you open Kerberos Cloud we will generate temporary and private links for every media recording within your account. This link includes a random and unique hash, and is only available for a couple of minutes. So this means that your recording cannot be shared afterwards, or the risk someone else accessing that link is minimised.","position":{"start":{"line":84,"column":1,"offset":5744},"end":{"line":84,"column":335,"offset":6078},"indent":[]}}],"position":{"start":{"line":84,"column":1,"offset":5744},"end":{"line":84,"column":335,"offset":6078},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Advanced searching","position":{"start":{"line":86,"column":4,"offset":6083},"end":{"line":86,"column":22,"offset":6101},"indent":[]}}],"position":{"start":{"line":86,"column":1,"offset":6080},"end":{"line":86,"column":22,"offset":6101},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to showing all your recordings in one overview, we also give you the capabilities to search for a recording more easily. For example you can search for recordings within a specific time boundary, recordings generated by a specific Kerberos agent, recordings which are marked as important, classified recordings such as pedestrians or animals, and more.","position":{"start":{"line":88,"column":1,"offset":6103},"end":{"line":88,"column":358,"offset":6460},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":6103},"end":{"line":88,"column":358,"offset":6460},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-search.png","alt":"cloud search","position":{"start":{"line":90,"column":1,"offset":6462},"end":{"line":90,"column":63,"offset":6524},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":6462},"end":{"line":90,"column":63,"offset":6524},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Machine learning","position":{"start":{"line":92,"column":4,"offset":6529},"end":{"line":92,"column":20,"offset":6545},"indent":[]}}],"position":{"start":{"line":92,"column":1,"offset":6526},"end":{"line":92,"column":20,"offset":6545},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"With Kerberos Cloud you will get far more than just a nice interface for finding back your recordings. When a recording is uploaded to Kerberos Cloud, we will execute all kind of algorithms. One of these algorithms is classification. This algorithm is used to classify/recognise all the objects inside your recording. Any human, vehicle or animal in the recording will be labeled.","position":{"start":{"line":94,"column":1,"offset":6547},"end":{"line":94,"column":381,"offset":6927},"indent":[]}}],"position":{"start":{"line":94,"column":1,"offset":6547},"end":{"line":94,"column":381,"offset":6927},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to classifying, the algorithm is also tracing the classified objects. By doing this we can label the recording with the object of interest. For example at the image below you see the traject of a pedestrian walking by (710 pixels).","position":{"start":{"line":96,"column":1,"offset":6929},"end":{"line":96,"column":237,"offset":7165},"indent":[]}}],"position":{"start":{"line":96,"column":1,"offset":6929},"end":{"line":96,"column":237,"offset":7165},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-ml.png","alt":"cloud ml","position":{"start":{"line":98,"column":1,"offset":7167},"end":{"line":98,"column":55,"offset":7221},"indent":[]}}],"position":{"start":{"line":98,"column":1,"offset":7167},"end":{"line":98,"column":55,"offset":7221},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Alerts","position":{"start":{"line":100,"column":4,"offset":7226},"end":{"line":100,"column":10,"offset":7232},"indent":[]}}],"position":{"start":{"line":100,"column":1,"offset":7223},"end":{"line":100,"column":10,"offset":7232},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When a specific event occurred, a notification can be send to one or more channels. A user can compose an event by selecting one or more conditions. Once the event is triggered, a notification is sent to all the enabled channels.","position":{"start":{"line":102,"column":1,"offset":7234},"end":{"line":102,"column":230,"offset":7463},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":7234},"end":{"line":102,"column":230,"offset":7463},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Notifications","position":{"start":{"line":104,"column":5,"offset":7469},"end":{"line":104,"column":18,"offset":7482},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":7465},"end":{"line":104,"column":18,"offset":7482},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":" Kerberos Cloud supports different types of notifications:","position":{"start":{"line":106,"column":1,"offset":7484},"end":{"line":106,"column":59,"offset":7542},"indent":[]}}],"position":{"start":{"line":106,"column":1,"offset":7484},"end":{"line":106,"column":59,"offset":7542},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Detections","position":{"start":{"line":108,"column":6,"offset":7549},"end":{"line":108,"column":16,"offset":7559},"indent":[]}}],"position":{"start":{"line":108,"column":4,"offset":7547},"end":{"line":108,"column":18,"offset":7561},"indent":[]}},{"type":"text","value":": send a notification if a recording was received from a specific Kerberos agent, within a time range, with a specific classification, etc.","position":{"start":{"line":108,"column":18,"offset":7561},"end":{"line":108,"column":157,"offset":7700},"indent":[]}}],"position":{"start":{"line":108,"column":4,"offset":7547},"end":{"line":108,"column":157,"offset":7700},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":7544},"end":{"line":108,"column":157,"offset":7700},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Devices","position":{"start":{"line":109,"column":6,"offset":7706},"end":{"line":109,"column":13,"offset":7713},"indent":[]}}],"position":{"start":{"line":109,"column":4,"offset":7704},"end":{"line":109,"column":15,"offset":7715},"indent":[]}},{"type":"text","value":": when one of your Kerberos agents stopped working, a notification can be send.","position":{"start":{"line":109,"column":15,"offset":7715},"end":{"line":109,"column":94,"offset":7794},"indent":[]}}],"position":{"start":{"line":109,"column":4,"offset":7704},"end":{"line":109,"column":94,"offset":7794},"indent":[]}}],"position":{"start":{"line":109,"column":1,"offset":7701},"end":{"line":109,"column":94,"offset":7794},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"High upload","position":{"start":{"line":110,"column":6,"offset":7800},"end":{"line":110,"column":17,"offset":7811},"indent":[]}}],"position":{"start":{"line":110,"column":4,"offset":7798},"end":{"line":110,"column":19,"offset":7813},"indent":[]}},{"type":"text","value":": when a lot of recordings are generated within a specific period of time, a notification can be send.","position":{"start":{"line":110,"column":19,"offset":7813},"end":{"line":110,"column":121,"offset":7915},"indent":[]}}],"position":{"start":{"line":110,"column":4,"offset":7798},"end":{"line":110,"column":121,"offset":7915},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":7795},"end":{"line":110,"column":121,"offset":7915},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":7544},"end":{"line":110,"column":121,"offset":7915},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-notifications.png","alt":"cloud notifications","position":{"start":{"line":112,"column":1,"offset":7917},"end":{"line":112,"column":77,"offset":7993},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":7917},"end":{"line":112,"column":77,"offset":7993},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Channels","position":{"start":{"line":114,"column":5,"offset":7999},"end":{"line":114,"column":13,"offset":8007},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":7995},"end":{"line":114,"column":13,"offset":8007},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":" Kerberos Cloud supports different types of channels, towards notifications can be send:","position":{"start":{"line":116,"column":1,"offset":8009},"end":{"line":116,"column":89,"offset":8097},"indent":[]}}],"position":{"start":{"line":116,"column":1,"offset":8009},"end":{"line":116,"column":89,"offset":8097},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Browser","position":{"start":{"line":118,"column":6,"offset":8104},"end":{"line":118,"column":13,"offset":8111},"indent":[]}}],"position":{"start":{"line":118,"column":4,"offset":8102},"end":{"line":118,"column":15,"offset":8113},"indent":[]}},{"type":"text","value":": notifications inside the browser (if the used browser supports this).","position":{"start":{"line":118,"column":15,"offset":8113},"end":{"line":118,"column":86,"offset":8184},"indent":[]}}],"position":{"start":{"line":118,"column":4,"offset":8102},"end":{"line":118,"column":86,"offset":8184},"indent":[]}}],"position":{"start":{"line":118,"column":1,"offset":8099},"end":{"line":118,"column":86,"offset":8184},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"E-mail","position":{"start":{"line":119,"column":6,"offset":8190},"end":{"line":119,"column":12,"offset":8196},"indent":[]}}],"position":{"start":{"line":119,"column":4,"offset":8188},"end":{"line":119,"column":14,"offset":8198},"indent":[]}},{"type":"text","value":": a personal email can be send.","position":{"start":{"line":119,"column":14,"offset":8198},"end":{"line":119,"column":45,"offset":8229},"indent":[]}}],"position":{"start":{"line":119,"column":4,"offset":8188},"end":{"line":119,"column":45,"offset":8229},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":8185},"end":{"line":119,"column":45,"offset":8229},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Slack","position":{"start":{"line":120,"column":6,"offset":8235},"end":{"line":120,"column":11,"offset":8240},"indent":[]}}],"position":{"start":{"line":120,"column":4,"offset":8233},"end":{"line":120,"column":13,"offset":8242},"indent":[]}},{"type":"text","value":": send a message to a slack channel.","position":{"start":{"line":120,"column":13,"offset":8242},"end":{"line":120,"column":49,"offset":8278},"indent":[]}}],"position":{"start":{"line":120,"column":4,"offset":8233},"end":{"line":120,"column":49,"offset":8278},"indent":[]}}],"position":{"start":{"line":120,"column":1,"offset":8230},"end":{"line":120,"column":49,"offset":8278},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Alexa","position":{"start":{"line":121,"column":6,"offset":8284},"end":{"line":121,"column":11,"offset":8289},"indent":[]}}],"position":{"start":{"line":121,"column":4,"offset":8282},"end":{"line":121,"column":13,"offset":8291},"indent":[]}},{"type":"text","value":": send a notification to Alexa skill (","position":{"start":{"line":121,"column":13,"offset":8291},"end":{"line":121,"column":51,"offset":8329},"indent":[]}},{"type":"link","title":null,"url":"https://www.amazon.com/Thomptronics-Notify-Me/dp/B07BB2FYFS","children":[{"type":"text","value":"Notify Me","position":{"start":{"line":121,"column":52,"offset":8330},"end":{"line":121,"column":61,"offset":8339},"indent":[]}}],"position":{"start":{"line":121,"column":51,"offset":8329},"end":{"line":121,"column":123,"offset":8401},"indent":[]}},{"type":"text","value":").","position":{"start":{"line":121,"column":123,"offset":8401},"end":{"line":121,"column":125,"offset":8403},"indent":[]}}],"position":{"start":{"line":121,"column":4,"offset":8282},"end":{"line":121,"column":125,"offset":8403},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":8279},"end":{"line":121,"column":125,"offset":8403},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Telegram","position":{"start":{"line":122,"column":6,"offset":8409},"end":{"line":122,"column":14,"offset":8417},"indent":[]}}],"position":{"start":{"line":122,"column":4,"offset":8407},"end":{"line":122,"column":16,"offset":8419},"indent":[]}},{"type":"text","value":": send a message to a Telegram channel.","position":{"start":{"line":122,"column":16,"offset":8419},"end":{"line":122,"column":55,"offset":8458},"indent":[]}}],"position":{"start":{"line":122,"column":4,"offset":8407},"end":{"line":122,"column":55,"offset":8458},"indent":[]}}],"position":{"start":{"line":122,"column":1,"offset":8404},"end":{"line":122,"column":55,"offset":8458},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Pushbullet","position":{"start":{"line":123,"column":6,"offset":8464},"end":{"line":123,"column":16,"offset":8474},"indent":[]}}],"position":{"start":{"line":123,"column":4,"offset":8462},"end":{"line":123,"column":18,"offset":8476},"indent":[]}},{"type":"text","value":": send a message to a Pushbullet channel.","position":{"start":{"line":123,"column":18,"offset":8476},"end":{"line":123,"column":59,"offset":8517},"indent":[]}}],"position":{"start":{"line":123,"column":4,"offset":8462},"end":{"line":123,"column":59,"offset":8517},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":8459},"end":{"line":123,"column":59,"offset":8517},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Pushover","position":{"start":{"line":124,"column":6,"offset":8523},"end":{"line":124,"column":14,"offset":8531},"indent":[]}}],"position":{"start":{"line":124,"column":4,"offset":8521},"end":{"line":124,"column":16,"offset":8533},"indent":[]}},{"type":"text","value":": send a message to a Pushover channel.","position":{"start":{"line":124,"column":16,"offset":8533},"end":{"line":124,"column":55,"offset":8572},"indent":[]}}],"position":{"start":{"line":124,"column":4,"offset":8521},"end":{"line":124,"column":55,"offset":8572},"indent":[]}}],"position":{"start":{"line":124,"column":1,"offset":8518},"end":{"line":124,"column":55,"offset":8572},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"Webhook","position":{"start":{"line":125,"column":6,"offset":8578},"end":{"line":125,"column":13,"offset":8585},"indent":[]}}],"position":{"start":{"line":125,"column":4,"offset":8576},"end":{"line":125,"column":15,"offset":8587},"indent":[]}},{"type":"text","value":": trigger a webhook (POST).","position":{"start":{"line":125,"column":15,"offset":8587},"end":{"line":125,"column":42,"offset":8614},"indent":[]}}],"position":{"start":{"line":125,"column":4,"offset":8576},"end":{"line":125,"column":42,"offset":8614},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":8573},"end":{"line":125,"column":42,"offset":8614},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"IFTTT","position":{"start":{"line":126,"column":6,"offset":8620},"end":{"line":126,"column":11,"offset":8625},"indent":[]}}],"position":{"start":{"line":126,"column":4,"offset":8618},"end":{"line":126,"column":13,"offset":8627},"indent":[]}},{"type":"text","value":": send a message to IFTTT.","position":{"start":{"line":126,"column":13,"offset":8627},"end":{"line":126,"column":39,"offset":8653},"indent":[]}}],"position":{"start":{"line":126,"column":4,"offset":8618},"end":{"line":126,"column":39,"offset":8653},"indent":[]}}],"position":{"start":{"line":126,"column":1,"offset":8615},"end":{"line":126,"column":39,"offset":8653},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"strong","children":[{"type":"text","value":"SMS","position":{"start":{"line":127,"column":6,"offset":8659},"end":{"line":127,"column":9,"offset":8662},"indent":[]}}],"position":{"start":{"line":127,"column":4,"offset":8657},"end":{"line":127,"column":11,"offset":8664},"indent":[]}},{"type":"text","value":": send a text message to a mobile number.","position":{"start":{"line":127,"column":11,"offset":8664},"end":{"line":127,"column":52,"offset":8705},"indent":[]}}],"position":{"start":{"line":127,"column":4,"offset":8657},"end":{"line":127,"column":52,"offset":8705},"indent":[]}}],"position":{"start":{"line":127,"column":1,"offset":8654},"end":{"line":127,"column":52,"offset":8705},"indent":[]}}],"position":{"start":{"line":118,"column":1,"offset":8099},"end":{"line":127,"column":52,"offset":8705},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-channels.png","alt":"cloud notifications","position":{"start":{"line":129,"column":1,"offset":8707},"end":{"line":129,"column":72,"offset":8778},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":8707},"end":{"line":129,"column":72,"offset":8778},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Live streaming","position":{"start":{"line":131,"column":4,"offset":8783},"end":{"line":131,"column":18,"offset":8797},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":8780},"end":{"line":131,"column":18,"offset":8797},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Cloud allows you to live stream from your Kerberos agents to your Kerberos Cloud account.","position":{"start":{"line":133,"column":1,"offset":8799},"end":{"line":133,"column":99,"offset":8897},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":8799},"end":{"line":133,"column":99,"offset":8897},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For Kerberos Open Source a low resolution livestream is made available, this will allow you to see what is happening in front of your surveillance camera in real-time. The stream is shared over MQTT (TCPS) and visualised in the Kerberos Cloud webinterface using secure websockets (WSS). No port forwarding needs to be enabled.","position":{"start":{"line":135,"column":1,"offset":8899},"end":{"line":135,"column":327,"offset":9225},"indent":[]}}],"position":{"start":{"line":135,"column":1,"offset":8899},"end":{"line":135,"column":327,"offset":9225},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-livestream.png","alt":"cloud livestream","position":{"start":{"line":137,"column":1,"offset":9227},"end":{"line":137,"column":71,"offset":9297},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":9227},"end":{"line":137,"column":71,"offset":9297},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For Kerberos Enterprise a HD livestream is made available. The full resolution and FPS is send through a concept called WebRTC. This WebRTC technology, is used my all major conferencing tools such as Zoom, Teams, etc.","position":{"start":{"line":139,"column":1,"offset":9299},"end":{"line":139,"column":218,"offset":9516},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":9299},"end":{"line":139,"column":218,"offset":9516},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-livestream-webrtc.png","alt":"cloud livestream webrtc","position":{"start":{"line":141,"column":1,"offset":9518},"end":{"line":141,"column":85,"offset":9602},"indent":[]}}],"position":{"start":{"line":141,"column":1,"offset":9518},"end":{"line":141,"column":85,"offset":9602},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Accounts","position":{"start":{"line":143,"column":4,"offset":9607},"end":{"line":143,"column":12,"offset":9615},"indent":[]}}],"position":{"start":{"line":143,"column":1,"offset":9604},"end":{"line":143,"column":12,"offset":9615},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"It's possible to create multiple accounts (also called subaccounts) within your main account. Their are two different roles:","position":{"start":{"line":145,"column":1,"offset":9617},"end":{"line":145,"column":125,"offset":9741},"indent":[]}}],"position":{"start":{"line":145,"column":1,"offset":9617},"end":{"line":145,"column":125,"offset":9741},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Guest: will only see your media recordings. A guest cannot modify, delete or create something.","position":{"start":{"line":147,"column":3,"offset":9745},"end":{"line":147,"column":97,"offset":9839},"indent":[]}}],"position":{"start":{"line":147,"column":3,"offset":9745},"end":{"line":147,"column":97,"offset":9839},"indent":[]}}],"position":{"start":{"line":147,"column":1,"offset":9743},"end":{"line":147,"column":97,"offset":9839},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Editor: has full access, same permissions as the main account.","position":{"start":{"line":148,"column":3,"offset":9842},"end":{"line":148,"column":65,"offset":9904},"indent":[]}}],"position":{"start":{"line":148,"column":3,"offset":9842},"end":{"line":148,"column":65,"offset":9904},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":9840},"end":{"line":148,"column":65,"offset":9904},"indent":[]}}],"position":{"start":{"line":147,"column":1,"offset":9743},"end":{"line":148,"column":65,"offset":9904},"indent":[1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-accounts.png","alt":"cloud accounts","position":{"start":{"line":150,"column":1,"offset":9906},"end":{"line":150,"column":67,"offset":9972},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":9906},"end":{"line":150,"column":67,"offset":9972},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Logging","position":{"start":{"line":152,"column":4,"offset":9977},"end":{"line":152,"column":11,"offset":9984},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":9974},"end":{"line":152,"column":11,"offset":9984},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"All algorithms or functions which are applied to your recording on the Kerberos Cloud platform, are shown on the logging page. You can use this to debug.","position":{"start":{"line":154,"column":1,"offset":9986},"end":{"line":154,"column":154,"offset":10139},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":9986},"end":{"line":154,"column":154,"offset":10139},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-cloud-logging.png","alt":"cloud logging","position":{"start":{"line":156,"column":1,"offset":10141},"end":{"line":156,"column":65,"offset":10205},"indent":[]}}],"position":{"start":{"line":156,"column":1,"offset":10141},"end":{"line":156,"column":65,"offset":10205},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":159,"column":1,"offset":10208},"end":{"line":159,"column":31,"offset":10238},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":159,"column":31,"offset":10238}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Cloud`}

\n

{`When installing a Kerberos agent inside your local network, it's possible to review your activity by using the agent's web interface. By nature, you will not be able to access the web interface from the cloud (outside your local network). On top of that, the Kerberos agent doesn't come with a consolidated overview. This means that you will need to open multiple web interfaces, one for each connected surveillance camera.`}

\n

{`To simplify and resolve all of these challenges, Kerberos Cloud was developed.`}

\n
\n

{`Kerberos Cloud`}{` is a cloud solution which allows you to have a single overview of all the media recordings generated by your surveillance cameras. It's not a solution for processing your surveillance cameras in the cloud. For processing of your surveillance cameras, a Kerberos agent is used.`}

\n
\n

{`A brief list of the key features of Kerberos Cloud are:`}

\n
    \n
  • {`Secured storage`}
    • \n
  • {`Consolidated overview`}
    • \n
  • {`Advanced searching`}
    • \n
  • {`Machine learning`}
    • \n
  • {`Alerts`}
    • \n
  • {`Live streaming`}
    • \n
  • {`Accounts`}
    • \n
  • {`Logging`}
    • \n
\n
\n

{`Checkout `}{`the demo environment`}{` to see and feel the Kerberos Cloud solution yourself.`}

\n
\n

{`Architecture`}

\n

{`A simplified architecture is found below. In this architecture the Kerberos agents are installed on-premise, next to the surveillance cameras. Once one of the agents recorded something it will send the recording to our `}{`Kerberos Storage`}{`, using the credentials you've defined inside the agent.`}

\n

{`As soon as the recording is succesfully received several engines will be executed, that will further process the recording and extract metadata from it (classification, origin of the surveillance camera, etc). A lot of processing is happening behind the scenes (by what we call microservices).`}

\n

{`By using a browser you can navigate to Kerberos Cloud, and review all the recordings made by the Kerberos agents. On top of that you will receive more context about the recordings, get notifications, view a livestream and much more.`}

\n

\"cloud\"

\n

{`Public or Private edition`}

\n

{`They are two different versions of using and deploying Kerberos Cloud, we have the public and private dition. What's the difference?`}

\n

{`The Public edition of Kerberos Cloud, is running all its services in what we often call the public cloud; and to be more specific on AWS and GCP. The Public cloud is mainly built for people who want to have a low cost and small scale VMS in the cloud. It's easy to (un)subscribe to the system, and you can connect your Kerberos agents in a matter of seconds.`}

\n

{`On the other hand we also have the private edition, which is available for enterprises. In contrary to the public edition, a customer can deploy the entire Kerberos Cloud platform (with all its microservices) where it wants (on-premise or cloud). Both public and private edition are built on Kubernetes, this means that you will need to\nhave a Kubernetes cluster available at the location you which to install Kerberos Cloud.`}

\n

{`For more information about the licensing of Kerberos Cloud private edition, please get in touch with cedric@verstraeten.io. The licensing model of Kerberos Cloud public edition can be found online.`}

\n

{`Features`}

\n

{`So you might wonder, what's actually inside the platform? Please find a concrete list of functionalities below, this should give you more insights about how it looks like and what the capabilities are.`}

\n

{`Secured storage`}

\n

{`Kerberos Cloud allows you to store your data in the cloud, and make it available using a secured web interface. This is how it works.`}

\n

{`Once you've installed a Kerberos agent, and created an account on `}{`Kerberos Cloud`}{`, you will be able to connect both systems together. By entering credentials received from Kerberos Cloud, into your Kerberos agent, your media recordings will be send to our cloud storage.`}

\n
\n

{`You can link one or more Kerberos agents to your Kerberos Cloud account.`}

\n
\n

\"cloud

\n

{`After linking your media recorded by a Kerberos agent will be send to our secure cloud storage, Kerberos Storage. By default our own `}{`Kerberos Storage`}{` service is used, however you can install your own `}{`Kerberos Storage`}{` and link it to our public cloud. By doing this all the recordings are stored in your own datacenter of choice, and only metadata is stored inside Kerberos Cloud.`}

\n

\"cloud\"

\n

{`Once stored your media recordings will be processed by different functions and algorithms to send alerts, apply machine learning and much more.`}

\n
\n

{`Kerberos Cloud is much more than a storage service, you get intelligent capabilities as well. Read on to discover more.`}

\n
\n

{`Consolidated overview`}

\n

{`Kerberos Cloud will group your media recordings (coming from one or more Kerberos agents) into time bundles. We do this to simplify the searching of a specific event. Less data is shown at once, and when needed you can drill down a level deeper to see more details.`}

\n

\"cloud

\n

{`In a sneak peek you will see how many media recordings were generated during a certain time period, and which Kerberos agents were involved. For example, this might give you an indication of a particular event (more about in the machine learning section).`}

\n

{`Security`}

\n

{`Once you're inside your Kerberos Cloud account, you will see all the available media recordings of your Kerberos agents in a single interface. So how does this work?`}

\n

{`When you open Kerberos Cloud we will generate temporary and private links for every media recording within your account. This link includes a random and unique hash, and is only available for a couple of minutes. So this means that your recording cannot be shared afterwards, or the risk someone else accessing that link is minimised.`}

\n

{`Advanced searching`}

\n

{`Next to showing all your recordings in one overview, we also give you the capabilities to search for a recording more easily. For example you can search for recordings within a specific time boundary, recordings generated by a specific Kerberos agent, recordings which are marked as important, classified recordings such as pedestrians or animals, and more.`}

\n

\"cloud

\n

{`Machine learning`}

\n

{`With Kerberos Cloud you will get far more than just a nice interface for finding back your recordings. When a recording is uploaded to Kerberos Cloud, we will execute all kind of algorithms. One of these algorithms is classification. This algorithm is used to classify/recognise all the objects inside your recording. Any human, vehicle or animal in the recording will be labeled.`}

\n

{`Next to classifying, the algorithm is also tracing the classified objects. By doing this we can label the recording with the object of interest. For example at the image below you see the traject of a pedestrian walking by (710 pixels).`}

\n

\"cloud

\n

{`Alerts`}

\n

{`When a specific event occurred, a notification can be send to one or more channels. A user can compose an event by selecting one or more conditions. Once the event is triggered, a notification is sent to all the enabled channels.`}

\n

{`Notifications`}

\n

{` Kerberos Cloud supports different types of notifications:`}

\n
    \n
  • {`Detections`}{`: send a notification if a recording was received from a specific Kerberos agent, within a time range, with a specific classification, etc.`}
    • \n
  • {`Devices`}{`: when one of your Kerberos agents stopped working, a notification can be send.`}
    • \n
  • {`High upload`}{`: when a lot of recordings are generated within a specific period of time, a notification can be send.`}
    • \n
\n

\"cloud

\n

{`Channels`}

\n

{` Kerberos Cloud supports different types of channels, towards notifications can be send:`}

\n
    \n
  • {`Browser`}{`: notifications inside the browser (if the used browser supports this).`}
    • \n
  • {`E-mail`}{`: a personal email can be send.`}
    • \n
  • {`Slack`}{`: send a message to a slack channel.`}
    • \n
  • {`Alexa`}{`: send a notification to Alexa skill (`}{`Notify Me`}{`).`}
    • \n
  • {`Telegram`}{`: send a message to a Telegram channel.`}
    • \n
  • {`Pushbullet`}{`: send a message to a Pushbullet channel.`}
    • \n
  • {`Pushover`}{`: send a message to a Pushover channel.`}
    • \n
  • {`Webhook`}{`: trigger a webhook (POST).`}
    • \n
  • {`IFTTT`}{`: send a message to IFTTT.`}
    • \n
  • {`SMS`}{`: send a text message to a mobile number.`}
    • \n
\n

\"cloud

\n

{`Live streaming`}

\n

{`Kerberos Cloud allows you to live stream from your Kerberos agents to your Kerberos Cloud account.`}

\n

{`For Kerberos Open Source a low resolution livestream is made available, this will allow you to see what is happening in front of your surveillance camera in real-time. The stream is shared over MQTT (TCPS) and visualised in the Kerberos Cloud webinterface using secure websockets (WSS). No port forwarding needs to be enabled.`}

\n

\"cloud

\n

{`For Kerberos Enterprise a HD livestream is made available. The full resolution and FPS is send through a concept called WebRTC. This WebRTC technology, is used my all major conferencing tools such as Zoom, Teams, etc.`}

\n

\"cloud

\n

{`Accounts`}

\n

{`It's possible to create multiple accounts (also called subaccounts) within your main account. Their are two different roles:`}

\n
    \n
  • {`Guest: will only see your media recordings. A guest cannot modify, delete or create something.`}
    • \n
  • {`Editor: has full access, same permissions as the main account.`}
    • \n
\n

\"cloud

\n

{`Logging`}

\n

{`All algorithms or functions which are applied to your recording on the Kerberos Cloud platform, are shown on the logging page. You can use this to debug.`}

\n

\"cloud

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2f1ee298642fa7657d326b90102f027a.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2f1ee298642fa7657d326b90102f027a.json new file mode 100644 index 0000000..cfde309 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-2f1ee298642fa7657d326b90102f027a.json @@ -0,0 +1 @@ +{"expireTime":9007200861750690000,"key":"gatsby-plugin-mdx-entire-payload-187fa5699a6f710d572775708cd8d228-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Enterprise","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.","position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}}],"position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Independent from that we've seen many vendors developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solutions with limited API's and/or messaging capabilities.","position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":280,"offset":1057},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":280,"offset":1057},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the ground up. Major key differentiators compared to to other solutions are:","position":{"start":{"line":18,"column":1,"offset":1059},"end":{"line":18,"column":332,"offset":1390},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1059},"end":{"line":18,"column":332,"offset":1390},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Scalability with Kubernetes,","position":{"start":{"line":20,"column":5,"offset":1396},"end":{"line":20,"column":33,"offset":1424},"indent":[]}}],"position":{"start":{"line":20,"column":5,"offset":1396},"end":{"line":20,"column":33,"offset":1424},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1392},"end":{"line":20,"column":33,"offset":1424},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Open API's with well documented Swagger API's,","position":{"start":{"line":21,"column":5,"offset":1429},"end":{"line":21,"column":51,"offset":1475},"indent":[]}}],"position":{"start":{"line":21,"column":5,"offset":1429},"end":{"line":21,"column":51,"offset":1475},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1425},"end":{"line":21,"column":51,"offset":1475},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Host anywhere, in the cloud or on premise.","position":{"start":{"line":22,"column":5,"offset":1480},"end":{"line":22,"column":47,"offset":1522},"indent":[]}}],"position":{"start":{"line":22,"column":5,"offset":1480},"end":{"line":22,"column":47,"offset":1522},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1476},"end":{"line":22,"column":47,"offset":1522},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Integration and extension, allowing to build custom apps, ML services and more.","position":{"start":{"line":23,"column":5,"offset":1527},"end":{"line":23,"column":84,"offset":1606},"indent":[]}}],"position":{"start":{"line":23,"column":5,"offset":1527},"end":{"line":23,"column":84,"offset":1606},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1523},"end":{"line":23,"column":84,"offset":1606},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1392},"end":{"line":23,"column":84,"offset":1606},"indent":[1,1,1]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":25,"column":1,"offset":1608},"end":{"line":27,"column":11,"offset":1810},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":29,"column":4,"offset":1815},"end":{"line":29,"column":14,"offset":1825},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1812},"end":{"line":29,"column":14,"offset":1825},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.","position":{"start":{"line":31,"column":1,"offset":1827},"end":{"line":31,"column":306,"offset":2132},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1827},"end":{"line":31,"column":306,"offset":2132},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":33,"column":1,"offset":2134},"end":{"line":33,"column":91,"offset":2224},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2134},"end":{"line":33,"column":91,"offset":2224},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).","position":{"start":{"line":35,"column":1,"offset":2226},"end":{"line":35,"column":239,"offset":2464},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2226},"end":{"line":35,"column":239,"offset":2464},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.","position":{"start":{"line":37,"column":1,"offset":2466},"end":{"line":37,"column":242,"offset":2707},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2466},"end":{"line":37,"column":242,"offset":2707},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.","position":{"start":{"line":39,"column":1,"offset":2709},"end":{"line":39,"column":205,"offset":2913},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2709},"end":{"line":39,"column":205,"offset":2913},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud or on premise","position":{"start":{"line":41,"column":4,"offset":2918},"end":{"line":41,"column":23,"offset":2937},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2915},"end":{"line":41,"column":23,"offset":2937},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.","position":{"start":{"line":43,"column":1,"offset":2939},"end":{"line":43,"column":283,"offset":3221},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2939},"end":{"line":43,"column":283,"offset":3221},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":45,"column":1,"offset":3223},"end":{"line":45,"column":97,"offset":3319},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":3223},"end":{"line":45,"column":97,"offset":3319},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":47,"column":4,"offset":3324},"end":{"line":47,"column":13,"offset":3333},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3321},"end":{"line":47,"column":13,"offset":3333},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is publicly available and ","position":{"start":{"line":49,"column":1,"offset":3335},"end":{"line":49,"column":47,"offset":3381},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":49,"column":49,"offset":3383},"end":{"line":49,"column":57,"offset":3391},"indent":[]}}],"position":{"start":{"line":49,"column":47,"offset":3381},"end":{"line":49,"column":59,"offset":3393},"indent":[]}},{"type":"text","value":" require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.","position":{"start":{"line":49,"column":59,"offset":3393},"end":{"line":49,"column":174,"offset":3508},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3335},"end":{"line":49,"column":174,"offset":3508},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":52,"column":1,"offset":3511},"end":{"line":52,"column":31,"offset":3541},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":52,"column":31,"offset":3541}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Enterprise`}

\n

{`Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.`}

\n

{`That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.`}

\n

{`Independent from that we've seen many vendors developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solutions with limited API's and/or messaging capabilities.`}

\n

{`Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the ground up. Major key differentiators compared to to other solutions are:`}

\n
    \n
  • {`Scalability with Kubernetes,`}
    • \n
  • {`Open API's with well documented Swagger API's,`}
    • \n
  • {`Host anywhere, in the cloud or on premise.`}
    • \n
  • {`Integration and extension, allowing to build custom apps, ML services and more.`}
    • \n
\n
\n
\n

\n

{`Kubernetes`}

\n

{`To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.`}

\n

\"architecture

\n

{`Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).`}

\n

{`Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.`}

\n

{`By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.`}

\n

{`Cloud or on premise`}

\n

{`You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.`}

\n

\"architecture

\n

{`Licensing`}

\n

{`Kerberos Enterprise is publicly available and `}{`does not`}{` require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-32b2afad1d87d362789a8512873828bb.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-32b2afad1d87d362789a8512873828bb.json index 5bee3b0..267ea1a 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-32b2afad1d87d362789a8512873828bb.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-32b2afad1d87d362789a8512873828bb.json @@ -1 +1 @@ -{"expireTime":9007200861747672000,"key":"gatsby-plugin-mdx-entire-payload-b34dc2451d26a40200ded75d09d54590-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"First things first","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":21,"offset":179},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":21,"offset":179},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos started as an Open Source project back in 2014. Our main goal was, and still is, to provide everyone in this world with a free, professional and complete video surveillance system, which they can install in a couple of minutes.\nKerberos was initially developed for the Raspberry Pi, due to this many of the tools we have been using are lightweight and fast (such as C++). Over the years we have found other ways to make Kerberos available, such as KiOS (our custom Linux), Docker and Kubernetes.","position":{"start":{"line":10,"column":1,"offset":181},"end":{"line":11,"column":268,"offset":685},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":181},"end":{"line":11,"column":268,"offset":685},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"In this section we want to make clear what the Open Source version of Kerberos is about, and when you should be using it. What it can do, and what it can't do.","position":{"start":{"line":13,"column":1,"offset":687},"end":{"line":13,"column":160,"offset":846},"indent":[]}}],"position":{"start":{"line":13,"column":1,"offset":687},"end":{"line":13,"column":160,"offset":846},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"License","position":{"start":{"line":15,"column":4,"offset":851},"end":{"line":15,"column":11,"offset":858},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":848},"end":{"line":15,"column":11,"offset":858},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Kerberos Open Source project is licensed with ","position":{"start":{"line":17,"column":1,"offset":860},"end":{"line":17,"column":51,"offset":910},"indent":[]}},{"type":"link","title":null,"url":"/opensource/license","children":[{"type":"text","value":"BY-NC-SA 4.0","position":{"start":{"line":17,"column":52,"offset":911},"end":{"line":17,"column":64,"offset":923},"indent":[]}}],"position":{"start":{"line":17,"column":51,"offset":910},"end":{"line":17,"column":86,"offset":945},"indent":[]}},{"type":"text","value":", this means that everyone can use Kerberos and modify if to their needs, in a non commercial activity.","position":{"start":{"line":17,"column":86,"offset":945},"end":{"line":17,"column":189,"offset":1048},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":860},"end":{"line":17,"column":189,"offset":1048},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"When using the Open Source version","position":{"start":{"line":20,"column":4,"offset":1054},"end":{"line":20,"column":38,"offset":1088},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":38,"offset":1088},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source is perfect for personal usage. It's great if you only have a couple of surveillance cameras to be managed. A Kerberos agent (e.g. on a Raspberry Pi or inside a Docker container) runs for each camera. Their are many different installation possibilities, please have a look at the ","position":{"start":{"line":22,"column":1,"offset":1090},"end":{"line":22,"column":301,"offset":1390},"indent":[]}},{"type":"link","title":null,"url":"/architectures","children":[{"type":"text","value":"architecture","position":{"start":{"line":22,"column":302,"offset":1391},"end":{"line":22,"column":314,"offset":1403},"indent":[]}}],"position":{"start":{"line":22,"column":301,"offset":1390},"end":{"line":22,"column":331,"offset":1420},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":22,"column":331,"offset":1420},"end":{"line":22,"column":335,"offset":1424},"indent":[]}},{"type":"link","title":null,"url":"/opensource/installation","children":[{"type":"text","value":"installation page","position":{"start":{"line":22,"column":336,"offset":1425},"end":{"line":22,"column":353,"offset":1442},"indent":[]}}],"position":{"start":{"line":22,"column":335,"offset":1424},"end":{"line":22,"column":380,"offset":1469},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":22,"column":380,"offset":1469},"end":{"line":22,"column":381,"offset":1470},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1090},"end":{"line":22,"column":381,"offset":1470},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Every Kerberos agent has it's own web interface (front-end) to review media recording, and processing engine (back-end) of a specific surveillance camera. The Open Source version doesn't come with a central overview of all recordings generated by your Kerberos agents. For this feature we highly recommend ","position":{"start":{"line":24,"column":1,"offset":1472},"end":{"line":24,"column":307,"offset":1778},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos cloud","position":{"start":{"line":24,"column":308,"offset":1779},"end":{"line":24,"column":322,"offset":1793},"indent":[]}}],"position":{"start":{"line":24,"column":307,"offset":1778},"end":{"line":24,"column":331,"offset":1802},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":24,"column":331,"offset":1802},"end":{"line":24,"column":332,"offset":1803},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1472},"end":{"line":24,"column":332,"offset":1803},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to manage more than 10 Kerberos agents, it's recommended to use ","position":{"start":{"line":26,"column":1,"offset":1805},"end":{"line":26,"column":77,"offset":1881},"indent":[]}},{"type":"link","title":null,"url":"/enterprise","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":26,"column":78,"offset":1882},"end":{"line":26,"column":97,"offset":1901},"indent":[]}}],"position":{"start":{"line":26,"column":77,"offset":1881},"end":{"line":26,"column":111,"offset":1915},"indent":[]}},{"type":"text","value":". This will help you to scale, support high availability and load balancing. Check out the ","position":{"start":{"line":26,"column":111,"offset":1915},"end":{"line":26,"column":202,"offset":2006},"indent":[]}},{"type":"link","title":null,"url":"/architectures","children":[{"type":"text","value":"architectures section","position":{"start":{"line":26,"column":203,"offset":2007},"end":{"line":26,"column":224,"offset":2028},"indent":[]}}],"position":{"start":{"line":26,"column":202,"offset":2006},"end":{"line":26,"column":241,"offset":2045},"indent":[]}},{"type":"text","value":" for a better understanding of when to use what.","position":{"start":{"line":26,"column":241,"offset":2045},"end":{"line":26,"column":289,"offset":2093},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1805},"end":{"line":26,"column":289,"offset":2093},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"How to install","position":{"start":{"line":28,"column":4,"offset":2098},"end":{"line":28,"column":18,"offset":2112},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":2095},"end":{"line":28,"column":18,"offset":2112},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A Kerberos Open Source agent can be installed in different ways. Every installation method have their own advantages and disadvantages. Depending on the usecase you could choose one method over the other. Read more on the ","position":{"start":{"line":30,"column":1,"offset":2114},"end":{"line":30,"column":223,"offset":2336},"indent":[]}},{"type":"link","title":null,"url":"/opensource/installation","children":[{"type":"text","value":"installation section","position":{"start":{"line":30,"column":224,"offset":2337},"end":{"line":30,"column":244,"offset":2357},"indent":[]}}],"position":{"start":{"line":30,"column":223,"offset":2336},"end":{"line":30,"column":271,"offset":2384},"indent":[]}},{"type":"text","value":", to learn about the different installation methods.","position":{"start":{"line":30,"column":271,"offset":2384},"end":{"line":30,"column":323,"offset":2436},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2114},"end":{"line":30,"column":323,"offset":2436},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"KiOS: You have a Raspberry Pi, and you only want to run the Kerberos agent on it.","position":{"start":{"line":32,"column":4,"offset":2441},"end":{"line":32,"column":85,"offset":2522},"indent":[]}}],"position":{"start":{"line":32,"column":4,"offset":2441},"end":{"line":32,"column":85,"offset":2522},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2438},"end":{"line":32,"column":85,"offset":2522},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Raspbian: You have a Raspberry Pi, but you want other services running next to your Kerberos agent.","position":{"start":{"line":33,"column":4,"offset":2526},"end":{"line":33,"column":103,"offset":2625},"indent":[]}}],"position":{"start":{"line":33,"column":4,"offset":2526},"end":{"line":33,"column":103,"offset":2625},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2523},"end":{"line":33,"column":103,"offset":2625},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Docker: You have a lot of IP cameras, and/or don't want to mess with dependencies.","position":{"start":{"line":34,"column":4,"offset":2629},"end":{"line":34,"column":86,"offset":2711},"indent":[]}}],"position":{"start":{"line":34,"column":4,"offset":2629},"end":{"line":34,"column":86,"offset":2711},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2626},"end":{"line":34,"column":86,"offset":2711},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Generic: You want to develop/extend Kerberos Open Source with your own features, or you want to run the Kerberos agent on a not supported OS/architecure.","position":{"start":{"line":35,"column":4,"offset":2715},"end":{"line":35,"column":158,"offset":2869},"indent":[]}}],"position":{"start":{"line":35,"column":4,"offset":2715},"end":{"line":35,"column":158,"offset":2869},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2712},"end":{"line":35,"column":158,"offset":2869},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2438},"end":{"line":35,"column":158,"offset":2869},"indent":[1,1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":38,"column":1,"offset":2872},"end":{"line":38,"column":31,"offset":2902},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":38,"column":31,"offset":2902}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`First things first`}

\n

{`Kerberos started as an Open Source project back in 2014. Our main goal was, and still is, to provide everyone in this world with a free, professional and complete video surveillance system, which they can install in a couple of minutes.\nKerberos was initially developed for the Raspberry Pi, due to this many of the tools we have been using are lightweight and fast (such as C++). Over the years we have found other ways to make Kerberos available, such as KiOS (our custom Linux), Docker and Kubernetes.`}

\n

{`In this section we want to make clear what the Open Source version of Kerberos is about, and when you should be using it. What it can do, and what it can't do.`}

\n

{`License`}

\n

{`The Kerberos Open Source project is licensed with `}{`BY-NC-SA 4.0`}{`, this means that everyone can use Kerberos and modify if to their needs, in a non commercial activity.`}

\n

{`When using the Open Source version`}

\n

{`Kerberos Open Source is perfect for personal usage. It's great if you only have a couple of surveillance cameras to be managed. A Kerberos agent (e.g. on a Raspberry Pi or inside a Docker container) runs for each camera. Their are many different installation possibilities, please have a look at the `}{`architecture`}{` or `}{`installation page`}{`.`}

\n

{`Every Kerberos agent has it's own web interface (front-end) to review media recording, and processing engine (back-end) of a specific surveillance camera. The Open Source version doesn't come with a central overview of all recordings generated by your Kerberos agents. For this feature we highly recommend `}{`Kerberos cloud`}{`.`}

\n

{`If you want to manage more than 10 Kerberos agents, it's recommended to use `}{`Kerberos Enterprise`}{`. This will help you to scale, support high availability and load balancing. Check out the `}{`architectures section`}{` for a better understanding of when to use what.`}

\n

{`How to install`}

\n

{`A Kerberos Open Source agent can be installed in different ways. Every installation method have their own advantages and disadvantages. Depending on the usecase you could choose one method over the other. Read more on the `}{`installation section`}{`, to learn about the different installation methods.`}

\n
    \n
  1. {`KiOS: You have a Raspberry Pi, and you only want to run the Kerberos agent on it.`}
    2. \n
  2. {`Raspbian: You have a Raspberry Pi, but you want other services running next to your Kerberos agent.`}
    3. \n
  3. {`Docker: You have a lot of IP cameras, and/or don't want to mess with dependencies.`}
    4. \n
  4. {`Generic: You want to develop/extend Kerberos Open Source with your own features, or you want to run the Kerberos agent on a not supported OS/architecure.`}
    5. \n
\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750177000,"key":"gatsby-plugin-mdx-entire-payload-b34dc2451d26a40200ded75d09d54590-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"First things first","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":21,"offset":179},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":21,"offset":179},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos started as an Open Source project back in 2014. Our main goal was, and still is, to provide everyone in this world with a free, professional and complete video surveillance system, which they can install in a couple of minutes.\nKerberos was initially developed for the Raspberry Pi, due to this many of the tools we have been using are lightweight and fast (such as C++). Over the years we have found other ways to make Kerberos available, such as KiOS (our custom Linux), Docker and Kubernetes.","position":{"start":{"line":10,"column":1,"offset":181},"end":{"line":11,"column":268,"offset":685},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":181},"end":{"line":11,"column":268,"offset":685},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"In this section we want to make clear what the Open Source version of Kerberos is about, and when you should be using it. What it can do, and what it can't do.","position":{"start":{"line":13,"column":1,"offset":687},"end":{"line":13,"column":160,"offset":846},"indent":[]}}],"position":{"start":{"line":13,"column":1,"offset":687},"end":{"line":13,"column":160,"offset":846},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"License","position":{"start":{"line":15,"column":4,"offset":851},"end":{"line":15,"column":11,"offset":858},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":848},"end":{"line":15,"column":11,"offset":858},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Kerberos Open Source project is licensed with ","position":{"start":{"line":17,"column":1,"offset":860},"end":{"line":17,"column":51,"offset":910},"indent":[]}},{"type":"link","title":null,"url":"/opensource/license","children":[{"type":"text","value":"BY-NC-SA 4.0","position":{"start":{"line":17,"column":52,"offset":911},"end":{"line":17,"column":64,"offset":923},"indent":[]}}],"position":{"start":{"line":17,"column":51,"offset":910},"end":{"line":17,"column":86,"offset":945},"indent":[]}},{"type":"text","value":", this means that everyone can use Kerberos and modify if to their needs, in a non commercial activity.","position":{"start":{"line":17,"column":86,"offset":945},"end":{"line":17,"column":189,"offset":1048},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":860},"end":{"line":17,"column":189,"offset":1048},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"When using the Open Source version","position":{"start":{"line":20,"column":4,"offset":1054},"end":{"line":20,"column":38,"offset":1088},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":38,"offset":1088},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source is perfect for personal usage. It's great if you only have a couple of surveillance cameras to be managed. A Kerberos agent (e.g. on a Raspberry Pi or inside a Docker container) runs for each camera. Their are many different installation possibilities, please have a look at the ","position":{"start":{"line":22,"column":1,"offset":1090},"end":{"line":22,"column":301,"offset":1390},"indent":[]}},{"type":"link","title":null,"url":"/architectures","children":[{"type":"text","value":"architecture","position":{"start":{"line":22,"column":302,"offset":1391},"end":{"line":22,"column":314,"offset":1403},"indent":[]}}],"position":{"start":{"line":22,"column":301,"offset":1390},"end":{"line":22,"column":331,"offset":1420},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":22,"column":331,"offset":1420},"end":{"line":22,"column":335,"offset":1424},"indent":[]}},{"type":"link","title":null,"url":"/opensource/installation","children":[{"type":"text","value":"installation page","position":{"start":{"line":22,"column":336,"offset":1425},"end":{"line":22,"column":353,"offset":1442},"indent":[]}}],"position":{"start":{"line":22,"column":335,"offset":1424},"end":{"line":22,"column":380,"offset":1469},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":22,"column":380,"offset":1469},"end":{"line":22,"column":381,"offset":1470},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1090},"end":{"line":22,"column":381,"offset":1470},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Every Kerberos agent has it's own web interface (front-end) to review media recording, and processing engine (back-end) of a specific surveillance camera. The Open Source version doesn't come with a central overview of all recordings generated by your Kerberos agents. For this feature we highly recommend ","position":{"start":{"line":24,"column":1,"offset":1472},"end":{"line":24,"column":307,"offset":1778},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos cloud","position":{"start":{"line":24,"column":308,"offset":1779},"end":{"line":24,"column":322,"offset":1793},"indent":[]}}],"position":{"start":{"line":24,"column":307,"offset":1778},"end":{"line":24,"column":331,"offset":1802},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":24,"column":331,"offset":1802},"end":{"line":24,"column":332,"offset":1803},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1472},"end":{"line":24,"column":332,"offset":1803},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to manage more than 10 Kerberos agents, it's recommended to use ","position":{"start":{"line":26,"column":1,"offset":1805},"end":{"line":26,"column":77,"offset":1881},"indent":[]}},{"type":"link","title":null,"url":"/enterprise","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":26,"column":78,"offset":1882},"end":{"line":26,"column":97,"offset":1901},"indent":[]}}],"position":{"start":{"line":26,"column":77,"offset":1881},"end":{"line":26,"column":111,"offset":1915},"indent":[]}},{"type":"text","value":". This will help you to scale, support high availability and load balancing. Check out the ","position":{"start":{"line":26,"column":111,"offset":1915},"end":{"line":26,"column":202,"offset":2006},"indent":[]}},{"type":"link","title":null,"url":"/architectures","children":[{"type":"text","value":"architectures section","position":{"start":{"line":26,"column":203,"offset":2007},"end":{"line":26,"column":224,"offset":2028},"indent":[]}}],"position":{"start":{"line":26,"column":202,"offset":2006},"end":{"line":26,"column":241,"offset":2045},"indent":[]}},{"type":"text","value":" for a better understanding of when to use what.","position":{"start":{"line":26,"column":241,"offset":2045},"end":{"line":26,"column":289,"offset":2093},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1805},"end":{"line":26,"column":289,"offset":2093},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"How to install","position":{"start":{"line":28,"column":4,"offset":2098},"end":{"line":28,"column":18,"offset":2112},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":2095},"end":{"line":28,"column":18,"offset":2112},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A Kerberos Open Source agent can be installed in different ways. Every installation method have their own advantages and disadvantages. Depending on the usecase you could choose one method over the other. Read more on the ","position":{"start":{"line":30,"column":1,"offset":2114},"end":{"line":30,"column":223,"offset":2336},"indent":[]}},{"type":"link","title":null,"url":"/opensource/installation","children":[{"type":"text","value":"installation section","position":{"start":{"line":30,"column":224,"offset":2337},"end":{"line":30,"column":244,"offset":2357},"indent":[]}}],"position":{"start":{"line":30,"column":223,"offset":2336},"end":{"line":30,"column":271,"offset":2384},"indent":[]}},{"type":"text","value":", to learn about the different installation methods.","position":{"start":{"line":30,"column":271,"offset":2384},"end":{"line":30,"column":323,"offset":2436},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2114},"end":{"line":30,"column":323,"offset":2436},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"KiOS: You have a Raspberry Pi, and you only want to run the Kerberos agent on it.","position":{"start":{"line":32,"column":4,"offset":2441},"end":{"line":32,"column":85,"offset":2522},"indent":[]}}],"position":{"start":{"line":32,"column":4,"offset":2441},"end":{"line":32,"column":85,"offset":2522},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2438},"end":{"line":32,"column":85,"offset":2522},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Raspbian: You have a Raspberry Pi, but you want other services running next to your Kerberos agent.","position":{"start":{"line":33,"column":4,"offset":2526},"end":{"line":33,"column":103,"offset":2625},"indent":[]}}],"position":{"start":{"line":33,"column":4,"offset":2526},"end":{"line":33,"column":103,"offset":2625},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2523},"end":{"line":33,"column":103,"offset":2625},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Docker: You have a lot of IP cameras, and/or don't want to mess with dependencies.","position":{"start":{"line":34,"column":4,"offset":2629},"end":{"line":34,"column":86,"offset":2711},"indent":[]}}],"position":{"start":{"line":34,"column":4,"offset":2629},"end":{"line":34,"column":86,"offset":2711},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2626},"end":{"line":34,"column":86,"offset":2711},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Generic: You want to develop/extend Kerberos Open Source with your own features, or you want to run the Kerberos agent on a not supported OS/architecure.","position":{"start":{"line":35,"column":4,"offset":2715},"end":{"line":35,"column":158,"offset":2869},"indent":[]}}],"position":{"start":{"line":35,"column":4,"offset":2715},"end":{"line":35,"column":158,"offset":2869},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2712},"end":{"line":35,"column":158,"offset":2869},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2438},"end":{"line":35,"column":158,"offset":2869},"indent":[1,1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":38,"column":1,"offset":2872},"end":{"line":38,"column":31,"offset":2902},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":38,"column":31,"offset":2902}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`First things first`}

\n

{`Kerberos started as an Open Source project back in 2014. Our main goal was, and still is, to provide everyone in this world with a free, professional and complete video surveillance system, which they can install in a couple of minutes.\nKerberos was initially developed for the Raspberry Pi, due to this many of the tools we have been using are lightweight and fast (such as C++). Over the years we have found other ways to make Kerberos available, such as KiOS (our custom Linux), Docker and Kubernetes.`}

\n

{`In this section we want to make clear what the Open Source version of Kerberos is about, and when you should be using it. What it can do, and what it can't do.`}

\n

{`License`}

\n

{`The Kerberos Open Source project is licensed with `}{`BY-NC-SA 4.0`}{`, this means that everyone can use Kerberos and modify if to their needs, in a non commercial activity.`}

\n

{`When using the Open Source version`}

\n

{`Kerberos Open Source is perfect for personal usage. It's great if you only have a couple of surveillance cameras to be managed. A Kerberos agent (e.g. on a Raspberry Pi or inside a Docker container) runs for each camera. Their are many different installation possibilities, please have a look at the `}{`architecture`}{` or `}{`installation page`}{`.`}

\n

{`Every Kerberos agent has it's own web interface (front-end) to review media recording, and processing engine (back-end) of a specific surveillance camera. The Open Source version doesn't come with a central overview of all recordings generated by your Kerberos agents. For this feature we highly recommend `}{`Kerberos cloud`}{`.`}

\n

{`If you want to manage more than 10 Kerberos agents, it's recommended to use `}{`Kerberos Enterprise`}{`. This will help you to scale, support high availability and load balancing. Check out the `}{`architectures section`}{` for a better understanding of when to use what.`}

\n

{`How to install`}

\n

{`A Kerberos Open Source agent can be installed in different ways. Every installation method have their own advantages and disadvantages. Depending on the usecase you could choose one method over the other. Read more on the `}{`installation section`}{`, to learn about the different installation methods.`}

\n
    \n
  1. {`KiOS: You have a Raspberry Pi, and you only want to run the Kerberos agent on it.`}
    2. \n
  2. {`Raspbian: You have a Raspberry Pi, but you want other services running next to your Kerberos agent.`}
    3. \n
  3. {`Docker: You have a lot of IP cameras, and/or don't want to mess with dependencies.`}
    4. \n
  4. {`Generic: You want to develop/extend Kerberos Open Source with your own features, or you want to run the Kerberos agent on a not supported OS/architecure.`}
    5. \n
\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-34dc14b30f6b7620a7324faf975fc8fb.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-34dc14b30f6b7620a7324faf975fc8fb.json index d42187d..e8c4abf 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-34dc14b30f6b7620a7324faf975fc8fb.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-34dc14b30f6b7620a7324faf975fc8fb.json @@ -1 +1 @@ -{"expireTime":9007200861747672000,"key":"gatsby-plugin-mdx-entire-payload-8fb38b8a8f3d06675c0af64fd8c8ed72-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Architectures","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":16,"offset":174},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":16,"offset":174},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In this section we will explain some usecases and best practices, which might help you to define the architecture that fits your needs.","position":{"start":{"line":10,"column":1,"offset":176},"end":{"line":10,"column":136,"offset":311},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":176},"end":{"line":10,"column":136,"offset":311},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"Please read the ","position":{"start":{"line":12,"column":3,"offset":315},"end":{"line":12,"column":19,"offset":331},"indent":[]}},{"type":"link","title":null,"url":"/","children":[{"type":"text","value":"introduction page","position":{"start":{"line":12,"column":20,"offset":332},"end":{"line":12,"column":37,"offset":349},"indent":[]}}],"position":{"start":{"line":12,"column":19,"offset":331},"end":{"line":12,"column":41,"offset":353},"indent":[]}},{"type":"text","value":" first, before moving forward.","position":{"start":{"line":12,"column":41,"offset":353},"end":{"line":12,"column":71,"offset":383},"indent":[]}}],"position":{"start":{"line":12,"column":3,"offset":315},"end":{"line":12,"column":71,"offset":383},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":313},"end":{"line":12,"column":71,"offset":383},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When starting with Kerberos you might ask yourself, how should I deploy these so called, Kerberos agents? Well, there are different options. You can install a Kerberos agent on a Raspberry Pi, VM, Server or even in a Kubernetes cluster. So what should you do, and when? Let's have a closer look at the different options.","position":{"start":{"line":14,"column":1,"offset":385},"end":{"line":14,"column":321,"offset":705},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":385},"end":{"line":14,"column":321,"offset":705},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The first thing you need to consider is the environment, in which you want to deploy your Kerberos agents. Is it inside your house, your company or at a public place? Another important factor is the number of surveillance cameras you would like to monitor, and if you have any high availability requirements.","position":{"start":{"line":16,"column":1,"offset":707},"end":{"line":16,"column":309,"offset":1015},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":707},"end":{"line":16,"column":309,"offset":1015},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Agents on-premise","position":{"start":{"line":18,"column":4,"offset":1020},"end":{"line":18,"column":21,"offset":1037},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1017},"end":{"line":18,"column":21,"offset":1037},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The most common scenario is to install your Kerberos agents on-premise. This has a couple of benefits such as latency, bandwidth and a less complex security model. When installing a Kerberos agent on-premise, you have a couple of different options.","position":{"start":{"line":20,"column":1,"offset":1039},"end":{"line":20,"column":249,"offset":1287},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1039},"end":{"line":20,"column":249,"offset":1287},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Open Source (< 5 Kerberos agents)","position":{"start":{"line":22,"column":5,"offset":1293},"end":{"line":22,"column":47,"offset":1335},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1289},"end":{"line":22,"column":47,"offset":1335},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you have a limited number of surveillance cameras you would like to monitor, and don't have any high availability requirements, the Kerberos Open Source agent is a good choice. For example, you can install the Kerberos Open Source agent on a Raspberry Pi, by using ","position":{"start":{"line":24,"column":1,"offset":1337},"end":{"line":24,"column":269,"offset":1605},"indent":[]}},{"type":"link","title":null,"url":"opensource/installation#kios","children":[{"type":"text","value":"KiOS","position":{"start":{"line":24,"column":270,"offset":1606},"end":{"line":24,"column":274,"offset":1610},"indent":[]}}],"position":{"start":{"line":24,"column":269,"offset":1605},"end":{"line":24,"column":305,"offset":1641},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":24,"column":305,"offset":1641},"end":{"line":24,"column":307,"offset":1643},"indent":[]}},{"type":"link","title":null,"url":"opensource/installation#raspbian","children":[{"type":"text","value":"Raspbian OS","position":{"start":{"line":24,"column":308,"offset":1644},"end":{"line":24,"column":319,"offset":1655},"indent":[]}}],"position":{"start":{"line":24,"column":307,"offset":1643},"end":{"line":24,"column":354,"offset":1690},"indent":[]}},{"type":"text","value":" or compile it from source.","position":{"start":{"line":24,"column":354,"offset":1690},"end":{"line":24,"column":381,"offset":1717},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1337},"end":{"line":24,"column":381,"offset":1717},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On below architecture, a couple of Kerberos agents are installed on-premise (inside the local network). A Kerberos agent is installed for each surveillance camera, and each Kerberos agent runs on a seperate host (Raspberry Pi, VM, etc). The web interface of the Kerberos agents can be reached from the internal network, but cannot be accessed from the cloud.","position":{"start":{"line":26,"column":1,"offset":1719},"end":{"line":26,"column":359,"offset":2077},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1719},"end":{"line":26,"column":359,"offset":2077},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent-architecture-kios.png","alt":"architecture kios","position":{"start":{"line":28,"column":1,"offset":2079},"end":{"line":28,"column":76,"offset":2154},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":2079},"end":{"line":28,"column":76,"offset":2154},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Another option to install the Kerberos Open Source agent is to use Docker. Instead of having seperate hosts for each Kerberos agent, you will have a single host (Docker host) with multiple Docker containers. A Docker container is deployed for each surveillance camera, which contains the software to run the Kerberos agent.","position":{"start":{"line":30,"column":1,"offset":2156},"end":{"line":30,"column":324,"offset":2479},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2156},"end":{"line":30,"column":324,"offset":2479},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Running your Kerberos agents inside Docker containers, allows you to process multiple surveilllance cameras using only one host.","position":{"start":{"line":32,"column":1,"offset":2481},"end":{"line":32,"column":129,"offset":2609},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2481},"end":{"line":32,"column":129,"offset":2609},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent-architecture-docker.png","alt":"architecture kios","position":{"start":{"line":34,"column":1,"offset":2611},"end":{"line":34,"column":78,"offset":2688},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2611},"end":{"line":34,"column":78,"offset":2688},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Enterprise (> 5 Kerberos agents)","position":{"start":{"line":36,"column":5,"offset":2694},"end":{"line":36,"column":46,"offset":2735},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2690},"end":{"line":36,"column":46,"offset":2735},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When working within an enterprise context, where you require high availability and have a large amount of surveillance cameras being monitored, ","position":{"start":{"line":38,"column":1,"offset":2737},"end":{"line":38,"column":145,"offset":2881},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":38,"column":146,"offset":2882},"end":{"line":38,"column":165,"offset":2901},"indent":[]}}],"position":{"start":{"line":38,"column":145,"offset":2881},"end":{"line":38,"column":192,"offset":2928},"indent":[]}},{"type":"text","value":" is a good choice. Im comparison to the Open Source version, Kerberos Enterprise will use Kubernetes to help you scale (and secure) your security landscape. Kerberos agents, or Kubernetes deployments, are deployed inside your cluster and load balanced over the different nodes. When a Kerberos agent dies, or the node on which the deployment is running, Kubernetes will reschedule it to another healthy node.","position":{"start":{"line":38,"column":192,"offset":2928},"end":{"line":38,"column":600,"offset":3336},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2737},"end":{"line":38,"column":600,"offset":3336},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":40,"column":1,"offset":3338},"end":{"line":40,"column":88,"offset":3425},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":3338},"end":{"line":40,"column":88,"offset":3425},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Agents in the cloud","position":{"start":{"line":42,"column":4,"offset":3430},"end":{"line":42,"column":23,"offset":3449},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":3427},"end":{"line":42,"column":23,"offset":3449},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Instead of processing your surveillance cameras on-premise you could also process them in the cloud. There are a couple advantages, for example, you don't have to manage your owner hardware, you can simply spin up a VM on one of the hyperscalers.","position":{"start":{"line":44,"column":1,"offset":3451},"end":{"line":44,"column":247,"offset":3697},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":3451},"end":{"line":44,"column":247,"offset":3697},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When dealing with Kerberos agents in the cloud, the complexity starts with the security model. As your surveillance cameras are running somewhere on-premise, you will need to make them available to your Kerberos agents, which are running in the cloud. There are several ways to do that, such as port forwarding (not recommended) or setting up a site-to-site VPN (recommended).","position":{"start":{"line":46,"column":1,"offset":3699},"end":{"line":46,"column":377,"offset":4075},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":3699},"end":{"line":46,"column":377,"offset":4075},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When setting up a VPN connection you will expose your surveillance cameras to your Kerberos agents. Once you've configured the Kerberos agents, data will flow through this secure tunnel, from on-premise to your cloud enviroment.","position":{"start":{"line":48,"column":1,"offset":4077},"end":{"line":48,"column":229,"offset":4305},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":4077},"end":{"line":48,"column":229,"offset":4305},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Open Source (< 5 Kerberos agents)","position":{"start":{"line":50,"column":5,"offset":4311},"end":{"line":50,"column":47,"offset":4353},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":4307},"end":{"line":50,"column":47,"offset":4353},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you have a limited number of surveillance cameras you would like to monitor, and don't have any high availability requirements, the Kerberos Open Source agent is a good choice. You can install the Kerberos Open Source agent on Docker. Instead of having seperate VM's for each Kerberos agent, you will have a single VM (Docker host) with multiple Docker containers. A Docker container is deployed for each surveillance camera, which contains the software to run the Kerberos agent.","position":{"start":{"line":52,"column":1,"offset":4355},"end":{"line":52,"column":484,"offset":4838},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":4355},"end":{"line":52,"column":484,"offset":4838},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent-architecture-docker-cloud.png","alt":"architecture kios","position":{"start":{"line":54,"column":1,"offset":4840},"end":{"line":54,"column":84,"offset":4923},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":4840},"end":{"line":54,"column":84,"offset":4923},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Enterprise (> 5 Kerberos agents)","position":{"start":{"line":56,"column":5,"offset":4929},"end":{"line":56,"column":46,"offset":4970},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":4925},"end":{"line":56,"column":46,"offset":4970},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to ","position":{"start":{"line":58,"column":1,"offset":4972},"end":{"line":58,"column":12,"offset":4983},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":58,"column":13,"offset":4984},"end":{"line":58,"column":32,"offset":5003},"indent":[]}}],"position":{"start":{"line":58,"column":12,"offset":4983},"end":{"line":58,"column":59,"offset":5030},"indent":[]}},{"type":"text","value":" on-premise, you can run the a Kubernetes in the cloud. The exact same solution is available, only the way how you connect to your video surveillance cameras will be different, as they will probably live in a different network. To make this work you will need to setup a VPN tunnel (or whatever your security teams have defined as a back practice). When ","position":{"start":{"line":58,"column":59,"offset":5030},"end":{"line":58,"column":413,"offset":5384},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":58,"column":414,"offset":5385},"end":{"line":58,"column":433,"offset":5404},"indent":[]}}],"position":{"start":{"line":58,"column":413,"offset":5384},"end":{"line":58,"column":460,"offset":5431},"indent":[]}},{"type":"text","value":" is deployed to the cloud, it can be used any where. Public cloud (AWS, Google, Azure, etc) or private cloud. You can run it where you want.","position":{"start":{"line":58,"column":460,"offset":5431},"end":{"line":58,"column":600,"offset":5571},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":4972},"end":{"line":58,"column":600,"offset":5571},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":60,"column":1,"offset":5573},"end":{"line":60,"column":94,"offset":5666},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":5573},"end":{"line":60,"column":94,"offset":5666},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":62,"column":4,"offset":5671},"end":{"line":62,"column":18,"offset":5685},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":5668},"end":{"line":62,"column":18,"offset":5685},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've configured one of the previously mentioned architectures, you will have one or more Kerberos agents running, in the cloud or on-premise.","position":{"start":{"line":64,"column":1,"offset":5687},"end":{"line":64,"column":149,"offset":5835},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":5687},"end":{"line":64,"column":149,"offset":5835},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Kerberos Open Source agent comes with a web interface, which makes it possible to review the activity for that specific agent; they don't have a consolidated overview. This means that you will need to open multiple web interfaces, one for Kerberos agent. In contrary Kerberos Enterprise agents, don't come with a web interface, therefore the Kerberos Cloud (public or private edition) is recommended.","position":{"start":{"line":66,"column":1,"offset":5837},"end":{"line":66,"column":405,"offset":6241},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":5837},"end":{"line":66,"column":405,"offset":6241},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To simplify this process and resolve some other challenges, Kerberos Cloud was developed.","position":{"start":{"line":68,"column":1,"offset":6243},"end":{"line":68,"column":90,"offset":6332},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":6243},"end":{"line":68,"column":90,"offset":6332},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.kerberos.io","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":70,"column":4,"offset":6337},"end":{"line":70,"column":18,"offset":6351},"indent":[]}}],"position":{"start":{"line":70,"column":3,"offset":6336},"end":{"line":70,"column":46,"offset":6379},"indent":[]}},{"type":"text","value":" is a cloud solution which allows you to have a single overview of all the media recordings generated by your surveillance cameras. It's not a solution for processing your surveillance cameras in the cloud. For processing of your surveillance cameras, a Kerberos agent is used.","position":{"start":{"line":70,"column":46,"offset":6379},"end":{"line":70,"column":323,"offset":6656},"indent":[]}}],"position":{"start":{"line":70,"column":3,"offset":6336},"end":{"line":70,"column":323,"offset":6656},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":6334},"end":{"line":70,"column":323,"offset":6656},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A brief list of the key features of Kerberos Cloud are:","position":{"start":{"line":72,"column":1,"offset":6658},"end":{"line":72,"column":56,"offset":6713},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":6658},"end":{"line":72,"column":56,"offset":6713},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secured storage","position":{"start":{"line":74,"column":3,"offset":6717},"end":{"line":74,"column":18,"offset":6732},"indent":[]}}],"position":{"start":{"line":74,"column":3,"offset":6717},"end":{"line":74,"column":18,"offset":6732},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":6715},"end":{"line":74,"column":18,"offset":6732},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Consolidated overview","position":{"start":{"line":75,"column":3,"offset":6735},"end":{"line":75,"column":24,"offset":6756},"indent":[]}}],"position":{"start":{"line":75,"column":3,"offset":6735},"end":{"line":75,"column":24,"offset":6756},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":6733},"end":{"line":75,"column":24,"offset":6756},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Advanced searching","position":{"start":{"line":76,"column":3,"offset":6759},"end":{"line":76,"column":21,"offset":6777},"indent":[]}}],"position":{"start":{"line":76,"column":3,"offset":6759},"end":{"line":76,"column":21,"offset":6777},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":6757},"end":{"line":76,"column":21,"offset":6777},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Machine learning","position":{"start":{"line":77,"column":3,"offset":6780},"end":{"line":77,"column":19,"offset":6796},"indent":[]}}],"position":{"start":{"line":77,"column":3,"offset":6780},"end":{"line":77,"column":19,"offset":6796},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":6778},"end":{"line":77,"column":19,"offset":6796},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Alerts","position":{"start":{"line":78,"column":3,"offset":6799},"end":{"line":78,"column":9,"offset":6805},"indent":[]}}],"position":{"start":{"line":78,"column":3,"offset":6799},"end":{"line":78,"column":9,"offset":6805},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":6797},"end":{"line":78,"column":9,"offset":6805},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Live streaming","position":{"start":{"line":79,"column":3,"offset":6808},"end":{"line":79,"column":17,"offset":6822},"indent":[]}}],"position":{"start":{"line":79,"column":3,"offset":6808},"end":{"line":79,"column":17,"offset":6822},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":6806},"end":{"line":79,"column":17,"offset":6822},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Accounts","position":{"start":{"line":80,"column":3,"offset":6825},"end":{"line":80,"column":11,"offset":6833},"indent":[]}}],"position":{"start":{"line":80,"column":3,"offset":6825},"end":{"line":80,"column":11,"offset":6833},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":6823},"end":{"line":80,"column":11,"offset":6833},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Logging","position":{"start":{"line":81,"column":3,"offset":6836},"end":{"line":81,"column":10,"offset":6843},"indent":[]}}],"position":{"start":{"line":81,"column":3,"offset":6836},"end":{"line":81,"column":10,"offset":6843},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":6834},"end":{"line":81,"column":10,"offset":6843},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":6715},"end":{"line":81,"column":10,"offset":6843},"indent":[1,1,1,1,1,1,1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"Checkout ","position":{"start":{"line":83,"column":3,"offset":6847},"end":{"line":83,"column":12,"offset":6856},"indent":[]}},{"type":"link","title":null,"url":"https://app-demo.kerberos.io","children":[{"type":"text","value":"the demo environment","position":{"start":{"line":83,"column":13,"offset":6857},"end":{"line":83,"column":33,"offset":6877},"indent":[]}}],"position":{"start":{"line":83,"column":12,"offset":6856},"end":{"line":83,"column":64,"offset":6908},"indent":[]}},{"type":"text","value":" to see and feel the Kerberos Cloud solution yourself.","position":{"start":{"line":83,"column":64,"offset":6908},"end":{"line":83,"column":118,"offset":6962},"indent":[]}}],"position":{"start":{"line":83,"column":3,"offset":6847},"end":{"line":83,"column":118,"offset":6962},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":6845},"end":{"line":83,"column":118,"offset":6962},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Architecture","position":{"start":{"line":85,"column":5,"offset":6968},"end":{"line":85,"column":17,"offset":6980},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":6964},"end":{"line":85,"column":17,"offset":6980},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A simplified architecture is found below. In this architecture the Kerberos agents are installed on-premise (but this could also be in the cloud), next to the surveillance cameras. Once one of the agents recorded a footage it will send the recording to our ","position":{"start":{"line":87,"column":1,"offset":6982},"end":{"line":87,"column":258,"offset":7239},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":87,"column":259,"offset":7240},"end":{"line":87,"column":275,"offset":7256},"indent":[]}}],"position":{"start":{"line":87,"column":258,"offset":7239},"end":{"line":87,"column":299,"offset":7280},"indent":[]}},{"type":"text","value":" service, using the credentials you've defined inside the agent.","position":{"start":{"line":87,"column":299,"offset":7280},"end":{"line":87,"column":363,"offset":7344},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":6982},"end":{"line":87,"column":363,"offset":7344},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"As soon as the recording is succesfully received several engines will be executed, that will further process the recording and extract metadata from it (classification, origin of the surveillance camera, etc). A lot of processing is happening behind the scenes.","position":{"start":{"line":89,"column":1,"offset":7346},"end":{"line":89,"column":262,"offset":7607},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":7346},"end":{"line":89,"column":262,"offset":7607},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By using a browser you can navigate to Kerberos Cloud, and review all the recordings made by the Kerberos agents on-premise. On top of that you will receive more context about the recordings, get notifications, view a livestream and much more. Read more about ","position":{"start":{"line":91,"column":1,"offset":7609},"end":{"line":91,"column":261,"offset":7869},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud here","position":{"start":{"line":91,"column":262,"offset":7870},"end":{"line":91,"column":281,"offset":7889},"indent":[]}}],"position":{"start":{"line":91,"column":261,"offset":7869},"end":{"line":91,"column":290,"offset":7898},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":91,"column":290,"offset":7898},"end":{"line":91,"column":291,"offset":7899},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":7609},"end":{"line":91,"column":291,"offset":7899},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":93,"column":1,"offset":7901},"end":{"line":93,"column":53,"offset":7953},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":7901},"end":{"line":93,"column":53,"offset":7953},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":96,"column":1,"offset":7956},"end":{"line":96,"column":31,"offset":7986},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":96,"column":31,"offset":7986}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Architectures`}

\n

{`In this section we will explain some usecases and best practices, which might help you to define the architecture that fits your needs.`}

\n
\n

{`Please read the `}{`introduction page`}{` first, before moving forward.`}

\n
\n

{`When starting with Kerberos you might ask yourself, how should I deploy these so called, Kerberos agents? Well, there are different options. You can install a Kerberos agent on a Raspberry Pi, VM, Server or even in a Kubernetes cluster. So what should you do, and when? Let's have a closer look at the different options.`}

\n

{`The first thing you need to consider is the environment, in which you want to deploy your Kerberos agents. Is it inside your house, your company or at a public place? Another important factor is the number of surveillance cameras you would like to monitor, and if you have any high availability requirements.`}

\n

{`Agents on-premise`}

\n

{`The most common scenario is to install your Kerberos agents on-premise. This has a couple of benefits such as latency, bandwidth and a less complex security model. When installing a Kerberos agent on-premise, you have a couple of different options.`}

\n

{`Kerberos Open Source (< 5 Kerberos agents)`}

\n

{`If you have a limited number of surveillance cameras you would like to monitor, and don't have any high availability requirements, the Kerberos Open Source agent is a good choice. For example, you can install the Kerberos Open Source agent on a Raspberry Pi, by using `}{`KiOS`}{`, `}{`Raspbian OS`}{` or compile it from source.`}

\n

{`On below architecture, a couple of Kerberos agents are installed on-premise (inside the local network). A Kerberos agent is installed for each surveillance camera, and each Kerberos agent runs on a seperate host (Raspberry Pi, VM, etc). The web interface of the Kerberos agents can be reached from the internal network, but cannot be accessed from the cloud.`}

\n

\"architecture

\n

{`Another option to install the Kerberos Open Source agent is to use Docker. Instead of having seperate hosts for each Kerberos agent, you will have a single host (Docker host) with multiple Docker containers. A Docker container is deployed for each surveillance camera, which contains the software to run the Kerberos agent.`}

\n

{`Running your Kerberos agents inside Docker containers, allows you to process multiple surveilllance cameras using only one host.`}

\n

\"architecture

\n

{`Kerberos Enterprise (> 5 Kerberos agents)`}

\n

{`When working within an enterprise context, where you require high availability and have a large amount of surveillance cameras being monitored, `}{`Kerberos Enterprise`}{` is a good choice. Im comparison to the Open Source version, Kerberos Enterprise will use Kubernetes to help you scale (and secure) your security landscape. Kerberos agents, or Kubernetes deployments, are deployed inside your cluster and load balanced over the different nodes. When a Kerberos agent dies, or the node on which the deployment is running, Kubernetes will reschedule it to another healthy node.`}

\n

\"architecture

\n

{`Agents in the cloud`}

\n

{`Instead of processing your surveillance cameras on-premise you could also process them in the cloud. There are a couple advantages, for example, you don't have to manage your owner hardware, you can simply spin up a VM on one of the hyperscalers.`}

\n

{`When dealing with Kerberos agents in the cloud, the complexity starts with the security model. As your surveillance cameras are running somewhere on-premise, you will need to make them available to your Kerberos agents, which are running in the cloud. There are several ways to do that, such as port forwarding (not recommended) or setting up a site-to-site VPN (recommended).`}

\n

{`When setting up a VPN connection you will expose your surveillance cameras to your Kerberos agents. Once you've configured the Kerberos agents, data will flow through this secure tunnel, from on-premise to your cloud enviroment.`}

\n

{`Kerberos Open Source (< 5 Kerberos agents)`}

\n

{`If you have a limited number of surveillance cameras you would like to monitor, and don't have any high availability requirements, the Kerberos Open Source agent is a good choice. You can install the Kerberos Open Source agent on Docker. Instead of having seperate VM's for each Kerberos agent, you will have a single VM (Docker host) with multiple Docker containers. A Docker container is deployed for each surveillance camera, which contains the software to run the Kerberos agent.`}

\n

\"architecture

\n

{`Kerberos Enterprise (> 5 Kerberos agents)`}

\n

{`Similar to `}{`Kerberos Enterprise`}{` on-premise, you can run the a Kubernetes in the cloud. The exact same solution is available, only the way how you connect to your video surveillance cameras will be different, as they will probably live in a different network. To make this work you will need to setup a VPN tunnel (or whatever your security teams have defined as a back practice). When `}{`Kerberos Enterprise`}{` is deployed to the cloud, it can be used any where. Public cloud (AWS, Google, Azure, etc) or private cloud. You can run it where you want.`}

\n

\"architecture

\n

{`Kerberos Cloud`}

\n

{`Once you've configured one of the previously mentioned architectures, you will have one or more Kerberos agents running, in the cloud or on-premise.`}

\n

{`The Kerberos Open Source agent comes with a web interface, which makes it possible to review the activity for that specific agent; they don't have a consolidated overview. This means that you will need to open multiple web interfaces, one for Kerberos agent. In contrary Kerberos Enterprise agents, don't come with a web interface, therefore the Kerberos Cloud (public or private edition) is recommended.`}

\n

{`To simplify this process and resolve some other challenges, Kerberos Cloud was developed.`}

\n
\n

{`Kerberos Cloud`}{` is a cloud solution which allows you to have a single overview of all the media recordings generated by your surveillance cameras. It's not a solution for processing your surveillance cameras in the cloud. For processing of your surveillance cameras, a Kerberos agent is used.`}

\n
\n

{`A brief list of the key features of Kerberos Cloud are:`}

\n
    \n
  • {`Secured storage`}
    • \n
  • {`Consolidated overview`}
    • \n
  • {`Advanced searching`}
    • \n
  • {`Machine learning`}
    • \n
  • {`Alerts`}
    • \n
  • {`Live streaming`}
    • \n
  • {`Accounts`}
    • \n
  • {`Logging`}
    • \n
\n
\n

{`Checkout `}{`the demo environment`}{` to see and feel the Kerberos Cloud solution yourself.`}

\n
\n

{`Architecture`}

\n

{`A simplified architecture is found below. In this architecture the Kerberos agents are installed on-premise (but this could also be in the cloud), next to the surveillance cameras. Once one of the agents recorded a footage it will send the recording to our `}{`Kerberos Storage`}{` service, using the credentials you've defined inside the agent.`}

\n

{`As soon as the recording is succesfully received several engines will be executed, that will further process the recording and extract metadata from it (classification, origin of the surveillance camera, etc). A lot of processing is happening behind the scenes.`}

\n

{`By using a browser you can navigate to Kerberos Cloud, and review all the recordings made by the Kerberos agents on-premise. On top of that you will receive more context about the recordings, get notifications, view a livestream and much more. Read more about `}{`Kerberos Cloud here`}{`.`}

\n

\"cloud\"

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750176000,"key":"gatsby-plugin-mdx-entire-payload-8fb38b8a8f3d06675c0af64fd8c8ed72-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Architectures","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":16,"offset":174},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":16,"offset":174},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In this section we will explain some usecases and best practices, which might help you to define the architecture that fits your needs.","position":{"start":{"line":10,"column":1,"offset":176},"end":{"line":10,"column":136,"offset":311},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":176},"end":{"line":10,"column":136,"offset":311},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"Please read the ","position":{"start":{"line":12,"column":3,"offset":315},"end":{"line":12,"column":19,"offset":331},"indent":[]}},{"type":"link","title":null,"url":"/","children":[{"type":"text","value":"introduction page","position":{"start":{"line":12,"column":20,"offset":332},"end":{"line":12,"column":37,"offset":349},"indent":[]}}],"position":{"start":{"line":12,"column":19,"offset":331},"end":{"line":12,"column":41,"offset":353},"indent":[]}},{"type":"text","value":" first, before moving forward.","position":{"start":{"line":12,"column":41,"offset":353},"end":{"line":12,"column":71,"offset":383},"indent":[]}}],"position":{"start":{"line":12,"column":3,"offset":315},"end":{"line":12,"column":71,"offset":383},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":313},"end":{"line":12,"column":71,"offset":383},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When starting with Kerberos you might ask yourself, how should I deploy these so called, Kerberos agents? Well, there are different options. You can install a Kerberos agent on a Raspberry Pi, VM, Server or even in a Kubernetes cluster. So what should you do, and when? Let's have a closer look at the different options.","position":{"start":{"line":14,"column":1,"offset":385},"end":{"line":14,"column":321,"offset":705},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":385},"end":{"line":14,"column":321,"offset":705},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The first thing you need to consider is the environment, in which you want to deploy your Kerberos agents. Is it inside your house, your company or at a public place? Another important factor is the number of surveillance cameras you would like to monitor, and if you have any high availability requirements.","position":{"start":{"line":16,"column":1,"offset":707},"end":{"line":16,"column":309,"offset":1015},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":707},"end":{"line":16,"column":309,"offset":1015},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Agents on-premise","position":{"start":{"line":18,"column":4,"offset":1020},"end":{"line":18,"column":21,"offset":1037},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1017},"end":{"line":18,"column":21,"offset":1037},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The most common scenario is to install your Kerberos agents on-premise. This has a couple of benefits such as latency, bandwidth and a less complex security model. When installing a Kerberos agent on-premise, you have a couple of different options.","position":{"start":{"line":20,"column":1,"offset":1039},"end":{"line":20,"column":249,"offset":1287},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1039},"end":{"line":20,"column":249,"offset":1287},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Open Source (< 5 Kerberos agents)","position":{"start":{"line":22,"column":5,"offset":1293},"end":{"line":22,"column":47,"offset":1335},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1289},"end":{"line":22,"column":47,"offset":1335},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you have a limited number of surveillance cameras you would like to monitor, and don't have any high availability requirements, the Kerberos Open Source agent is a good choice. For example, you can install the Kerberos Open Source agent on a Raspberry Pi, by using ","position":{"start":{"line":24,"column":1,"offset":1337},"end":{"line":24,"column":269,"offset":1605},"indent":[]}},{"type":"link","title":null,"url":"opensource/installation#kios","children":[{"type":"text","value":"KiOS","position":{"start":{"line":24,"column":270,"offset":1606},"end":{"line":24,"column":274,"offset":1610},"indent":[]}}],"position":{"start":{"line":24,"column":269,"offset":1605},"end":{"line":24,"column":305,"offset":1641},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":24,"column":305,"offset":1641},"end":{"line":24,"column":307,"offset":1643},"indent":[]}},{"type":"link","title":null,"url":"opensource/installation#raspbian","children":[{"type":"text","value":"Raspbian OS","position":{"start":{"line":24,"column":308,"offset":1644},"end":{"line":24,"column":319,"offset":1655},"indent":[]}}],"position":{"start":{"line":24,"column":307,"offset":1643},"end":{"line":24,"column":354,"offset":1690},"indent":[]}},{"type":"text","value":" or compile it from source.","position":{"start":{"line":24,"column":354,"offset":1690},"end":{"line":24,"column":381,"offset":1717},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1337},"end":{"line":24,"column":381,"offset":1717},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On below architecture, a couple of Kerberos agents are installed on-premise (inside the local network). A Kerberos agent is installed for each surveillance camera, and each Kerberos agent runs on a seperate host (Raspberry Pi, VM, etc). The web interface of the Kerberos agents can be reached from the internal network, but cannot be accessed from the cloud.","position":{"start":{"line":26,"column":1,"offset":1719},"end":{"line":26,"column":359,"offset":2077},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1719},"end":{"line":26,"column":359,"offset":2077},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent-architecture-kios.png","alt":"architecture kios","position":{"start":{"line":28,"column":1,"offset":2079},"end":{"line":28,"column":76,"offset":2154},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":2079},"end":{"line":28,"column":76,"offset":2154},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Another option to install the Kerberos Open Source agent is to use Docker. Instead of having seperate hosts for each Kerberos agent, you will have a single host (Docker host) with multiple Docker containers. A Docker container is deployed for each surveillance camera, which contains the software to run the Kerberos agent.","position":{"start":{"line":30,"column":1,"offset":2156},"end":{"line":30,"column":324,"offset":2479},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2156},"end":{"line":30,"column":324,"offset":2479},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Running your Kerberos agents inside Docker containers, allows you to process multiple surveilllance cameras using only one host.","position":{"start":{"line":32,"column":1,"offset":2481},"end":{"line":32,"column":129,"offset":2609},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2481},"end":{"line":32,"column":129,"offset":2609},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent-architecture-docker.png","alt":"architecture kios","position":{"start":{"line":34,"column":1,"offset":2611},"end":{"line":34,"column":78,"offset":2688},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2611},"end":{"line":34,"column":78,"offset":2688},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Enterprise (> 5 Kerberos agents)","position":{"start":{"line":36,"column":5,"offset":2694},"end":{"line":36,"column":46,"offset":2735},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2690},"end":{"line":36,"column":46,"offset":2735},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When working within an enterprise context, where you require high availability and have a large amount of surveillance cameras being monitored, ","position":{"start":{"line":38,"column":1,"offset":2737},"end":{"line":38,"column":145,"offset":2881},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":38,"column":146,"offset":2882},"end":{"line":38,"column":165,"offset":2901},"indent":[]}}],"position":{"start":{"line":38,"column":145,"offset":2881},"end":{"line":38,"column":192,"offset":2928},"indent":[]}},{"type":"text","value":" is a good choice. Im comparison to the Open Source version, Kerberos Enterprise will use Kubernetes to help you scale (and secure) your security landscape. Kerberos agents, or Kubernetes deployments, are deployed inside your cluster and load balanced over the different nodes. When a Kerberos agent dies, or the node on which the deployment is running, Kubernetes will reschedule it to another healthy node.","position":{"start":{"line":38,"column":192,"offset":2928},"end":{"line":38,"column":600,"offset":3336},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2737},"end":{"line":38,"column":600,"offset":3336},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":40,"column":1,"offset":3338},"end":{"line":40,"column":88,"offset":3425},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":3338},"end":{"line":40,"column":88,"offset":3425},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Agents in the cloud","position":{"start":{"line":42,"column":4,"offset":3430},"end":{"line":42,"column":23,"offset":3449},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":3427},"end":{"line":42,"column":23,"offset":3449},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Instead of processing your surveillance cameras on-premise you could also process them in the cloud. There are a couple advantages, for example, you don't have to manage your owner hardware, you can simply spin up a VM on one of the hyperscalers.","position":{"start":{"line":44,"column":1,"offset":3451},"end":{"line":44,"column":247,"offset":3697},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":3451},"end":{"line":44,"column":247,"offset":3697},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When dealing with Kerberos agents in the cloud, the complexity starts with the security model. As your surveillance cameras are running somewhere on-premise, you will need to make them available to your Kerberos agents, which are running in the cloud. There are several ways to do that, such as port forwarding (not recommended) or setting up a site-to-site VPN (recommended).","position":{"start":{"line":46,"column":1,"offset":3699},"end":{"line":46,"column":377,"offset":4075},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":3699},"end":{"line":46,"column":377,"offset":4075},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When setting up a VPN connection you will expose your surveillance cameras to your Kerberos agents. Once you've configured the Kerberos agents, data will flow through this secure tunnel, from on-premise to your cloud enviroment.","position":{"start":{"line":48,"column":1,"offset":4077},"end":{"line":48,"column":229,"offset":4305},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":4077},"end":{"line":48,"column":229,"offset":4305},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Open Source (< 5 Kerberos agents)","position":{"start":{"line":50,"column":5,"offset":4311},"end":{"line":50,"column":47,"offset":4353},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":4307},"end":{"line":50,"column":47,"offset":4353},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you have a limited number of surveillance cameras you would like to monitor, and don't have any high availability requirements, the Kerberos Open Source agent is a good choice. You can install the Kerberos Open Source agent on Docker. Instead of having seperate VM's for each Kerberos agent, you will have a single VM (Docker host) with multiple Docker containers. A Docker container is deployed for each surveillance camera, which contains the software to run the Kerberos agent.","position":{"start":{"line":52,"column":1,"offset":4355},"end":{"line":52,"column":484,"offset":4838},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":4355},"end":{"line":52,"column":484,"offset":4838},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent-architecture-docker-cloud.png","alt":"architecture kios","position":{"start":{"line":54,"column":1,"offset":4840},"end":{"line":54,"column":84,"offset":4923},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":4840},"end":{"line":54,"column":84,"offset":4923},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Enterprise (> 5 Kerberos agents)","position":{"start":{"line":56,"column":5,"offset":4929},"end":{"line":56,"column":46,"offset":4970},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":4925},"end":{"line":56,"column":46,"offset":4970},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to ","position":{"start":{"line":58,"column":1,"offset":4972},"end":{"line":58,"column":12,"offset":4983},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":58,"column":13,"offset":4984},"end":{"line":58,"column":32,"offset":5003},"indent":[]}}],"position":{"start":{"line":58,"column":12,"offset":4983},"end":{"line":58,"column":59,"offset":5030},"indent":[]}},{"type":"text","value":" on-premise, you can run the a Kubernetes in the cloud. The exact same solution is available, only the way how you connect to your video surveillance cameras will be different, as they will probably live in a different network. To make this work you will need to setup a VPN tunnel (or whatever your security teams have defined as a back practice). When ","position":{"start":{"line":58,"column":59,"offset":5030},"end":{"line":58,"column":413,"offset":5384},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":58,"column":414,"offset":5385},"end":{"line":58,"column":433,"offset":5404},"indent":[]}}],"position":{"start":{"line":58,"column":413,"offset":5384},"end":{"line":58,"column":460,"offset":5431},"indent":[]}},{"type":"text","value":" is deployed to the cloud, it can be used any where. Public cloud (AWS, Google, Azure, etc) or private cloud. You can run it where you want.","position":{"start":{"line":58,"column":460,"offset":5431},"end":{"line":58,"column":600,"offset":5571},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":4972},"end":{"line":58,"column":600,"offset":5571},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":60,"column":1,"offset":5573},"end":{"line":60,"column":94,"offset":5666},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":5573},"end":{"line":60,"column":94,"offset":5666},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":62,"column":4,"offset":5671},"end":{"line":62,"column":18,"offset":5685},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":5668},"end":{"line":62,"column":18,"offset":5685},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've configured one of the previously mentioned architectures, you will have one or more Kerberos agents running, in the cloud or on-premise.","position":{"start":{"line":64,"column":1,"offset":5687},"end":{"line":64,"column":149,"offset":5835},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":5687},"end":{"line":64,"column":149,"offset":5835},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Kerberos Open Source agent comes with a web interface, which makes it possible to review the activity for that specific agent; they don't have a consolidated overview. This means that you will need to open multiple web interfaces, one for Kerberos agent. In contrary Kerberos Enterprise agents, don't come with a web interface, therefore the Kerberos Cloud (public or private edition) is recommended.","position":{"start":{"line":66,"column":1,"offset":5837},"end":{"line":66,"column":405,"offset":6241},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":5837},"end":{"line":66,"column":405,"offset":6241},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To simplify this process and resolve some other challenges, Kerberos Cloud was developed.","position":{"start":{"line":68,"column":1,"offset":6243},"end":{"line":68,"column":90,"offset":6332},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":6243},"end":{"line":68,"column":90,"offset":6332},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.kerberos.io","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":70,"column":4,"offset":6337},"end":{"line":70,"column":18,"offset":6351},"indent":[]}}],"position":{"start":{"line":70,"column":3,"offset":6336},"end":{"line":70,"column":46,"offset":6379},"indent":[]}},{"type":"text","value":" is a cloud solution which allows you to have a single overview of all the media recordings generated by your surveillance cameras. It's not a solution for processing your surveillance cameras in the cloud. For processing of your surveillance cameras, a Kerberos agent is used.","position":{"start":{"line":70,"column":46,"offset":6379},"end":{"line":70,"column":323,"offset":6656},"indent":[]}}],"position":{"start":{"line":70,"column":3,"offset":6336},"end":{"line":70,"column":323,"offset":6656},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":6334},"end":{"line":70,"column":323,"offset":6656},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A brief list of the key features of Kerberos Cloud are:","position":{"start":{"line":72,"column":1,"offset":6658},"end":{"line":72,"column":56,"offset":6713},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":6658},"end":{"line":72,"column":56,"offset":6713},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secured storage","position":{"start":{"line":74,"column":3,"offset":6717},"end":{"line":74,"column":18,"offset":6732},"indent":[]}}],"position":{"start":{"line":74,"column":3,"offset":6717},"end":{"line":74,"column":18,"offset":6732},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":6715},"end":{"line":74,"column":18,"offset":6732},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Consolidated overview","position":{"start":{"line":75,"column":3,"offset":6735},"end":{"line":75,"column":24,"offset":6756},"indent":[]}}],"position":{"start":{"line":75,"column":3,"offset":6735},"end":{"line":75,"column":24,"offset":6756},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":6733},"end":{"line":75,"column":24,"offset":6756},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Advanced searching","position":{"start":{"line":76,"column":3,"offset":6759},"end":{"line":76,"column":21,"offset":6777},"indent":[]}}],"position":{"start":{"line":76,"column":3,"offset":6759},"end":{"line":76,"column":21,"offset":6777},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":6757},"end":{"line":76,"column":21,"offset":6777},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Machine learning","position":{"start":{"line":77,"column":3,"offset":6780},"end":{"line":77,"column":19,"offset":6796},"indent":[]}}],"position":{"start":{"line":77,"column":3,"offset":6780},"end":{"line":77,"column":19,"offset":6796},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":6778},"end":{"line":77,"column":19,"offset":6796},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Alerts","position":{"start":{"line":78,"column":3,"offset":6799},"end":{"line":78,"column":9,"offset":6805},"indent":[]}}],"position":{"start":{"line":78,"column":3,"offset":6799},"end":{"line":78,"column":9,"offset":6805},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":6797},"end":{"line":78,"column":9,"offset":6805},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Live streaming","position":{"start":{"line":79,"column":3,"offset":6808},"end":{"line":79,"column":17,"offset":6822},"indent":[]}}],"position":{"start":{"line":79,"column":3,"offset":6808},"end":{"line":79,"column":17,"offset":6822},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":6806},"end":{"line":79,"column":17,"offset":6822},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Accounts","position":{"start":{"line":80,"column":3,"offset":6825},"end":{"line":80,"column":11,"offset":6833},"indent":[]}}],"position":{"start":{"line":80,"column":3,"offset":6825},"end":{"line":80,"column":11,"offset":6833},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":6823},"end":{"line":80,"column":11,"offset":6833},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Logging","position":{"start":{"line":81,"column":3,"offset":6836},"end":{"line":81,"column":10,"offset":6843},"indent":[]}}],"position":{"start":{"line":81,"column":3,"offset":6836},"end":{"line":81,"column":10,"offset":6843},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":6834},"end":{"line":81,"column":10,"offset":6843},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":6715},"end":{"line":81,"column":10,"offset":6843},"indent":[1,1,1,1,1,1,1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"Checkout ","position":{"start":{"line":83,"column":3,"offset":6847},"end":{"line":83,"column":12,"offset":6856},"indent":[]}},{"type":"link","title":null,"url":"https://app-demo.kerberos.io","children":[{"type":"text","value":"the demo environment","position":{"start":{"line":83,"column":13,"offset":6857},"end":{"line":83,"column":33,"offset":6877},"indent":[]}}],"position":{"start":{"line":83,"column":12,"offset":6856},"end":{"line":83,"column":64,"offset":6908},"indent":[]}},{"type":"text","value":" to see and feel the Kerberos Cloud solution yourself.","position":{"start":{"line":83,"column":64,"offset":6908},"end":{"line":83,"column":118,"offset":6962},"indent":[]}}],"position":{"start":{"line":83,"column":3,"offset":6847},"end":{"line":83,"column":118,"offset":6962},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":6845},"end":{"line":83,"column":118,"offset":6962},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Architecture","position":{"start":{"line":85,"column":5,"offset":6968},"end":{"line":85,"column":17,"offset":6980},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":6964},"end":{"line":85,"column":17,"offset":6980},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A simplified architecture is found below. In this architecture the Kerberos agents are installed on-premise (but this could also be in the cloud), next to the surveillance cameras. Once one of the agents recorded a footage it will send the recording to our ","position":{"start":{"line":87,"column":1,"offset":6982},"end":{"line":87,"column":258,"offset":7239},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":87,"column":259,"offset":7240},"end":{"line":87,"column":275,"offset":7256},"indent":[]}}],"position":{"start":{"line":87,"column":258,"offset":7239},"end":{"line":87,"column":299,"offset":7280},"indent":[]}},{"type":"text","value":" service, using the credentials you've defined inside the agent.","position":{"start":{"line":87,"column":299,"offset":7280},"end":{"line":87,"column":363,"offset":7344},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":6982},"end":{"line":87,"column":363,"offset":7344},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"As soon as the recording is succesfully received several engines will be executed, that will further process the recording and extract metadata from it (classification, origin of the surveillance camera, etc). A lot of processing is happening behind the scenes.","position":{"start":{"line":89,"column":1,"offset":7346},"end":{"line":89,"column":262,"offset":7607},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":7346},"end":{"line":89,"column":262,"offset":7607},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By using a browser you can navigate to Kerberos Cloud, and review all the recordings made by the Kerberos agents on-premise. On top of that you will receive more context about the recordings, get notifications, view a livestream and much more. Read more about ","position":{"start":{"line":91,"column":1,"offset":7609},"end":{"line":91,"column":261,"offset":7869},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud here","position":{"start":{"line":91,"column":262,"offset":7870},"end":{"line":91,"column":281,"offset":7889},"indent":[]}}],"position":{"start":{"line":91,"column":261,"offset":7869},"end":{"line":91,"column":290,"offset":7898},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":91,"column":290,"offset":7898},"end":{"line":91,"column":291,"offset":7899},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":7609},"end":{"line":91,"column":291,"offset":7899},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":93,"column":1,"offset":7901},"end":{"line":93,"column":53,"offset":7953},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":7901},"end":{"line":93,"column":53,"offset":7953},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":96,"column":1,"offset":7956},"end":{"line":96,"column":31,"offset":7986},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":96,"column":31,"offset":7986}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Architectures`}

\n

{`In this section we will explain some usecases and best practices, which might help you to define the architecture that fits your needs.`}

\n
\n

{`Please read the `}{`introduction page`}{` first, before moving forward.`}

\n
\n

{`When starting with Kerberos you might ask yourself, how should I deploy these so called, Kerberos agents? Well, there are different options. You can install a Kerberos agent on a Raspberry Pi, VM, Server or even in a Kubernetes cluster. So what should you do, and when? Let's have a closer look at the different options.`}

\n

{`The first thing you need to consider is the environment, in which you want to deploy your Kerberos agents. Is it inside your house, your company or at a public place? Another important factor is the number of surveillance cameras you would like to monitor, and if you have any high availability requirements.`}

\n

{`Agents on-premise`}

\n

{`The most common scenario is to install your Kerberos agents on-premise. This has a couple of benefits such as latency, bandwidth and a less complex security model. When installing a Kerberos agent on-premise, you have a couple of different options.`}

\n

{`Kerberos Open Source (< 5 Kerberos agents)`}

\n

{`If you have a limited number of surveillance cameras you would like to monitor, and don't have any high availability requirements, the Kerberos Open Source agent is a good choice. For example, you can install the Kerberos Open Source agent on a Raspberry Pi, by using `}{`KiOS`}{`, `}{`Raspbian OS`}{` or compile it from source.`}

\n

{`On below architecture, a couple of Kerberos agents are installed on-premise (inside the local network). A Kerberos agent is installed for each surveillance camera, and each Kerberos agent runs on a seperate host (Raspberry Pi, VM, etc). The web interface of the Kerberos agents can be reached from the internal network, but cannot be accessed from the cloud.`}

\n

\"architecture

\n

{`Another option to install the Kerberos Open Source agent is to use Docker. Instead of having seperate hosts for each Kerberos agent, you will have a single host (Docker host) with multiple Docker containers. A Docker container is deployed for each surveillance camera, which contains the software to run the Kerberos agent.`}

\n

{`Running your Kerberos agents inside Docker containers, allows you to process multiple surveilllance cameras using only one host.`}

\n

\"architecture

\n

{`Kerberos Enterprise (> 5 Kerberos agents)`}

\n

{`When working within an enterprise context, where you require high availability and have a large amount of surveillance cameras being monitored, `}{`Kerberos Enterprise`}{` is a good choice. Im comparison to the Open Source version, Kerberos Enterprise will use Kubernetes to help you scale (and secure) your security landscape. Kerberos agents, or Kubernetes deployments, are deployed inside your cluster and load balanced over the different nodes. When a Kerberos agent dies, or the node on which the deployment is running, Kubernetes will reschedule it to another healthy node.`}

\n

\"architecture

\n

{`Agents in the cloud`}

\n

{`Instead of processing your surveillance cameras on-premise you could also process them in the cloud. There are a couple advantages, for example, you don't have to manage your owner hardware, you can simply spin up a VM on one of the hyperscalers.`}

\n

{`When dealing with Kerberos agents in the cloud, the complexity starts with the security model. As your surveillance cameras are running somewhere on-premise, you will need to make them available to your Kerberos agents, which are running in the cloud. There are several ways to do that, such as port forwarding (not recommended) or setting up a site-to-site VPN (recommended).`}

\n

{`When setting up a VPN connection you will expose your surveillance cameras to your Kerberos agents. Once you've configured the Kerberos agents, data will flow through this secure tunnel, from on-premise to your cloud enviroment.`}

\n

{`Kerberos Open Source (< 5 Kerberos agents)`}

\n

{`If you have a limited number of surveillance cameras you would like to monitor, and don't have any high availability requirements, the Kerberos Open Source agent is a good choice. You can install the Kerberos Open Source agent on Docker. Instead of having seperate VM's for each Kerberos agent, you will have a single VM (Docker host) with multiple Docker containers. A Docker container is deployed for each surveillance camera, which contains the software to run the Kerberos agent.`}

\n

\"architecture

\n

{`Kerberos Enterprise (> 5 Kerberos agents)`}

\n

{`Similar to `}{`Kerberos Enterprise`}{` on-premise, you can run the a Kubernetes in the cloud. The exact same solution is available, only the way how you connect to your video surveillance cameras will be different, as they will probably live in a different network. To make this work you will need to setup a VPN tunnel (or whatever your security teams have defined as a back practice). When `}{`Kerberos Enterprise`}{` is deployed to the cloud, it can be used any where. Public cloud (AWS, Google, Azure, etc) or private cloud. You can run it where you want.`}

\n

\"architecture

\n

{`Kerberos Cloud`}

\n

{`Once you've configured one of the previously mentioned architectures, you will have one or more Kerberos agents running, in the cloud or on-premise.`}

\n

{`The Kerberos Open Source agent comes with a web interface, which makes it possible to review the activity for that specific agent; they don't have a consolidated overview. This means that you will need to open multiple web interfaces, one for Kerberos agent. In contrary Kerberos Enterprise agents, don't come with a web interface, therefore the Kerberos Cloud (public or private edition) is recommended.`}

\n

{`To simplify this process and resolve some other challenges, Kerberos Cloud was developed.`}

\n
\n

{`Kerberos Cloud`}{` is a cloud solution which allows you to have a single overview of all the media recordings generated by your surveillance cameras. It's not a solution for processing your surveillance cameras in the cloud. For processing of your surveillance cameras, a Kerberos agent is used.`}

\n
\n

{`A brief list of the key features of Kerberos Cloud are:`}

\n
    \n
  • {`Secured storage`}
    • \n
  • {`Consolidated overview`}
    • \n
  • {`Advanced searching`}
    • \n
  • {`Machine learning`}
    • \n
  • {`Alerts`}
    • \n
  • {`Live streaming`}
    • \n
  • {`Accounts`}
    • \n
  • {`Logging`}
    • \n
\n
\n

{`Checkout `}{`the demo environment`}{` to see and feel the Kerberos Cloud solution yourself.`}

\n
\n

{`Architecture`}

\n

{`A simplified architecture is found below. In this architecture the Kerberos agents are installed on-premise (but this could also be in the cloud), next to the surveillance cameras. Once one of the agents recorded a footage it will send the recording to our `}{`Kerberos Storage`}{` service, using the credentials you've defined inside the agent.`}

\n

{`As soon as the recording is succesfully received several engines will be executed, that will further process the recording and extract metadata from it (classification, origin of the surveillance camera, etc). A lot of processing is happening behind the scenes.`}

\n

{`By using a browser you can navigate to Kerberos Cloud, and review all the recordings made by the Kerberos agents on-premise. On top of that you will receive more context about the recordings, get notifications, view a livestream and much more. Read more about `}{`Kerberos Cloud here`}{`.`}

\n

\"cloud\"

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-350607a274468126def53aa9a4db77ef.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-350607a274468126def53aa9a4db77ef.json index 334317f..23d5b4f 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-350607a274468126def53aa9a4db77ef.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-350607a274468126def53aa9a4db77ef.json @@ -1 +1 @@ -{"expireTime":9007200861747673000,"key":"gatsby-plugin-mdx-entire-payload-4e7c12dcc5f6e9ce2fc43af2cd7aa140-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import SettingsIcon from '@material-ui/icons/Settings';","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":56,"offset":214},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Get Started","position":{"start":{"line":10,"column":3,"offset":218},"end":{"line":10,"column":14,"offset":229},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":216},"end":{"line":10,"column":14,"offset":229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.","position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known ","position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":169,"offset":679},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":14,"column":169,"offset":679},"end":{"line":14,"column":178,"offset":688},"indent":[]}},{"type":"text","value":" command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.","position":{"start":{"line":14,"column":178,"offset":688},"end":{"line":14,"column":314,"offset":824},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":314,"offset":824},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":16,"column":1,"offset":826},"end":{"line":18,"column":11,"offset":1028},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Login page","position":{"start":{"line":20,"column":4,"offset":1033},"end":{"line":20,"column":14,"offset":1043},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1030},"end":{"line":20,"column":14,"offset":1043},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.","position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/login.gif","alt":"Factory","position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The default username password of the Factory web applications is:","position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"username: ","position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":13,"offset":1310},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":28,"column":15,"offset":1312},"end":{"line":28,"column":19,"offset":1316},"indent":[]}}],"position":{"start":{"line":28,"column":13,"offset":1310},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":28,"column":21,"offset":1318},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"password: ","position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":13,"offset":1331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"kerberos","position":{"start":{"line":29,"column":15,"offset":1333},"end":{"line":29,"column":23,"offset":1341},"indent":[]}}],"position":{"start":{"line":29,"column":13,"offset":1331},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1319},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":29,"column":25,"offset":1343},"indent":[1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"The username and password ","position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":29,"offset":1373},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/enterprise/blob/master/yaml/factory/deployment.yaml#L54","children":[{"type":"text","value":"can be changed in the ","position":{"start":{"line":31,"column":30,"offset":1374},"end":{"line":31,"column":52,"offset":1396},"indent":[]}},{"type":"inlineCode","value":"deploment.yaml","position":{"start":{"line":31,"column":52,"offset":1396},"end":{"line":31,"column":68,"offset":1412},"indent":[]}},{"type":"text","value":" file","position":{"start":{"line":31,"column":68,"offset":1412},"end":{"line":31,"column":73,"offset":1417},"indent":[]}}],"position":{"start":{"line":31,"column":29,"offset":1373},"end":{"line":31,"column":162,"offset":1506},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":162,"offset":1506},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1345},"end":{"line":31,"column":163,"offset":1507},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Overview","position":{"start":{"line":33,"column":4,"offset":1512},"end":{"line":33,"column":12,"offset":1520},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1509},"end":{"line":33,"column":12,"offset":1520},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: ","position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":146,"offset":1667},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Docker","position":{"start":{"line":35,"column":148,"offset":1669},"end":{"line":35,"column":154,"offset":1675},"indent":[]}}],"position":{"start":{"line":35,"column":146,"offset":1667},"end":{"line":35,"column":156,"offset":1677},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":35,"column":156,"offset":1677},"end":{"line":35,"column":161,"offset":1682},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":35,"column":163,"offset":1684},"end":{"line":35,"column":173,"offset":1694},"indent":[]}}],"position":{"start":{"line":35,"column":161,"offset":1682},"end":{"line":35,"column":175,"offset":1696},"indent":[]}},{"type":"text","value":". Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.","position":{"start":{"line":35,"column":175,"offset":1696},"end":{"line":35,"column":317,"offset":1838},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":317,"offset":1838},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.","position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/docker-Kubernetes.gif","alt":"Factory","position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":41,"column":4,"offset":2094},"end":{"line":41,"column":14,"offset":2104},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2091},"end":{"line":41,"column":14,"offset":2104},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:","position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Nodes: a list of all the nodes in your cluster.","position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":45,"column":50,"offset":2255},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Deployments: a list of all the Kerberos Enterprise agents running in your cluster.","position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":2256},"end":{"line":46,"column":85,"offset":2340},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pods: all the pods running in your cluster.","position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2341},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":47,"column":46,"offset":2386},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Nodes","position":{"start":{"line":49,"column":4,"offset":2391},"end":{"line":49,"column":9,"offset":2396},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":2388},"end":{"line":49,"column":9,"offset":2396},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.","position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-nodes.png","alt":"Factory","position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Deployments","position":{"start":{"line":55,"column":4,"offset":2700},"end":{"line":55,"column":15,"offset":2711},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2697},"end":{"line":55,"column":15,"offset":2711},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.","position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-deployments.png","alt":"Factory","position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Adding a new deployment","position":{"start":{"line":61,"column":5,"offset":3201},"end":{"line":61,"column":28,"offset":3224},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3197},"end":{"line":61,"column":28,"offset":3224},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"There are two options to add a new deployment, single deployments and bulk deployment.","position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/single-bulk-deployment.gif","alt":"Factory","position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"single deployment","position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.","position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"in bulk deployment.","position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By importing an Excel file, deployments can be created in bulk.","position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.","position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-add-bulk-deployment-excel.png","alt":"Factory","position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Configuring a deployment","position":{"start":{"line":79,"column":5,"offset":3855},"end":{"line":79,"column":29,"offset":3879},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3851},"end":{"line":79,"column":29,"offset":3879},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the ","position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":200,"offset":4080},"indent":[]}},{"type":"jsx","value":"","position":{"start":{"line":81,"column":200,"offset":4080},"end":{"line":81,"column":235,"offset":4115},"indent":[]}},{"type":"text","value":" icon. This will open a popup, allowing you to change some settings.","position":{"start":{"line":81,"column":235,"offset":4115},"end":{"line":81,"column":303,"offset":4183},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":303,"offset":4183},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/deployment-configuration.gif","alt":"Factory","position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Following settings can be changed:","position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more regions of interest,","position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":87,"column":35,"offset":4325},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Time based conditions,","position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":4326},"end":{"line":88,"column":25,"offset":4350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pre- and postrecording","position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4351},"end":{"line":89,"column":25,"offset":4375},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording","position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4376},"end":{"line":90,"column":23,"offset":4398},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Linking to ","position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":14,"offset":4412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":91,"column":15,"offset":4413},"end":{"line":91,"column":29,"offset":4427},"indent":[]}}],"position":{"start":{"line":91,"column":14,"offset":4412},"end":{"line":91,"column":38,"offset":4436},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":91,"column":38,"offset":4436},"end":{"line":91,"column":42,"offset":4440},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":91,"column":43,"offset":4441},"end":{"line":91,"column":59,"offset":4457},"indent":[]}}],"position":{"start":{"line":91,"column":42,"offset":4440},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4399},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":91,"column":83,"offset":4481},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Global configuration","position":{"start":{"line":93,"column":5,"offset":4487},"end":{"line":93,"column":25,"offset":4507},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4483},"end":{"line":93,"column":25,"offset":4507},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.","position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.","position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/global-configuration.gif","alt":"Factory Global Config","position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Upgrade or reboot a Kerberos Enterprise agent","position":{"start":{"line":101,"column":5,"offset":5046},"end":{"line":101,"column":50,"offset":5091},"indent":[]}}],"position":{"start":{"line":101,"column":1,"offset":5042},"end":{"line":101,"column":50,"offset":5091},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, ","position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":373,"offset":5465},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"a zero downtime upgrade will take place","position":{"start":{"line":103,"column":375,"offset":5467},"end":{"line":103,"column":414,"offset":5506},"indent":[]}}],"position":{"start":{"line":103,"column":373,"offset":5465},"end":{"line":103,"column":416,"offset":5508},"indent":[]}},{"type":"text","value":". Kubernetes will download the new release, create a new pod, and destroy the old one.","position":{"start":{"line":103,"column":416,"offset":5508},"end":{"line":103,"column":502,"offset":5594},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":502,"offset":5594},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.","position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}}],"position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/upgrade-reboot.gif","alt":"Upgrade and reboot","position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}}],"position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Pods","position":{"start":{"line":110,"column":4,"offset":5965},"end":{"line":110,"column":8,"offset":5969},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":5962},"end":{"line":110,"column":8,"offset":5969},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.","position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-pods.png","alt":"Factory","position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage and video management","position":{"start":{"line":117,"column":4,"offset":6482},"end":{"line":117,"column":32,"offset":6510},"indent":[]}}],"position":{"start":{"line":117,"column":1,"offset":6479},"end":{"line":117,"column":32,"offset":6510},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).","position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also ","position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":169,"offset":7035},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":121,"column":171,"offset":7037},"end":{"line":121,"column":179,"offset":7045},"indent":[]}}],"position":{"start":{"line":121,"column":169,"offset":7035},"end":{"line":121,"column":181,"offset":7047},"indent":[]}},{"type":"text","value":" have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed ","position":{"start":{"line":121,"column":181,"offset":7047},"end":{"line":121,"column":419,"offset":7285},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":121,"column":420,"offset":7286},"end":{"line":121,"column":436,"offset":7302},"indent":[]}}],"position":{"start":{"line":121,"column":419,"offset":7285},"end":{"line":121,"column":460,"offset":7326},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":121,"column":460,"offset":7326},"end":{"line":121,"column":465,"offset":7331},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":121,"column":466,"offset":7332},"end":{"line":121,"column":480,"offset":7346},"indent":[]}}],"position":{"start":{"line":121,"column":465,"offset":7331},"end":{"line":121,"column":489,"offset":7355},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":121,"column":489,"offset":7355},"end":{"line":121,"column":490,"offset":7356},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":490,"offset":7356},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":123,"column":5,"offset":7362},"end":{"line":123,"column":21,"offset":7378},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":7358},"end":{"line":123,"column":21,"offset":7378},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":125,"column":2,"offset":7381},"end":{"line":125,"column":18,"offset":7397},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":42,"offset":7421},"indent":[]}},{"type":"text","value":" is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).","position":{"start":{"line":125,"column":42,"offset":7421},"end":{"line":125,"column":328,"offset":7707},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":328,"offset":7707},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).","position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}}],"position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the ","position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":147,"offset":8189},"indent":[]}},{"type":"inlineCode","value":"cloud","position":{"start":{"line":131,"column":147,"offset":8189},"end":{"line":131,"column":154,"offset":8196},"indent":[]}},{"type":"text","value":" tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.","position":{"start":{"line":131,"column":154,"offset":8196},"end":{"line":131,"column":245,"offset":8287},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":245,"offset":8287},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-enterprise-storage-setup.gif","alt":"kerberos storage configuration","position":{"start":{"line":134,"column":1,"offset":8290},"end":{"line":134,"column":101,"offset":8390},"indent":[]}}],"position":{"start":{"line":134,"column":1,"offset":8290},"end":{"line":134,"column":101,"offset":8390},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":136,"column":5,"offset":8396},"end":{"line":136,"column":19,"offset":8410},"indent":[]}}],"position":{"start":{"line":136,"column":1,"offset":8392},"end":{"line":136,"column":19,"offset":8410},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more ","position":{"start":{"line":138,"column":1,"offset":8412},"end":{"line":138,"column":219,"offset":8630},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"about the features and functions here","position":{"start":{"line":138,"column":220,"offset":8631},"end":{"line":138,"column":257,"offset":8668},"indent":[]}}],"position":{"start":{"line":138,"column":219,"offset":8630},"end":{"line":138,"column":266,"offset":8677},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":138,"column":266,"offset":8677},"end":{"line":138,"column":267,"offset":8678},"indent":[]}}],"position":{"start":{"line":138,"column":1,"offset":8412},"end":{"line":138,"column":267,"offset":8678},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the ","position":{"start":{"line":140,"column":1,"offset":8680},"end":{"line":140,"column":285,"offset":8964},"indent":[]}},{"type":"link","title":null,"url":"/storage/get-started","children":[{"type":"text","value":"Kerberos Storage page","position":{"start":{"line":140,"column":286,"offset":8965},"end":{"line":140,"column":307,"offset":8986},"indent":[]}}],"position":{"start":{"line":140,"column":285,"offset":8964},"end":{"line":140,"column":330,"offset":9009},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":140,"column":330,"offset":9009},"end":{"line":140,"column":331,"offset":9010},"indent":[]}}],"position":{"start":{"line":140,"column":1,"offset":8680},"end":{"line":140,"column":331,"offset":9010},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.","position":{"start":{"line":142,"column":1,"offset":9012},"end":{"line":142,"column":104,"offset":9115},"indent":[]}}],"position":{"start":{"line":142,"column":1,"offset":9012},"end":{"line":142,"column":104,"offset":9115},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":145,"column":1,"offset":9118},"end":{"line":145,"column":31,"offset":9148},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":145,"column":31,"offset":9148}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport SettingsIcon from '@material-ui/icons/Settings';\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Get Started`}

\n

{`Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.`}

\n

{`Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known `}{`kubectl`}{` command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.`}

\n
\n
\n

\n

{`Login page`}

\n

{`Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.`}

\n

\"Factory\"

\n

{`The default username password of the Factory web applications is:`}

\n
    \n
  • {`username: `}{`root`}
    • \n
  • {`password: `}{`kerberos`}
    • \n
\n
\n

{`The username and password `}{`can be changed in the `}{`deploment.yaml`}{` file`}{`.`}

\n
\n

{`Overview`}

\n

{`On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: `}{`Docker`}{` and `}{`Kubernetes`}{`. Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.`}

\n

{`When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.`}

\n

\"Factory\"

\n

{`Kubernetes`}

\n

{`On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:`}

\n
    \n
  • {`Nodes: a list of all the nodes in your cluster.`}
    • \n
  • {`Deployments: a list of all the Kerberos Enterprise agents running in your cluster.`}
    • \n
  • {`Pods: all the pods running in your cluster.`}
    • \n
\n

{`Nodes`}

\n

{`The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.`}

\n

\"Factory\"

\n

{`Deployments`}

\n

{`The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.`}

\n

\"Factory\"

\n

{`Adding a new deployment`}

\n

{`There are two options to add a new deployment, single deployments and bulk deployment.`}

\n

\"Factory\"

\n
    \n
  • {`single deployment`}
    • \n
\n

{`By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.`}

\n
    \n
  • {`in bulk deployment.`}
    • \n
\n

{`By importing an Excel file, deployments can be created in bulk.`}

\n

{`By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.`}

\n

\"Factory\"

\n

{`Configuring a deployment`}

\n

{`Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the `}{` icon. This will open a popup, allowing you to change some settings.`}

\n

\"Factory\"

\n

{`Following settings can be changed:`}

\n
    \n
  • {`One or more regions of interest,`}
    • \n
  • {`Time based conditions,`}
    • \n
  • {`Pre- and postrecording`}
    • \n
  • {`Continious recording`}
    • \n
  • {`Linking to `}{`Kerberos Cloud`}{` or `}{`Kerberos Storage`}
    • \n
\n

{`Global configuration`}

\n

{`Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.`}

\n

{`By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.`}

\n

\"Factory

\n

{`Upgrade or reboot a Kerberos Enterprise agent`}

\n

{`At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, `}{`a zero downtime upgrade will take place`}{`. Kubernetes will download the new release, create a new pod, and destroy the old one.`}

\n

{`At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.`}

\n

\"Upgrade

\n

{`Pods`}

\n

{`When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.`}

\n

\"Factory\"

\n

{`Storage and video management`}

\n

{`Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).`}

\n

{`Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also `}{`does not`}{` have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed `}{`Kerberos Storage`}{` and `}{`Kerberos Cloud`}{`.`}

\n

{`Kerberos Storage`}

\n

{`Kerberos Storage`}{` is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).`}

\n

{`On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).`}

\n

\"architecture

\n

{`To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the `}{`cloud`}{` tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.`}

\n

\"kerberos

\n

{`Kerberos Cloud`}

\n

{`For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more `}{`about the features and functions here`}{`.`}

\n

{`You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the `}{`Kerberos Storage page`}{`.`}

\n

{`Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750177000,"key":"gatsby-plugin-mdx-entire-payload-4e7c12dcc5f6e9ce2fc43af2cd7aa140-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import SettingsIcon from '@material-ui/icons/Settings';","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":56,"offset":214},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Get Started","position":{"start":{"line":10,"column":3,"offset":218},"end":{"line":10,"column":14,"offset":229},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":216},"end":{"line":10,"column":14,"offset":229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.","position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known ","position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":169,"offset":679},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":14,"column":169,"offset":679},"end":{"line":14,"column":178,"offset":688},"indent":[]}},{"type":"text","value":" command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.","position":{"start":{"line":14,"column":178,"offset":688},"end":{"line":14,"column":314,"offset":824},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":314,"offset":824},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":16,"column":1,"offset":826},"end":{"line":18,"column":11,"offset":1028},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Login page","position":{"start":{"line":20,"column":4,"offset":1033},"end":{"line":20,"column":14,"offset":1043},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1030},"end":{"line":20,"column":14,"offset":1043},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.","position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/login.gif","alt":"Factory","position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The default username password of the Factory web applications is:","position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"username: ","position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":13,"offset":1310},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":28,"column":15,"offset":1312},"end":{"line":28,"column":19,"offset":1316},"indent":[]}}],"position":{"start":{"line":28,"column":13,"offset":1310},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":28,"column":21,"offset":1318},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"password: ","position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":13,"offset":1331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"kerberos","position":{"start":{"line":29,"column":15,"offset":1333},"end":{"line":29,"column":23,"offset":1341},"indent":[]}}],"position":{"start":{"line":29,"column":13,"offset":1331},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1319},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":29,"column":25,"offset":1343},"indent":[1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"The username and password ","position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":29,"offset":1373},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/enterprise/blob/master/yaml/factory/deployment.yaml#L54","children":[{"type":"text","value":"can be changed in the ","position":{"start":{"line":31,"column":30,"offset":1374},"end":{"line":31,"column":52,"offset":1396},"indent":[]}},{"type":"inlineCode","value":"deploment.yaml","position":{"start":{"line":31,"column":52,"offset":1396},"end":{"line":31,"column":68,"offset":1412},"indent":[]}},{"type":"text","value":" file","position":{"start":{"line":31,"column":68,"offset":1412},"end":{"line":31,"column":73,"offset":1417},"indent":[]}}],"position":{"start":{"line":31,"column":29,"offset":1373},"end":{"line":31,"column":162,"offset":1506},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":162,"offset":1506},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1345},"end":{"line":31,"column":163,"offset":1507},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Overview","position":{"start":{"line":33,"column":4,"offset":1512},"end":{"line":33,"column":12,"offset":1520},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1509},"end":{"line":33,"column":12,"offset":1520},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: ","position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":146,"offset":1667},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Docker","position":{"start":{"line":35,"column":148,"offset":1669},"end":{"line":35,"column":154,"offset":1675},"indent":[]}}],"position":{"start":{"line":35,"column":146,"offset":1667},"end":{"line":35,"column":156,"offset":1677},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":35,"column":156,"offset":1677},"end":{"line":35,"column":161,"offset":1682},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":35,"column":163,"offset":1684},"end":{"line":35,"column":173,"offset":1694},"indent":[]}}],"position":{"start":{"line":35,"column":161,"offset":1682},"end":{"line":35,"column":175,"offset":1696},"indent":[]}},{"type":"text","value":". Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.","position":{"start":{"line":35,"column":175,"offset":1696},"end":{"line":35,"column":317,"offset":1838},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":317,"offset":1838},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.","position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/docker-Kubernetes.gif","alt":"Factory","position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":41,"column":4,"offset":2094},"end":{"line":41,"column":14,"offset":2104},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2091},"end":{"line":41,"column":14,"offset":2104},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:","position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Nodes: a list of all the nodes in your cluster.","position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":45,"column":50,"offset":2255},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Deployments: a list of all the Kerberos Enterprise agents running in your cluster.","position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":2256},"end":{"line":46,"column":85,"offset":2340},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pods: all the pods running in your cluster.","position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2341},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":47,"column":46,"offset":2386},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Nodes","position":{"start":{"line":49,"column":4,"offset":2391},"end":{"line":49,"column":9,"offset":2396},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":2388},"end":{"line":49,"column":9,"offset":2396},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.","position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-nodes.png","alt":"Factory","position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Deployments","position":{"start":{"line":55,"column":4,"offset":2700},"end":{"line":55,"column":15,"offset":2711},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2697},"end":{"line":55,"column":15,"offset":2711},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.","position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-deployments.png","alt":"Factory","position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Adding a new deployment","position":{"start":{"line":61,"column":5,"offset":3201},"end":{"line":61,"column":28,"offset":3224},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3197},"end":{"line":61,"column":28,"offset":3224},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"There are two options to add a new deployment, single deployments and bulk deployment.","position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/single-bulk-deployment.gif","alt":"Factory","position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"single deployment","position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.","position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"in bulk deployment.","position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By importing an Excel file, deployments can be created in bulk.","position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.","position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-add-bulk-deployment-excel.png","alt":"Factory","position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Configuring a deployment","position":{"start":{"line":79,"column":5,"offset":3855},"end":{"line":79,"column":29,"offset":3879},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3851},"end":{"line":79,"column":29,"offset":3879},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the ","position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":200,"offset":4080},"indent":[]}},{"type":"jsx","value":"","position":{"start":{"line":81,"column":200,"offset":4080},"end":{"line":81,"column":235,"offset":4115},"indent":[]}},{"type":"text","value":" icon. This will open a popup, allowing you to change some settings.","position":{"start":{"line":81,"column":235,"offset":4115},"end":{"line":81,"column":303,"offset":4183},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":303,"offset":4183},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/deployment-configuration.gif","alt":"Factory","position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Following settings can be changed:","position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more regions of interest,","position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":87,"column":35,"offset":4325},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Time based conditions,","position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":4326},"end":{"line":88,"column":25,"offset":4350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pre- and postrecording","position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4351},"end":{"line":89,"column":25,"offset":4375},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording","position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4376},"end":{"line":90,"column":23,"offset":4398},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Linking to ","position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":14,"offset":4412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":91,"column":15,"offset":4413},"end":{"line":91,"column":29,"offset":4427},"indent":[]}}],"position":{"start":{"line":91,"column":14,"offset":4412},"end":{"line":91,"column":38,"offset":4436},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":91,"column":38,"offset":4436},"end":{"line":91,"column":42,"offset":4440},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":91,"column":43,"offset":4441},"end":{"line":91,"column":59,"offset":4457},"indent":[]}}],"position":{"start":{"line":91,"column":42,"offset":4440},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4399},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":91,"column":83,"offset":4481},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Global configuration","position":{"start":{"line":93,"column":5,"offset":4487},"end":{"line":93,"column":25,"offset":4507},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4483},"end":{"line":93,"column":25,"offset":4507},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.","position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.","position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/global-configuration.gif","alt":"Factory Global Config","position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Upgrade or reboot a Kerberos Enterprise agent","position":{"start":{"line":101,"column":5,"offset":5046},"end":{"line":101,"column":50,"offset":5091},"indent":[]}}],"position":{"start":{"line":101,"column":1,"offset":5042},"end":{"line":101,"column":50,"offset":5091},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, ","position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":373,"offset":5465},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"a zero downtime upgrade will take place","position":{"start":{"line":103,"column":375,"offset":5467},"end":{"line":103,"column":414,"offset":5506},"indent":[]}}],"position":{"start":{"line":103,"column":373,"offset":5465},"end":{"line":103,"column":416,"offset":5508},"indent":[]}},{"type":"text","value":". Kubernetes will download the new release, create a new pod, and destroy the old one.","position":{"start":{"line":103,"column":416,"offset":5508},"end":{"line":103,"column":502,"offset":5594},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":502,"offset":5594},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.","position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}}],"position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/upgrade-reboot.gif","alt":"Upgrade and reboot","position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}}],"position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Pods","position":{"start":{"line":110,"column":4,"offset":5965},"end":{"line":110,"column":8,"offset":5969},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":5962},"end":{"line":110,"column":8,"offset":5969},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.","position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-pods.png","alt":"Factory","position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage and video management","position":{"start":{"line":117,"column":4,"offset":6482},"end":{"line":117,"column":32,"offset":6510},"indent":[]}}],"position":{"start":{"line":117,"column":1,"offset":6479},"end":{"line":117,"column":32,"offset":6510},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).","position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also ","position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":169,"offset":7035},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":121,"column":171,"offset":7037},"end":{"line":121,"column":179,"offset":7045},"indent":[]}}],"position":{"start":{"line":121,"column":169,"offset":7035},"end":{"line":121,"column":181,"offset":7047},"indent":[]}},{"type":"text","value":" have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed ","position":{"start":{"line":121,"column":181,"offset":7047},"end":{"line":121,"column":419,"offset":7285},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":121,"column":420,"offset":7286},"end":{"line":121,"column":436,"offset":7302},"indent":[]}}],"position":{"start":{"line":121,"column":419,"offset":7285},"end":{"line":121,"column":460,"offset":7326},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":121,"column":460,"offset":7326},"end":{"line":121,"column":465,"offset":7331},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":121,"column":466,"offset":7332},"end":{"line":121,"column":480,"offset":7346},"indent":[]}}],"position":{"start":{"line":121,"column":465,"offset":7331},"end":{"line":121,"column":489,"offset":7355},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":121,"column":489,"offset":7355},"end":{"line":121,"column":490,"offset":7356},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":490,"offset":7356},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":123,"column":5,"offset":7362},"end":{"line":123,"column":21,"offset":7378},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":7358},"end":{"line":123,"column":21,"offset":7378},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":125,"column":2,"offset":7381},"end":{"line":125,"column":18,"offset":7397},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":42,"offset":7421},"indent":[]}},{"type":"text","value":" is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).","position":{"start":{"line":125,"column":42,"offset":7421},"end":{"line":125,"column":328,"offset":7707},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":328,"offset":7707},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).","position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}}],"position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the ","position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":147,"offset":8189},"indent":[]}},{"type":"inlineCode","value":"cloud","position":{"start":{"line":131,"column":147,"offset":8189},"end":{"line":131,"column":154,"offset":8196},"indent":[]}},{"type":"text","value":" tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.","position":{"start":{"line":131,"column":154,"offset":8196},"end":{"line":131,"column":245,"offset":8287},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":245,"offset":8287},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-enterprise-storage-setup.gif","alt":"kerberos storage configuration","position":{"start":{"line":134,"column":1,"offset":8290},"end":{"line":134,"column":101,"offset":8390},"indent":[]}}],"position":{"start":{"line":134,"column":1,"offset":8290},"end":{"line":134,"column":101,"offset":8390},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":136,"column":5,"offset":8396},"end":{"line":136,"column":19,"offset":8410},"indent":[]}}],"position":{"start":{"line":136,"column":1,"offset":8392},"end":{"line":136,"column":19,"offset":8410},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more ","position":{"start":{"line":138,"column":1,"offset":8412},"end":{"line":138,"column":219,"offset":8630},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"about the features and functions here","position":{"start":{"line":138,"column":220,"offset":8631},"end":{"line":138,"column":257,"offset":8668},"indent":[]}}],"position":{"start":{"line":138,"column":219,"offset":8630},"end":{"line":138,"column":266,"offset":8677},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":138,"column":266,"offset":8677},"end":{"line":138,"column":267,"offset":8678},"indent":[]}}],"position":{"start":{"line":138,"column":1,"offset":8412},"end":{"line":138,"column":267,"offset":8678},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the ","position":{"start":{"line":140,"column":1,"offset":8680},"end":{"line":140,"column":285,"offset":8964},"indent":[]}},{"type":"link","title":null,"url":"/storage/get-started","children":[{"type":"text","value":"Kerberos Storage page","position":{"start":{"line":140,"column":286,"offset":8965},"end":{"line":140,"column":307,"offset":8986},"indent":[]}}],"position":{"start":{"line":140,"column":285,"offset":8964},"end":{"line":140,"column":330,"offset":9009},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":140,"column":330,"offset":9009},"end":{"line":140,"column":331,"offset":9010},"indent":[]}}],"position":{"start":{"line":140,"column":1,"offset":8680},"end":{"line":140,"column":331,"offset":9010},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.","position":{"start":{"line":142,"column":1,"offset":9012},"end":{"line":142,"column":104,"offset":9115},"indent":[]}}],"position":{"start":{"line":142,"column":1,"offset":9012},"end":{"line":142,"column":104,"offset":9115},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":145,"column":1,"offset":9118},"end":{"line":145,"column":31,"offset":9148},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":145,"column":31,"offset":9148}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport SettingsIcon from '@material-ui/icons/Settings';\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Get Started`}

\n

{`Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.`}

\n

{`Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known `}{`kubectl`}{` command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.`}

\n
\n
\n

\n

{`Login page`}

\n

{`Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.`}

\n

\"Factory\"

\n

{`The default username password of the Factory web applications is:`}

\n
    \n
  • {`username: `}{`root`}
    • \n
  • {`password: `}{`kerberos`}
    • \n
\n
\n

{`The username and password `}{`can be changed in the `}{`deploment.yaml`}{` file`}{`.`}

\n
\n

{`Overview`}

\n

{`On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: `}{`Docker`}{` and `}{`Kubernetes`}{`. Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.`}

\n

{`When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.`}

\n

\"Factory\"

\n

{`Kubernetes`}

\n

{`On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:`}

\n
    \n
  • {`Nodes: a list of all the nodes in your cluster.`}
    • \n
  • {`Deployments: a list of all the Kerberos Enterprise agents running in your cluster.`}
    • \n
  • {`Pods: all the pods running in your cluster.`}
    • \n
\n

{`Nodes`}

\n

{`The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.`}

\n

\"Factory\"

\n

{`Deployments`}

\n

{`The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.`}

\n

\"Factory\"

\n

{`Adding a new deployment`}

\n

{`There are two options to add a new deployment, single deployments and bulk deployment.`}

\n

\"Factory\"

\n
    \n
  • {`single deployment`}
    • \n
\n

{`By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.`}

\n
    \n
  • {`in bulk deployment.`}
    • \n
\n

{`By importing an Excel file, deployments can be created in bulk.`}

\n

{`By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.`}

\n

\"Factory\"

\n

{`Configuring a deployment`}

\n

{`Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the `}{` icon. This will open a popup, allowing you to change some settings.`}

\n

\"Factory\"

\n

{`Following settings can be changed:`}

\n
    \n
  • {`One or more regions of interest,`}
    • \n
  • {`Time based conditions,`}
    • \n
  • {`Pre- and postrecording`}
    • \n
  • {`Continious recording`}
    • \n
  • {`Linking to `}{`Kerberos Cloud`}{` or `}{`Kerberos Storage`}
    • \n
\n

{`Global configuration`}

\n

{`Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.`}

\n

{`By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.`}

\n

\"Factory

\n

{`Upgrade or reboot a Kerberos Enterprise agent`}

\n

{`At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, `}{`a zero downtime upgrade will take place`}{`. Kubernetes will download the new release, create a new pod, and destroy the old one.`}

\n

{`At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.`}

\n

\"Upgrade

\n

{`Pods`}

\n

{`When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.`}

\n

\"Factory\"

\n

{`Storage and video management`}

\n

{`Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).`}

\n

{`Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also `}{`does not`}{` have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed `}{`Kerberos Storage`}{` and `}{`Kerberos Cloud`}{`.`}

\n

{`Kerberos Storage`}

\n

{`Kerberos Storage`}{` is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).`}

\n

{`On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).`}

\n

\"architecture

\n

{`To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the `}{`cloud`}{` tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.`}

\n

\"kerberos

\n

{`Kerberos Cloud`}

\n

{`For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more `}{`about the features and functions here`}{`.`}

\n

{`You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the `}{`Kerberos Storage page`}{`.`}

\n

{`Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-390c49abb652dc1d2fbce6848089e625.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-390c49abb652dc1d2fbce6848089e625.json index 9b8628d..16d8853 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-390c49abb652dc1d2fbce6848089e625.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-390c49abb652dc1d2fbce6848089e625.json @@ -1 +1 @@ -{"expireTime":9007200861747673000,"key":"gatsby-plugin-mdx-entire-payload-6b3b0bb987de28787ec211d312f8356b-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Release notes","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":16,"offset":174},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":16,"offset":174},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.8.0","position":{"start":{"line":10,"column":5,"offset":180},"end":{"line":10,"column":10,"offset":185},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":176},"end":{"line":10,"column":10,"offset":185},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Aligned machinery, web and KiOS versions. Too many people were confused by the versioning.","position":{"start":{"line":12,"column":1,"offset":187},"end":{"line":12,"column":91,"offset":277},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":187},"end":{"line":12,"column":91,"offset":277},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":14,"column":6,"offset":284},"end":{"line":14,"column":9,"offset":287},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":279},"end":{"line":14,"column":9,"offset":287},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Videos displayed on canvas were blocked in latest browsers.","position":{"start":{"line":16,"column":3,"offset":291},"end":{"line":16,"column":62,"offset":350},"indent":[]}}],"position":{"start":{"line":16,"column":3,"offset":291},"end":{"line":16,"column":62,"offset":350},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":289},"end":{"line":16,"column":62,"offset":350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Disabled reboot and shutdown.","position":{"start":{"line":17,"column":3,"offset":353},"end":{"line":17,"column":32,"offset":382},"indent":[]}}],"position":{"start":{"line":17,"column":3,"offset":353},"end":{"line":17,"column":32,"offset":382},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":351},"end":{"line":17,"column":32,"offset":382},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Disabled upgrade process, use fwupdate shell command instead.","position":{"start":{"line":18,"column":3,"offset":385},"end":{"line":18,"column":64,"offset":446},"indent":[]}}],"position":{"start":{"line":18,"column":3,"offset":385},"end":{"line":18,"column":64,"offset":446},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":383},"end":{"line":18,"column":64,"offset":446},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":289},"end":{"line":18,"column":64,"offset":446},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"KiOS","position":{"start":{"line":20,"column":6,"offset":453},"end":{"line":20,"column":10,"offset":457},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":448},"end":{"line":20,"column":10,"offset":457},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Major upgrade, solved many different problems (list to long); not possible to upgrade from 2.7.0 to 2.8.0.","position":{"start":{"line":22,"column":3,"offset":461},"end":{"line":22,"column":109,"offset":567},"indent":[]}}],"position":{"start":{"line":22,"column":3,"offset":461},"end":{"line":22,"column":109,"offset":567},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":459},"end":{"line":22,"column":109,"offset":567},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Updated firmware to latest Raspbian (raspberrypi-kernel_1.20180417-1).","position":{"start":{"line":23,"column":3,"offset":570},"end":{"line":23,"column":73,"offset":640},"indent":[]}}],"position":{"start":{"line":23,"column":3,"offset":570},"end":{"line":23,"column":73,"offset":640},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":568},"end":{"line":23,"column":73,"offset":640},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support for the Raspberry Pi 4.","position":{"start":{"line":24,"column":3,"offset":643},"end":{"line":24,"column":34,"offset":674},"indent":[]}}],"position":{"start":{"line":24,"column":3,"offset":643},"end":{"line":24,"column":34,"offset":674},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":641},"end":{"line":24,"column":34,"offset":674},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":459},"end":{"line":24,"column":34,"offset":674},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.7.2","position":{"start":{"line":26,"column":5,"offset":680},"end":{"line":26,"column":10,"offset":685},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":676},"end":{"line":26,"column":10,"offset":685},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":28,"column":6,"offset":692},"end":{"line":28,"column":15,"offset":701},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":687},"end":{"line":28,"column":15,"offset":701},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"To optimise the cloud experience we've added a proxy.kerberos.io machine in between.","position":{"start":{"line":30,"column":3,"offset":705},"end":{"line":30,"column":87,"offset":789},"indent":[]}}],"position":{"start":{"line":30,"column":3,"offset":705},"end":{"line":30,"column":87,"offset":789},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":703},"end":{"line":30,"column":87,"offset":789},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"We've changed the S3 storage scheme (class:ONEZONE_IA).","position":{"start":{"line":31,"column":3,"offset":792},"end":{"line":31,"column":58,"offset":847},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":792},"end":{"line":31,"column":58,"offset":847},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":790},"end":{"line":31,"column":58,"offset":847},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":703},"end":{"line":31,"column":58,"offset":847},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.7.1","position":{"start":{"line":33,"column":5,"offset":853},"end":{"line":33,"column":10,"offset":858},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":849},"end":{"line":33,"column":10,"offset":858},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":35,"column":6,"offset":865},"end":{"line":35,"column":15,"offset":874},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":860},"end":{"line":35,"column":15,"offset":874},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Resolved deadlock with livestreaming while restarting machinery.","position":{"start":{"line":37,"column":3,"offset":878},"end":{"line":37,"column":67,"offset":942},"indent":[]}}],"position":{"start":{"line":37,"column":3,"offset":878},"end":{"line":37,"column":67,"offset":942},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":876},"end":{"line":37,"column":67,"offset":942},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Revert logging library; enabled log rotating.","position":{"start":{"line":38,"column":3,"offset":945},"end":{"line":38,"column":48,"offset":990},"indent":[]}}],"position":{"start":{"line":38,"column":3,"offset":945},"end":{"line":38,"column":48,"offset":990},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":943},"end":{"line":38,"column":48,"offset":990},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":876},"end":{"line":38,"column":48,"offset":990},"indent":[1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"KiOS","position":{"start":{"line":40,"column":6,"offset":997},"end":{"line":40,"column":10,"offset":1001},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":992},"end":{"line":40,"column":10,"offset":1001},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Updated firmware to latest Raspbian (raspberrypi-kernel_1.20180417-1).","position":{"start":{"line":42,"column":3,"offset":1005},"end":{"line":42,"column":73,"offset":1075},"indent":[]}}],"position":{"start":{"line":42,"column":3,"offset":1005},"end":{"line":42,"column":73,"offset":1075},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":1003},"end":{"line":42,"column":73,"offset":1075},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Resolved issue with WIFI on Raspberry Pi 3B+","position":{"start":{"line":43,"column":3,"offset":1078},"end":{"line":43,"column":47,"offset":1122},"indent":[]}}],"position":{"start":{"line":43,"column":3,"offset":1078},"end":{"line":43,"column":47,"offset":1122},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":1076},"end":{"line":43,"column":47,"offset":1122},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":1003},"end":{"line":43,"column":47,"offset":1122},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.7.0","position":{"start":{"line":45,"column":5,"offset":1128},"end":{"line":45,"column":10,"offset":1133},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":1124},"end":{"line":45,"column":10,"offset":1133},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":47,"column":6,"offset":1140},"end":{"line":47,"column":9,"offset":1143},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":1135},"end":{"line":47,"column":9,"offset":1143},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Unique session cookie, which allows to open multiple web interfaces (e.g. when using docker).","position":{"start":{"line":49,"column":3,"offset":1147},"end":{"line":49,"column":96,"offset":1240},"indent":[]}}],"position":{"start":{"line":49,"column":3,"offset":1147},"end":{"line":49,"column":96,"offset":1240},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":1145},"end":{"line":49,"column":96,"offset":1240},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":1145},"end":{"line":49,"column":96,"offset":1240},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":51,"column":6,"offset":1247},"end":{"line":51,"column":15,"offset":1256},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":1242},"end":{"line":51,"column":15,"offset":1256},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added live streaming feature for app.kerberos.io","position":{"start":{"line":53,"column":3,"offset":1260},"end":{"line":53,"column":51,"offset":1308},"indent":[]}}],"position":{"start":{"line":53,"column":3,"offset":1260},"end":{"line":53,"column":51,"offset":1308},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":1258},"end":{"line":53,"column":51,"offset":1308},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Upgraded logging library: log file can be max 5MB, and will rotate.","position":{"start":{"line":54,"column":3,"offset":1311},"end":{"line":54,"column":70,"offset":1378},"indent":[]}}],"position":{"start":{"line":54,"column":3,"offset":1311},"end":{"line":54,"column":70,"offset":1378},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":1309},"end":{"line":54,"column":70,"offset":1378},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Better logging for cloud uploads (failed information).","position":{"start":{"line":55,"column":3,"offset":1381},"end":{"line":55,"column":57,"offset":1435},"indent":[]}}],"position":{"start":{"line":55,"column":3,"offset":1381},"end":{"line":55,"column":57,"offset":1435},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":1379},"end":{"line":55,"column":57,"offset":1435},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":1258},"end":{"line":55,"column":57,"offset":1435},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Docker","position":{"start":{"line":57,"column":6,"offset":1442},"end":{"line":57,"column":12,"offset":1448},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":1437},"end":{"line":57,"column":12,"offset":1448},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"No longer need docker-compose, we merged the web and machinery containers to ","position":{"start":{"line":59,"column":3,"offset":1452},"end":{"line":59,"column":80,"offset":1529},"indent":[]}},{"type":"link","title":null,"url":"http://hub.docker.com/r/kerberos/kerberos","children":[{"type":"text","value":"a single container","position":{"start":{"line":59,"column":81,"offset":1530},"end":{"line":59,"column":99,"offset":1548},"indent":[]}}],"position":{"start":{"line":59,"column":80,"offset":1529},"end":{"line":59,"column":143,"offset":1592},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":59,"column":143,"offset":1592},"end":{"line":59,"column":144,"offset":1593},"indent":[]}}],"position":{"start":{"line":59,"column":3,"offset":1452},"end":{"line":59,"column":144,"offset":1593},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":1450},"end":{"line":59,"column":144,"offset":1593},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":1450},"end":{"line":59,"column":144,"offset":1593},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"KiOS","position":{"start":{"line":61,"column":6,"offset":1600},"end":{"line":61,"column":10,"offset":1604},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":1595},"end":{"line":61,"column":10,"offset":1604},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Updated firmware to latest Raspbian.","position":{"start":{"line":63,"column":3,"offset":1608},"end":{"line":63,"column":39,"offset":1644},"indent":[]}}],"position":{"start":{"line":63,"column":3,"offset":1608},"end":{"line":63,"column":39,"offset":1644},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":1606},"end":{"line":63,"column":39,"offset":1644},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support for the Raspberry Pi 3B+.","position":{"start":{"line":64,"column":3,"offset":1647},"end":{"line":64,"column":36,"offset":1680},"indent":[]}}],"position":{"start":{"line":64,"column":3,"offset":1647},"end":{"line":64,"column":36,"offset":1680},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":1645},"end":{"line":64,"column":36,"offset":1680},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":1606},"end":{"line":64,"column":36,"offset":1680},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.6.1","position":{"start":{"line":66,"column":5,"offset":1686},"end":{"line":66,"column":10,"offset":1691},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":1682},"end":{"line":66,"column":10,"offset":1691},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":68,"column":6,"offset":1698},"end":{"line":68,"column":9,"offset":1701},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":1693},"end":{"line":68,"column":9,"offset":1701},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Solved issue with persisting login configuration. ","position":{"start":{"line":70,"column":3,"offset":1705},"end":{"line":70,"column":53,"offset":1755},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/111","children":[{"type":"text","value":"#111","position":{"start":{"line":70,"column":54,"offset":1756},"end":{"line":70,"column":58,"offset":1760},"indent":[]}}],"position":{"start":{"line":70,"column":53,"offset":1755},"end":{"line":70,"column":106,"offset":1808},"indent":[]}}],"position":{"start":{"line":70,"column":3,"offset":1705},"end":{"line":70,"column":106,"offset":1808},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":1703},"end":{"line":70,"column":106,"offset":1808},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":1703},"end":{"line":70,"column":106,"offset":1808},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":72,"column":6,"offset":1815},"end":{"line":72,"column":15,"offset":1824},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":1810},"end":{"line":72,"column":15,"offset":1824},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added Pushbullet. ","position":{"start":{"line":74,"column":3,"offset":1828},"end":{"line":74,"column":21,"offset":1846},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/pull/139","children":[{"type":"text","value":"#139","position":{"start":{"line":74,"column":22,"offset":1847},"end":{"line":74,"column":26,"offset":1851},"indent":[]}}],"position":{"start":{"line":74,"column":21,"offset":1846},"end":{"line":74,"column":78,"offset":1903},"indent":[]}}],"position":{"start":{"line":74,"column":3,"offset":1828},"end":{"line":74,"column":78,"offset":1903},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":1826},"end":{"line":74,"column":78,"offset":1903},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Cloud upload was not longer working (hotfix also in 2.6.0).","position":{"start":{"line":75,"column":3,"offset":1906},"end":{"line":75,"column":62,"offset":1965},"indent":[]}}],"position":{"start":{"line":75,"column":3,"offset":1906},"end":{"line":75,"column":62,"offset":1965},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":1904},"end":{"line":75,"column":62,"offset":1965},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":1826},"end":{"line":75,"column":62,"offset":1965},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.6.0","position":{"start":{"line":77,"column":5,"offset":1971},"end":{"line":77,"column":10,"offset":1976},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":1967},"end":{"line":77,"column":10,"offset":1976},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":79,"column":6,"offset":1983},"end":{"line":79,"column":9,"offset":1986},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":1978},"end":{"line":79,"column":9,"offset":1986},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Add a cloud connection verification method. ","position":{"start":{"line":81,"column":3,"offset":1990},"end":{"line":81,"column":47,"offset":2034},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/112","children":[{"type":"text","value":"#112","position":{"start":{"line":81,"column":48,"offset":2035},"end":{"line":81,"column":52,"offset":2039},"indent":[]}}],"position":{"start":{"line":81,"column":47,"offset":2034},"end":{"line":81,"column":100,"offset":2087},"indent":[]}}],"position":{"start":{"line":81,"column":3,"offset":1990},"end":{"line":81,"column":100,"offset":2087},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":1988},"end":{"line":81,"column":100,"offset":2087},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":1988},"end":{"line":81,"column":100,"offset":2087},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":83,"column":6,"offset":2094},"end":{"line":83,"column":15,"offset":2103},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":2089},"end":{"line":83,"column":15,"offset":2103},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Add background color timestamp. ","position":{"start":{"line":85,"column":3,"offset":2107},"end":{"line":85,"column":35,"offset":2139},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/128","children":[{"type":"text","value":"#128","position":{"start":{"line":85,"column":36,"offset":2140},"end":{"line":85,"column":40,"offset":2144},"indent":[]}}],"position":{"start":{"line":85,"column":35,"offset":2139},"end":{"line":85,"column":94,"offset":2198},"indent":[]}}],"position":{"start":{"line":85,"column":3,"offset":2107},"end":{"line":85,"column":94,"offset":2198},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":2105},"end":{"line":85,"column":94,"offset":2198},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Send instanceId in AWS header when uploading to cloud (necessary for new cloud app).","position":{"start":{"line":86,"column":3,"offset":2201},"end":{"line":86,"column":87,"offset":2285},"indent":[]}}],"position":{"start":{"line":86,"column":3,"offset":2201},"end":{"line":86,"column":87,"offset":2285},"indent":[]}}],"position":{"start":{"line":86,"column":1,"offset":2199},"end":{"line":86,"column":87,"offset":2285},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Better support for Chinese IP cameras.","position":{"start":{"line":87,"column":3,"offset":2288},"end":{"line":87,"column":41,"offset":2326},"indent":[]}}],"position":{"start":{"line":87,"column":3,"offset":2288},"end":{"line":87,"column":41,"offset":2326},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":2286},"end":{"line":87,"column":41,"offset":2326},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":2105},"end":{"line":87,"column":41,"offset":2326},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Docker","position":{"start":{"line":89,"column":6,"offset":2333},"end":{"line":89,"column":12,"offset":2339},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":2328},"end":{"line":89,"column":12,"offset":2339},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Bug: Autoremove old images/video within Docker Containers. ","position":{"start":{"line":91,"column":3,"offset":2343},"end":{"line":91,"column":62,"offset":2402},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/104","children":[{"type":"text","value":"#104","position":{"start":{"line":91,"column":63,"offset":2403},"end":{"line":91,"column":67,"offset":2407},"indent":[]}}],"position":{"start":{"line":91,"column":62,"offset":2402},"end":{"line":91,"column":115,"offset":2455},"indent":[]}}],"position":{"start":{"line":91,"column":3,"offset":2343},"end":{"line":91,"column":115,"offset":2455},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":2341},"end":{"line":91,"column":115,"offset":2455},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":2341},"end":{"line":91,"column":115,"offset":2455},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.5.0","position":{"start":{"line":93,"column":5,"offset":2461},"end":{"line":93,"column":10,"offset":2466},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":2457},"end":{"line":93,"column":10,"offset":2466},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":95,"column":6,"offset":2473},"end":{"line":95,"column":9,"offset":2476},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":2468},"end":{"line":95,"column":9,"offset":2476},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added Chinese and Italian language.","position":{"start":{"line":97,"column":3,"offset":2480},"end":{"line":97,"column":38,"offset":2515},"indent":[]}}],"position":{"start":{"line":97,"column":3,"offset":2480},"end":{"line":97,"column":38,"offset":2515},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":2478},"end":{"line":97,"column":38,"offset":2515},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Resolved issue with INSTALLED=true.","position":{"start":{"line":98,"column":3,"offset":2518},"end":{"line":98,"column":38,"offset":2553},"indent":[]}}],"position":{"start":{"line":98,"column":3,"offset":2518},"end":{"line":98,"column":38,"offset":2553},"indent":[]}}],"position":{"start":{"line":98,"column":1,"offset":2516},"end":{"line":98,"column":38,"offset":2553},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Make latest_sequence available with basic auth. ","position":{"start":{"line":99,"column":3,"offset":2556},"end":{"line":99,"column":52,"offset":2605},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/99","children":[{"type":"text","value":"#99","position":{"start":{"line":99,"column":53,"offset":2606},"end":{"line":99,"column":56,"offset":2609},"indent":[]}}],"position":{"start":{"line":99,"column":52,"offset":2605},"end":{"line":99,"column":103,"offset":2656},"indent":[]}}],"position":{"start":{"line":99,"column":3,"offset":2556},"end":{"line":99,"column":103,"offset":2656},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":2554},"end":{"line":99,"column":103,"offset":2656},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":2478},"end":{"line":99,"column":103,"offset":2656},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":101,"column":6,"offset":2663},"end":{"line":101,"column":15,"offset":2672},"indent":[]}}],"position":{"start":{"line":101,"column":1,"offset":2658},"end":{"line":101,"column":15,"offset":2672},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Provide an IO service for publishing events to MQTT. ","position":{"start":{"line":103,"column":3,"offset":2676},"end":{"line":103,"column":56,"offset":2729},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/89","children":[{"type":"text","value":"#89","position":{"start":{"line":103,"column":57,"offset":2730},"end":{"line":103,"column":60,"offset":2733},"indent":[]}}],"position":{"start":{"line":103,"column":56,"offset":2729},"end":{"line":103,"column":113,"offset":2786},"indent":[]}}],"position":{"start":{"line":103,"column":3,"offset":2676},"end":{"line":103,"column":113,"offset":2786},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":2674},"end":{"line":103,"column":113,"offset":2786},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Optimize recording with H264_OMX. ","position":{"start":{"line":104,"column":3,"offset":2789},"end":{"line":104,"column":37,"offset":2823},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/83","children":[{"type":"text","value":"#83","position":{"start":{"line":104,"column":38,"offset":2824},"end":{"line":104,"column":41,"offset":2827},"indent":[]}}],"position":{"start":{"line":104,"column":37,"offset":2823},"end":{"line":104,"column":94,"offset":2880},"indent":[]}}],"position":{"start":{"line":104,"column":3,"offset":2789},"end":{"line":104,"column":94,"offset":2880},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":2787},"end":{"line":104,"column":94,"offset":2880},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Implement throttler for Io detections. ","position":{"start":{"line":105,"column":3,"offset":2883},"end":{"line":105,"column":42,"offset":2922},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/96","children":[{"type":"text","value":"#96","position":{"start":{"line":105,"column":43,"offset":2923},"end":{"line":105,"column":46,"offset":2926},"indent":[]}}],"position":{"start":{"line":105,"column":42,"offset":2922},"end":{"line":105,"column":99,"offset":2979},"indent":[]}}],"position":{"start":{"line":105,"column":3,"offset":2883},"end":{"line":105,"column":99,"offset":2979},"indent":[]}}],"position":{"start":{"line":105,"column":1,"offset":2881},"end":{"line":105,"column":99,"offset":2979},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"SSL version 1.0.0 is no longer accessible in Raspbian. ","position":{"start":{"line":106,"column":3,"offset":2982},"end":{"line":106,"column":58,"offset":3037},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/109","children":[{"type":"text","value":"#109","position":{"start":{"line":106,"column":59,"offset":3038},"end":{"line":106,"column":63,"offset":3042},"indent":[]}}],"position":{"start":{"line":106,"column":58,"offset":3037},"end":{"line":106,"column":117,"offset":3096},"indent":[]}}],"position":{"start":{"line":106,"column":3,"offset":2982},"end":{"line":106,"column":117,"offset":3096},"indent":[]}}],"position":{"start":{"line":106,"column":1,"offset":2980},"end":{"line":106,"column":117,"offset":3096},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":2674},"end":{"line":106,"column":117,"offset":3096},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.4.2","position":{"start":{"line":108,"column":5,"offset":3102},"end":{"line":108,"column":10,"offset":3107},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":3098},"end":{"line":108,"column":10,"offset":3107},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":110,"column":6,"offset":3114},"end":{"line":110,"column":9,"offset":3117},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":3109},"end":{"line":110,"column":9,"offset":3117},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Typo in french translation, causes the web interface crash.","position":{"start":{"line":112,"column":3,"offset":3121},"end":{"line":112,"column":62,"offset":3180},"indent":[]}}],"position":{"start":{"line":112,"column":3,"offset":3121},"end":{"line":112,"column":62,"offset":3180},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":3119},"end":{"line":112,"column":62,"offset":3180},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":3119},"end":{"line":112,"column":62,"offset":3180},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":114,"column":6,"offset":3187},"end":{"line":114,"column":15,"offset":3196},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":3182},"end":{"line":114,"column":15,"offset":3196},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Resolved major bug in livestream: memory leak in stream class. ","position":{"start":{"line":116,"column":3,"offset":3200},"end":{"line":116,"column":66,"offset":3263},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/94","children":[{"type":"text","value":"#94","position":{"start":{"line":116,"column":67,"offset":3264},"end":{"line":116,"column":70,"offset":3267},"indent":[]}}],"position":{"start":{"line":116,"column":66,"offset":3263},"end":{"line":116,"column":123,"offset":3320},"indent":[]}}],"position":{"start":{"line":116,"column":3,"offset":3200},"end":{"line":116,"column":123,"offset":3320},"indent":[]}}],"position":{"start":{"line":116,"column":1,"offset":3198},"end":{"line":116,"column":123,"offset":3320},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Capture health verification: check if the chosen capture device is still grabbing (and didn't stalled).","position":{"start":{"line":117,"column":3,"offset":3323},"end":{"line":117,"column":106,"offset":3426},"indent":[]}}],"position":{"start":{"line":117,"column":3,"offset":3323},"end":{"line":117,"column":106,"offset":3426},"indent":[]}}],"position":{"start":{"line":117,"column":1,"offset":3321},"end":{"line":117,"column":106,"offset":3426},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Extra logging when recording with raspberry pi camera.","position":{"start":{"line":118,"column":3,"offset":3429},"end":{"line":118,"column":57,"offset":3483},"indent":[]}}],"position":{"start":{"line":118,"column":3,"offset":3429},"end":{"line":118,"column":57,"offset":3483},"indent":[]}}],"position":{"start":{"line":118,"column":1,"offset":3427},"end":{"line":118,"column":57,"offset":3483},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Make sure the cloud upload is functioning properly, after an upload it's verified if the files really exist in the cloud.","position":{"start":{"line":119,"column":3,"offset":3486},"end":{"line":119,"column":124,"offset":3607},"indent":[]}}],"position":{"start":{"line":119,"column":3,"offset":3486},"end":{"line":119,"column":124,"offset":3607},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":3484},"end":{"line":119,"column":124,"offset":3607},"indent":[]}}],"position":{"start":{"line":116,"column":1,"offset":3198},"end":{"line":119,"column":124,"offset":3607},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.4.1","position":{"start":{"line":121,"column":5,"offset":3613},"end":{"line":121,"column":10,"offset":3618},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":3609},"end":{"line":121,"column":10,"offset":3618},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":123,"column":6,"offset":3625},"end":{"line":123,"column":9,"offset":3628},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":3620},"end":{"line":123,"column":9,"offset":3628},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Show warning when system is disabled. ","position":{"start":{"line":125,"column":3,"offset":3632},"end":{"line":125,"column":41,"offset":3670},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/88","children":[{"type":"text","value":"#88","position":{"start":{"line":125,"column":42,"offset":3671},"end":{"line":125,"column":45,"offset":3674},"indent":[]}}],"position":{"start":{"line":125,"column":41,"offset":3670},"end":{"line":125,"column":92,"offset":3721},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":125,"column":92,"offset":3721},"end":{"line":125,"column":93,"offset":3722},"indent":[]}}],"position":{"start":{"line":125,"column":3,"offset":3632},"end":{"line":125,"column":93,"offset":3722},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":3630},"end":{"line":125,"column":93,"offset":3722},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Hull selector in basic view not always working.","position":{"start":{"line":126,"column":3,"offset":3725},"end":{"line":126,"column":50,"offset":3772},"indent":[]}}],"position":{"start":{"line":126,"column":3,"offset":3725},"end":{"line":126,"column":50,"offset":3772},"indent":[]}}],"position":{"start":{"line":126,"column":1,"offset":3723},"end":{"line":126,"column":50,"offset":3772},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":3630},"end":{"line":126,"column":50,"offset":3772},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.4.0","position":{"start":{"line":128,"column":5,"offset":3778},"end":{"line":128,"column":10,"offset":3783},"indent":[]}}],"position":{"start":{"line":128,"column":1,"offset":3774},"end":{"line":128,"column":10,"offset":3783},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Ecosystem","position":{"start":{"line":130,"column":6,"offset":3790},"end":{"line":130,"column":15,"offset":3799},"indent":[]}}],"position":{"start":{"line":130,"column":1,"offset":3785},"end":{"line":130,"column":15,"offset":3799},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Enable/Disable force network mode.","position":{"start":{"line":132,"column":3,"offset":3803},"end":{"line":132,"column":37,"offset":3837},"indent":[]}}],"position":{"start":{"line":132,"column":3,"offset":3803},"end":{"line":132,"column":37,"offset":3837},"indent":[]}}],"position":{"start":{"line":132,"column":1,"offset":3801},"end":{"line":132,"column":37,"offset":3837},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Enable/Disable auto removal media.","position":{"start":{"line":133,"column":3,"offset":3840},"end":{"line":133,"column":37,"offset":3874},"indent":[]}}],"position":{"start":{"line":133,"column":3,"offset":3840},"end":{"line":133,"column":37,"offset":3874},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":3838},"end":{"line":133,"column":37,"offset":3874},"indent":[]}}],"position":{"start":{"line":132,"column":1,"offset":3801},"end":{"line":133,"column":37,"offset":3874},"indent":[1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":135,"column":6,"offset":3881},"end":{"line":135,"column":9,"offset":3884},"indent":[]}}],"position":{"start":{"line":135,"column":1,"offset":3876},"end":{"line":135,"column":9,"offset":3884},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Upgrade from Laravel 4.2 to Laravel 5.4 ","position":{"start":{"line":137,"column":3,"offset":3888},"end":{"line":137,"column":43,"offset":3928},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/70","children":[{"type":"text","value":"#70","position":{"start":{"line":137,"column":44,"offset":3929},"end":{"line":137,"column":47,"offset":3932},"indent":[]}}],"position":{"start":{"line":137,"column":43,"offset":3928},"end":{"line":137,"column":94,"offset":3979},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":137,"column":94,"offset":3979},"end":{"line":137,"column":95,"offset":3980},"indent":[]}}],"position":{"start":{"line":137,"column":3,"offset":3888},"end":{"line":137,"column":95,"offset":3980},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":3886},"end":{"line":137,"column":95,"offset":3980},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fix bug with heatmap radius slider ","position":{"start":{"line":138,"column":3,"offset":3983},"end":{"line":138,"column":38,"offset":4018},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/84","children":[{"type":"text","value":"#84","position":{"start":{"line":138,"column":39,"offset":4019},"end":{"line":138,"column":42,"offset":4022},"indent":[]}}],"position":{"start":{"line":138,"column":38,"offset":4018},"end":{"line":138,"column":89,"offset":4069},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":138,"column":89,"offset":4069},"end":{"line":138,"column":90,"offset":4070},"indent":[]}}],"position":{"start":{"line":138,"column":3,"offset":3983},"end":{"line":138,"column":90,"offset":4070},"indent":[]}}],"position":{"start":{"line":138,"column":1,"offset":3981},"end":{"line":138,"column":90,"offset":4070},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Design tweaks toggle button (remove outline).","position":{"start":{"line":139,"column":3,"offset":4073},"end":{"line":139,"column":48,"offset":4118},"indent":[]}}],"position":{"start":{"line":139,"column":3,"offset":4073},"end":{"line":139,"column":48,"offset":4118},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":4071},"end":{"line":139,"column":48,"offset":4118},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Disabled possibility to timestamp video when using hardware acceleration.","position":{"start":{"line":140,"column":3,"offset":4121},"end":{"line":140,"column":76,"offset":4194},"indent":[]}}],"position":{"start":{"line":140,"column":3,"offset":4121},"end":{"line":140,"column":76,"offset":4194},"indent":[]}}],"position":{"start":{"line":140,"column":1,"offset":4119},"end":{"line":140,"column":76,"offset":4194},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":3886},"end":{"line":140,"column":76,"offset":4194},"indent":[1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Docker","position":{"start":{"line":142,"column":6,"offset":4201},"end":{"line":142,"column":12,"offset":4207},"indent":[]}}],"position":{"start":{"line":142,"column":1,"offset":4196},"end":{"line":142,"column":12,"offset":4207},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fix SSL support ","position":{"start":{"line":144,"column":3,"offset":4211},"end":{"line":144,"column":19,"offset":4227},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/docker/issues/4","children":[{"type":"text","value":"#4","position":{"start":{"line":144,"column":20,"offset":4228},"end":{"line":144,"column":22,"offset":4230},"indent":[]}}],"position":{"start":{"line":144,"column":19,"offset":4227},"end":{"line":144,"column":71,"offset":4279},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":144,"column":71,"offset":4279},"end":{"line":144,"column":72,"offset":4280},"indent":[]}}],"position":{"start":{"line":144,"column":3,"offset":4211},"end":{"line":144,"column":72,"offset":4280},"indent":[]}}],"position":{"start":{"line":144,"column":1,"offset":4209},"end":{"line":144,"column":72,"offset":4280},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Auto removal if disk is full.","position":{"start":{"line":145,"column":3,"offset":4283},"end":{"line":145,"column":32,"offset":4312},"indent":[]}}],"position":{"start":{"line":145,"column":3,"offset":4283},"end":{"line":145,"column":32,"offset":4312},"indent":[]}}],"position":{"start":{"line":145,"column":1,"offset":4281},"end":{"line":145,"column":32,"offset":4312},"indent":[]}}],"position":{"start":{"line":144,"column":1,"offset":4209},"end":{"line":145,"column":32,"offset":4312},"indent":[1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":147,"column":6,"offset":4319},"end":{"line":147,"column":15,"offset":4328},"indent":[]}}],"position":{"start":{"line":147,"column":1,"offset":4314},"end":{"line":147,"column":15,"offset":4328},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"OpenMAX IL hardware encoding for Raspberry Pi camera. ","position":{"start":{"line":149,"column":3,"offset":4332},"end":{"line":149,"column":57,"offset":4386},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/83","children":[{"type":"text","value":"#83","position":{"start":{"line":149,"column":58,"offset":4387},"end":{"line":149,"column":61,"offset":4390},"indent":[]}}],"position":{"start":{"line":149,"column":57,"offset":4386},"end":{"line":149,"column":114,"offset":4443},"indent":[]}}],"position":{"start":{"line":149,"column":3,"offset":4332},"end":{"line":149,"column":114,"offset":4443},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Optimized live streaming.","position":{"start":{"line":150,"column":5,"offset":4448},"end":{"line":150,"column":30,"offset":4473},"indent":[]}}],"position":{"start":{"line":150,"column":5,"offset":4448},"end":{"line":150,"column":30,"offset":4473},"indent":[]}}],"position":{"start":{"line":150,"column":3,"offset":4446},"end":{"line":150,"column":30,"offset":4473},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Optimized h264 recording.","position":{"start":{"line":151,"column":5,"offset":4478},"end":{"line":151,"column":30,"offset":4503},"indent":[]}}],"position":{"start":{"line":151,"column":5,"offset":4478},"end":{"line":151,"column":30,"offset":4503},"indent":[]}}],"position":{"start":{"line":151,"column":3,"offset":4476},"end":{"line":151,"column":30,"offset":4503},"indent":[]}}],"position":{"start":{"line":150,"column":3,"offset":4446},"end":{"line":151,"column":30,"offset":4503},"indent":[3]}}],"position":{"start":{"line":149,"column":1,"offset":4330},"end":{"line":151,"column":30,"offset":4503},"indent":[1,1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Basic authentication for live streaming (username and password). ","position":{"start":{"line":152,"column":3,"offset":4506},"end":{"line":152,"column":68,"offset":4571},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/80","children":[{"type":"text","value":"#80","position":{"start":{"line":152,"column":69,"offset":4572},"end":{"line":152,"column":72,"offset":4575},"indent":[]}}],"position":{"start":{"line":152,"column":68,"offset":4571},"end":{"line":152,"column":125,"offset":4628},"indent":[]}}],"position":{"start":{"line":152,"column":3,"offset":4506},"end":{"line":152,"column":125,"offset":4628},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":4504},"end":{"line":152,"column":125,"offset":4628},"indent":[]}}],"position":{"start":{"line":149,"column":1,"offset":4330},"end":{"line":152,"column":125,"offset":4628},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.3.1","position":{"start":{"line":154,"column":5,"offset":4634},"end":{"line":154,"column":10,"offset":4639},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":4630},"end":{"line":154,"column":10,"offset":4639},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":156,"column":6,"offset":4646},"end":{"line":156,"column":15,"offset":4655},"indent":[]}}],"position":{"start":{"line":156,"column":1,"offset":4641},"end":{"line":156,"column":15,"offset":4655},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Update for kerberos.cloud: pushing content-type.","position":{"start":{"line":158,"column":3,"offset":4659},"end":{"line":158,"column":51,"offset":4707},"indent":[]}}],"position":{"start":{"line":158,"column":3,"offset":4659},"end":{"line":158,"column":51,"offset":4707},"indent":[]}}],"position":{"start":{"line":158,"column":1,"offset":4657},"end":{"line":158,"column":51,"offset":4707},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Change default configurations.","position":{"start":{"line":159,"column":3,"offset":4710},"end":{"line":159,"column":33,"offset":4740},"indent":[]}}],"position":{"start":{"line":159,"column":3,"offset":4710},"end":{"line":159,"column":33,"offset":4740},"indent":[]}}],"position":{"start":{"line":159,"column":1,"offset":4708},"end":{"line":159,"column":33,"offset":4740},"indent":[]}}],"position":{"start":{"line":158,"column":1,"offset":4657},"end":{"line":159,"column":33,"offset":4740},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.3.0","position":{"start":{"line":161,"column":5,"offset":4746},"end":{"line":161,"column":10,"offset":4751},"indent":[]}}],"position":{"start":{"line":161,"column":1,"offset":4742},"end":{"line":161,"column":10,"offset":4751},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Ecosystem","position":{"start":{"line":163,"column":6,"offset":4758},"end":{"line":163,"column":15,"offset":4767},"indent":[]}}],"position":{"start":{"line":163,"column":1,"offset":4753},"end":{"line":163,"column":15,"offset":4767},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support for Raspberry Pi Zero W. ","position":{"start":{"line":165,"column":3,"offset":4771},"end":{"line":165,"column":36,"offset":4804},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/kios/issues/8","children":[{"type":"text","value":"#8","position":{"start":{"line":165,"column":37,"offset":4805},"end":{"line":165,"column":39,"offset":4807},"indent":[]}}],"position":{"start":{"line":165,"column":36,"offset":4804},"end":{"line":165,"column":86,"offset":4854},"indent":[]}}],"position":{"start":{"line":165,"column":3,"offset":4771},"end":{"line":165,"column":86,"offset":4854},"indent":[]}}],"position":{"start":{"line":165,"column":1,"offset":4769},"end":{"line":165,"column":86,"offset":4854},"indent":[]}}],"position":{"start":{"line":165,"column":1,"offset":4769},"end":{"line":165,"column":86,"offset":4854},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.2.1","position":{"start":{"line":167,"column":5,"offset":4860},"end":{"line":167,"column":10,"offset":4865},"indent":[]}}],"position":{"start":{"line":167,"column":1,"offset":4856},"end":{"line":167,"column":10,"offset":4865},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Ecosystem","position":{"start":{"line":169,"column":6,"offset":4872},"end":{"line":169,"column":15,"offset":4881},"indent":[]}}],"position":{"start":{"line":169,"column":1,"offset":4867},"end":{"line":169,"column":15,"offset":4881},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Upgraded FFmpeg and libx264 on KiOS.","position":{"start":{"line":171,"column":3,"offset":4885},"end":{"line":171,"column":39,"offset":4921},"indent":[]}}],"position":{"start":{"line":171,"column":3,"offset":4885},"end":{"line":171,"column":39,"offset":4921},"indent":[]}}],"position":{"start":{"line":171,"column":1,"offset":4883},"end":{"line":171,"column":39,"offset":4921},"indent":[]}}],"position":{"start":{"line":171,"column":1,"offset":4883},"end":{"line":171,"column":39,"offset":4921},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":173,"column":6,"offset":4928},"end":{"line":173,"column":9,"offset":4931},"indent":[]}}],"position":{"start":{"line":173,"column":1,"offset":4923},"end":{"line":173,"column":9,"offset":4931},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Add Bulgarian translation. ","position":{"start":{"line":175,"column":3,"offset":4935},"end":{"line":175,"column":30,"offset":4962},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/pull/81","children":[{"type":"text","value":"#81","position":{"start":{"line":175,"column":31,"offset":4963},"end":{"line":175,"column":34,"offset":4966},"indent":[]}}],"position":{"start":{"line":175,"column":30,"offset":4962},"end":{"line":175,"column":79,"offset":5011},"indent":[]}}],"position":{"start":{"line":175,"column":3,"offset":4935},"end":{"line":175,"column":79,"offset":5011},"indent":[]}}],"position":{"start":{"line":175,"column":1,"offset":4933},"end":{"line":175,"column":79,"offset":5011},"indent":[]}}],"position":{"start":{"line":175,"column":1,"offset":4933},"end":{"line":175,"column":79,"offset":5011},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":177,"column":6,"offset":5018},"end":{"line":177,"column":15,"offset":5027},"indent":[]}}],"position":{"start":{"line":177,"column":1,"offset":5013},"end":{"line":177,"column":15,"offset":5027},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Bug: IoVideo crashes due to a memory leak. ","position":{"start":{"line":179,"column":3,"offset":5031},"end":{"line":179,"column":46,"offset":5074},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/70","children":[{"type":"text","value":"#70","position":{"start":{"line":179,"column":47,"offset":5075},"end":{"line":179,"column":50,"offset":5078},"indent":[]}}],"position":{"start":{"line":179,"column":46,"offset":5074},"end":{"line":179,"column":103,"offset":5131},"indent":[]}}],"position":{"start":{"line":179,"column":3,"offset":5031},"end":{"line":179,"column":103,"offset":5131},"indent":[]}}],"position":{"start":{"line":179,"column":1,"offset":5029},"end":{"line":179,"column":103,"offset":5131},"indent":[]}}],"position":{"start":{"line":179,"column":1,"offset":5029},"end":{"line":179,"column":103,"offset":5131},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.2.0","position":{"start":{"line":181,"column":5,"offset":5137},"end":{"line":181,"column":10,"offset":5142},"indent":[]}}],"position":{"start":{"line":181,"column":1,"offset":5133},"end":{"line":181,"column":10,"offset":5142},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Ecosystem","position":{"start":{"line":183,"column":6,"offset":5149},"end":{"line":183,"column":15,"offset":5158},"indent":[]}}],"position":{"start":{"line":183,"column":1,"offset":5144},"end":{"line":183,"column":15,"offset":5158},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added support for Armbian.","position":{"start":{"line":185,"column":3,"offset":5162},"end":{"line":185,"column":29,"offset":5188},"indent":[]}}],"position":{"start":{"line":185,"column":3,"offset":5162},"end":{"line":185,"column":29,"offset":5188},"indent":[]}}],"position":{"start":{"line":185,"column":1,"offset":5160},"end":{"line":185,"column":29,"offset":5188},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Raspbian: Async requests causes session corruption. ","position":{"start":{"line":186,"column":3,"offset":5191},"end":{"line":186,"column":55,"offset":5243},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/78","children":[{"type":"text","value":"#78","position":{"start":{"line":186,"column":56,"offset":5244},"end":{"line":186,"column":59,"offset":5247},"indent":[]}}],"position":{"start":{"line":186,"column":55,"offset":5243},"end":{"line":186,"column":106,"offset":5294},"indent":[]}}],"position":{"start":{"line":186,"column":3,"offset":5191},"end":{"line":186,"column":106,"offset":5294},"indent":[]}}],"position":{"start":{"line":186,"column":1,"offset":5189},"end":{"line":186,"column":106,"offset":5294},"indent":[]}}],"position":{"start":{"line":185,"column":1,"offset":5160},"end":{"line":186,"column":106,"offset":5294},"indent":[1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":188,"column":6,"offset":5301},"end":{"line":188,"column":9,"offset":5304},"indent":[]}}],"position":{"start":{"line":188,"column":1,"offset":5296},"end":{"line":188,"column":9,"offset":5304},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Bug: Issue format instance name. ","position":{"start":{"line":190,"column":3,"offset":5308},"end":{"line":190,"column":36,"offset":5341},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/57","children":[{"type":"text","value":"#57","position":{"start":{"line":190,"column":37,"offset":5342},"end":{"line":190,"column":40,"offset":5345},"indent":[]}}],"position":{"start":{"line":190,"column":36,"offset":5341},"end":{"line":190,"column":87,"offset":5392},"indent":[]}}],"position":{"start":{"line":190,"column":3,"offset":5308},"end":{"line":190,"column":87,"offset":5392},"indent":[]}}],"position":{"start":{"line":190,"column":1,"offset":5306},"end":{"line":190,"column":87,"offset":5392},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Redesign settings page (better UX). ","position":{"start":{"line":191,"column":3,"offset":5395},"end":{"line":191,"column":39,"offset":5431},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/39","children":[{"type":"text","value":"#39","position":{"start":{"line":191,"column":40,"offset":5432},"end":{"line":191,"column":43,"offset":5435},"indent":[]}}],"position":{"start":{"line":191,"column":39,"offset":5431},"end":{"line":191,"column":90,"offset":5482},"indent":[]}}],"position":{"start":{"line":191,"column":3,"offset":5395},"end":{"line":191,"column":90,"offset":5482},"indent":[]}}],"position":{"start":{"line":191,"column":1,"offset":5393},"end":{"line":191,"column":90,"offset":5482},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Possibility to edit password through web interface. ","position":{"start":{"line":192,"column":3,"offset":5485},"end":{"line":192,"column":55,"offset":5537},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/63","children":[{"type":"text","value":"#63","position":{"start":{"line":192,"column":56,"offset":5538},"end":{"line":192,"column":59,"offset":5541},"indent":[]}}],"position":{"start":{"line":192,"column":55,"offset":5537},"end":{"line":192,"column":106,"offset":5588},"indent":[]}}],"position":{"start":{"line":192,"column":3,"offset":5485},"end":{"line":192,"column":106,"offset":5588},"indent":[]}}],"position":{"start":{"line":192,"column":1,"offset":5483},"end":{"line":192,"column":106,"offset":5588},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support for viewing videos.","position":{"start":{"line":193,"column":3,"offset":5591},"end":{"line":193,"column":30,"offset":5618},"indent":[]}}],"position":{"start":{"line":193,"column":3,"offset":5591},"end":{"line":193,"column":30,"offset":5618},"indent":[]}}],"position":{"start":{"line":193,"column":1,"offset":5589},"end":{"line":193,"column":30,"offset":5618},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Update radius of heatmap.","position":{"start":{"line":194,"column":3,"offset":5621},"end":{"line":194,"column":28,"offset":5646},"indent":[]}}],"position":{"start":{"line":194,"column":3,"offset":5621},"end":{"line":194,"column":28,"offset":5646},"indent":[]}}],"position":{"start":{"line":194,"column":1,"offset":5619},"end":{"line":194,"column":28,"offset":5646},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"PHP7 support. ","position":{"start":{"line":195,"column":3,"offset":5649},"end":{"line":195,"column":17,"offset":5663},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/60","children":[{"type":"text","value":"#60","position":{"start":{"line":195,"column":18,"offset":5664},"end":{"line":195,"column":21,"offset":5667},"indent":[]}}],"position":{"start":{"line":195,"column":17,"offset":5663},"end":{"line":195,"column":68,"offset":5714},"indent":[]}}],"position":{"start":{"line":195,"column":3,"offset":5649},"end":{"line":195,"column":68,"offset":5714},"indent":[]}}],"position":{"start":{"line":195,"column":1,"offset":5647},"end":{"line":195,"column":68,"offset":5714},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Welcome/installation page. ","position":{"start":{"line":196,"column":3,"offset":5717},"end":{"line":196,"column":30,"offset":5744},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/60","children":[{"type":"text","value":"#60","position":{"start":{"line":196,"column":31,"offset":5745},"end":{"line":196,"column":34,"offset":5748},"indent":[]}}],"position":{"start":{"line":196,"column":30,"offset":5744},"end":{"line":196,"column":81,"offset":5795},"indent":[]}}],"position":{"start":{"line":196,"column":3,"offset":5717},"end":{"line":196,"column":81,"offset":5795},"indent":[]}}],"position":{"start":{"line":196,"column":1,"offset":5715},"end":{"line":196,"column":81,"offset":5795},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Translation updated. ","position":{"start":{"line":197,"column":3,"offset":5798},"end":{"line":197,"column":24,"offset":5819},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/74","children":[{"type":"text","value":"#74","position":{"start":{"line":197,"column":25,"offset":5820},"end":{"line":197,"column":28,"offset":5823},"indent":[]}}],"position":{"start":{"line":197,"column":24,"offset":5819},"end":{"line":197,"column":75,"offset":5870},"indent":[]}}],"position":{"start":{"line":197,"column":3,"offset":5798},"end":{"line":197,"column":75,"offset":5870},"indent":[]}}],"position":{"start":{"line":197,"column":1,"offset":5796},"end":{"line":197,"column":75,"offset":5870},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Privacy mode. ","position":{"start":{"line":198,"column":3,"offset":5873},"end":{"line":198,"column":17,"offset":5887},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/54","children":[{"type":"text","value":"#54","position":{"start":{"line":198,"column":18,"offset":5888},"end":{"line":198,"column":21,"offset":5891},"indent":[]}}],"position":{"start":{"line":198,"column":17,"offset":5887},"end":{"line":198,"column":68,"offset":5938},"indent":[]}}],"position":{"start":{"line":198,"column":3,"offset":5873},"end":{"line":198,"column":68,"offset":5938},"indent":[]}}],"position":{"start":{"line":198,"column":1,"offset":5871},"end":{"line":198,"column":68,"offset":5938},"indent":[]}}],"position":{"start":{"line":190,"column":1,"offset":5306},"end":{"line":198,"column":68,"offset":5938},"indent":[1,1,1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":200,"column":6,"offset":5945},"end":{"line":200,"column":15,"offset":5954},"indent":[]}}],"position":{"start":{"line":200,"column":1,"offset":5940},"end":{"line":200,"column":15,"offset":5954},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Output as video file. ","position":{"start":{"line":202,"column":3,"offset":5958},"end":{"line":202,"column":25,"offset":5980},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/60","children":[{"type":"text","value":"#60","position":{"start":{"line":202,"column":26,"offset":5981},"end":{"line":202,"column":29,"offset":5984},"indent":[]}}],"position":{"start":{"line":202,"column":25,"offset":5980},"end":{"line":202,"column":82,"offset":6037},"indent":[]}}],"position":{"start":{"line":202,"column":3,"offset":5958},"end":{"line":202,"column":82,"offset":6037},"indent":[]}}],"position":{"start":{"line":202,"column":1,"offset":5956},"end":{"line":202,"column":82,"offset":6037},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Bug: System hangs when a wrong IP camera url was defined. ","position":{"start":{"line":203,"column":3,"offset":6040},"end":{"line":203,"column":61,"offset":6098},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/48","children":[{"type":"text","value":"#48","position":{"start":{"line":203,"column":62,"offset":6099},"end":{"line":203,"column":65,"offset":6102},"indent":[]}}],"position":{"start":{"line":203,"column":61,"offset":6098},"end":{"line":203,"column":118,"offset":6155},"indent":[]}}],"position":{"start":{"line":203,"column":3,"offset":6040},"end":{"line":203,"column":118,"offset":6155},"indent":[]}}],"position":{"start":{"line":203,"column":1,"offset":6038},"end":{"line":203,"column":118,"offset":6155},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Run arbitrary script/program. ","position":{"start":{"line":204,"column":3,"offset":6158},"end":{"line":204,"column":33,"offset":6188},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/31","children":[{"type":"text","value":"#31","position":{"start":{"line":204,"column":34,"offset":6189},"end":{"line":204,"column":37,"offset":6192},"indent":[]}}],"position":{"start":{"line":204,"column":33,"offset":6188},"end":{"line":204,"column":90,"offset":6245},"indent":[]}}],"position":{"start":{"line":204,"column":3,"offset":6158},"end":{"line":204,"column":90,"offset":6245},"indent":[]}}],"position":{"start":{"line":204,"column":1,"offset":6156},"end":{"line":204,"column":90,"offset":6245},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Bug: Weird colors from RPi Camera. ","position":{"start":{"line":205,"column":3,"offset":6248},"end":{"line":205,"column":38,"offset":6283},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/64","children":[{"type":"text","value":"#64","position":{"start":{"line":205,"column":39,"offset":6284},"end":{"line":205,"column":42,"offset":6287},"indent":[]}}],"position":{"start":{"line":205,"column":38,"offset":6283},"end":{"line":205,"column":95,"offset":6340},"indent":[]}}],"position":{"start":{"line":205,"column":3,"offset":6248},"end":{"line":205,"column":95,"offset":6340},"indent":[]}}],"position":{"start":{"line":205,"column":1,"offset":6246},"end":{"line":205,"column":95,"offset":6340},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Upgrade to OpenCV 3.2.0.","position":{"start":{"line":206,"column":3,"offset":6343},"end":{"line":206,"column":27,"offset":6367},"indent":[]}}],"position":{"start":{"line":206,"column":3,"offset":6343},"end":{"line":206,"column":27,"offset":6367},"indent":[]}}],"position":{"start":{"line":206,"column":1,"offset":6341},"end":{"line":206,"column":27,"offset":6367},"indent":[]}}],"position":{"start":{"line":202,"column":1,"offset":5956},"end":{"line":206,"column":27,"offset":6367},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.1.0","position":{"start":{"line":208,"column":5,"offset":6373},"end":{"line":208,"column":10,"offset":6378},"indent":[]}}],"position":{"start":{"line":208,"column":1,"offset":6369},"end":{"line":208,"column":10,"offset":6378},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":210,"column":6,"offset":6385},"end":{"line":210,"column":9,"offset":6388},"indent":[]}}],"position":{"start":{"line":210,"column":1,"offset":6380},"end":{"line":210,"column":9,"offset":6388},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added PhotoSwipe for image overview (easier to browse through images). ","position":{"start":{"line":212,"column":3,"offset":6392},"end":{"line":212,"column":74,"offset":6463},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/45","children":[{"type":"text","value":"#45","position":{"start":{"line":212,"column":75,"offset":6464},"end":{"line":212,"column":78,"offset":6467},"indent":[]}}],"position":{"start":{"line":212,"column":74,"offset":6463},"end":{"line":212,"column":125,"offset":6514},"indent":[]}}],"position":{"start":{"line":212,"column":3,"offset":6392},"end":{"line":212,"column":125,"offset":6514},"indent":[]}}],"position":{"start":{"line":212,"column":1,"offset":6390},"end":{"line":212,"column":125,"offset":6514},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added reboot and shutdown commands. ","position":{"start":{"line":213,"column":3,"offset":6517},"end":{"line":213,"column":39,"offset":6553},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/46","children":[{"type":"text","value":"#46","position":{"start":{"line":213,"column":40,"offset":6554},"end":{"line":213,"column":43,"offset":6557},"indent":[]}}],"position":{"start":{"line":213,"column":39,"offset":6553},"end":{"line":213,"column":90,"offset":6604},"indent":[]}}],"position":{"start":{"line":213,"column":3,"offset":6517},"end":{"line":213,"column":90,"offset":6604},"indent":[]}}],"position":{"start":{"line":213,"column":1,"offset":6515},"end":{"line":213,"column":90,"offset":6604},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added logging view to system page. ","position":{"start":{"line":214,"column":3,"offset":6607},"end":{"line":214,"column":38,"offset":6642},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/33","children":[{"type":"text","value":"#33","position":{"start":{"line":214,"column":39,"offset":6643},"end":{"line":214,"column":42,"offset":6646},"indent":[]}}],"position":{"start":{"line":214,"column":38,"offset":6642},"end":{"line":214,"column":89,"offset":6693},"indent":[]}}],"position":{"start":{"line":214,"column":3,"offset":6607},"end":{"line":214,"column":89,"offset":6693},"indent":[]}}],"position":{"start":{"line":214,"column":1,"offset":6605},"end":{"line":214,"column":89,"offset":6693},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added labels to check if machinery is running.","position":{"start":{"line":215,"column":3,"offset":6696},"end":{"line":215,"column":49,"offset":6742},"indent":[]}}],"position":{"start":{"line":215,"column":3,"offset":6696},"end":{"line":215,"column":49,"offset":6742},"indent":[]}}],"position":{"start":{"line":215,"column":1,"offset":6694},"end":{"line":215,"column":49,"offset":6742},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added error handling if web interface isn’t working properly.","position":{"start":{"line":216,"column":3,"offset":6745},"end":{"line":216,"column":64,"offset":6806},"indent":[]}}],"position":{"start":{"line":216,"column":3,"offset":6745},"end":{"line":216,"column":64,"offset":6806},"indent":[]}}],"position":{"start":{"line":216,"column":1,"offset":6743},"end":{"line":216,"column":64,"offset":6806},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fixed Heatmap.js fail to load by ad-blocker. ","position":{"start":{"line":217,"column":3,"offset":6809},"end":{"line":217,"column":48,"offset":6854},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/42","children":[{"type":"text","value":"#42","position":{"start":{"line":217,"column":49,"offset":6855},"end":{"line":217,"column":52,"offset":6858},"indent":[]}}],"position":{"start":{"line":217,"column":48,"offset":6854},"end":{"line":217,"column":99,"offset":6905},"indent":[]}}],"position":{"start":{"line":217,"column":3,"offset":6809},"end":{"line":217,"column":99,"offset":6905},"indent":[]}}],"position":{"start":{"line":217,"column":1,"offset":6807},"end":{"line":217,"column":99,"offset":6905},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Show additional information on the dashboard (streaming is opening or not) there is no data available.","position":{"start":{"line":218,"column":3,"offset":6908},"end":{"line":218,"column":105,"offset":7010},"indent":[]}}],"position":{"start":{"line":218,"column":3,"offset":6908},"end":{"line":218,"column":105,"offset":7010},"indent":[]}}],"position":{"start":{"line":218,"column":1,"offset":6906},"end":{"line":218,"column":105,"offset":7010},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Settings page is now visible on mobile (+ changed icon).","position":{"start":{"line":219,"column":3,"offset":7013},"end":{"line":219,"column":59,"offset":7069},"indent":[]}}],"position":{"start":{"line":219,"column":3,"offset":7013},"end":{"line":219,"column":59,"offset":7069},"indent":[]}}],"position":{"start":{"line":219,"column":1,"offset":7011},"end":{"line":219,"column":59,"offset":7069},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fixed sorting of news articles.","position":{"start":{"line":220,"column":3,"offset":7072},"end":{"line":220,"column":34,"offset":7103},"indent":[]}}],"position":{"start":{"line":220,"column":3,"offset":7072},"end":{"line":220,"column":34,"offset":7103},"indent":[]}}],"position":{"start":{"line":220,"column":1,"offset":7070},"end":{"line":220,"column":34,"offset":7103},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Removed links to assets in the cloud (.css files).","position":{"start":{"line":221,"column":3,"offset":7106},"end":{"line":221,"column":53,"offset":7156},"indent":[]}}],"position":{"start":{"line":221,"column":3,"offset":7106},"end":{"line":221,"column":53,"offset":7156},"indent":[]}}],"position":{"start":{"line":221,"column":1,"offset":7104},"end":{"line":221,"column":53,"offset":7156},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Design: improved layout of login page, async loading of image view.","position":{"start":{"line":222,"column":3,"offset":7159},"end":{"line":222,"column":70,"offset":7226},"indent":[]}}],"position":{"start":{"line":222,"column":3,"offset":7159},"end":{"line":222,"column":70,"offset":7226},"indent":[]}}],"position":{"start":{"line":222,"column":1,"offset":7157},"end":{"line":222,"column":70,"offset":7226},"indent":[]}}],"position":{"start":{"line":212,"column":1,"offset":6390},"end":{"line":222,"column":70,"offset":7226},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":224,"column":6,"offset":7233},"end":{"line":224,"column":15,"offset":7242},"indent":[]}}],"position":{"start":{"line":224,"column":1,"offset":7228},"end":{"line":224,"column":15,"offset":7242},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added configurable streaming port and quality. ","position":{"start":{"line":226,"column":3,"offset":7246},"end":{"line":226,"column":50,"offset":7293},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/41","children":[{"type":"text","value":"#41","position":{"start":{"line":226,"column":51,"offset":7294},"end":{"line":226,"column":54,"offset":7297},"indent":[]}}],"position":{"start":{"line":226,"column":50,"offset":7293},"end":{"line":226,"column":107,"offset":7350},"indent":[]}}],"position":{"start":{"line":226,"column":3,"offset":7246},"end":{"line":226,"column":107,"offset":7350},"indent":[]}}],"position":{"start":{"line":226,"column":1,"offset":7244},"end":{"line":226,"column":107,"offset":7350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added new algorithm: Background subtraction.","position":{"start":{"line":227,"column":3,"offset":7353},"end":{"line":227,"column":47,"offset":7397},"indent":[]}}],"position":{"start":{"line":227,"column":3,"offset":7353},"end":{"line":227,"column":47,"offset":7397},"indent":[]}}],"position":{"start":{"line":227,"column":1,"offset":7351},"end":{"line":227,"column":47,"offset":7397},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added new heuristic: Counter (for object/people counting). ","position":{"start":{"line":228,"column":3,"offset":7400},"end":{"line":228,"column":62,"offset":7459},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/42","children":[{"type":"text","value":"#42","position":{"start":{"line":228,"column":63,"offset":7460},"end":{"line":228,"column":66,"offset":7463},"indent":[]}}],"position":{"start":{"line":228,"column":62,"offset":7459},"end":{"line":228,"column":119,"offset":7516},"indent":[]}}],"position":{"start":{"line":228,"column":3,"offset":7400},"end":{"line":228,"column":119,"offset":7516},"indent":[]}}],"position":{"start":{"line":228,"column":1,"offset":7398},"end":{"line":228,"column":119,"offset":7516},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added video capture, which can be used for debugging purposes (replay a video fragment).","position":{"start":{"line":229,"column":3,"offset":7519},"end":{"line":229,"column":91,"offset":7607},"indent":[]}}],"position":{"start":{"line":229,"column":3,"offset":7519},"end":{"line":229,"column":91,"offset":7607},"indent":[]}}],"position":{"start":{"line":229,"column":1,"offset":7517},"end":{"line":229,"column":91,"offset":7607},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"It’s now possible to mark the images with a timestamp. ","position":{"start":{"line":230,"column":3,"offset":7610},"end":{"line":230,"column":58,"offset":7665},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/36","children":[{"type":"text","value":"#36","position":{"start":{"line":230,"column":59,"offset":7666},"end":{"line":230,"column":62,"offset":7669},"indent":[]}}],"position":{"start":{"line":230,"column":58,"offset":7665},"end":{"line":230,"column":115,"offset":7722},"indent":[]}}],"position":{"start":{"line":230,"column":3,"offset":7610},"end":{"line":230,"column":115,"offset":7722},"indent":[]}}],"position":{"start":{"line":230,"column":1,"offset":7608},"end":{"line":230,"column":115,"offset":7722},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fixed blocking streaming socket. ","position":{"start":{"line":231,"column":3,"offset":7725},"end":{"line":231,"column":36,"offset":7758},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/39","children":[{"type":"text","value":"#39","position":{"start":{"line":231,"column":37,"offset":7759},"end":{"line":231,"column":40,"offset":7762},"indent":[]}}],"position":{"start":{"line":231,"column":36,"offset":7758},"end":{"line":231,"column":93,"offset":7815},"indent":[]}}],"position":{"start":{"line":231,"column":3,"offset":7725},"end":{"line":231,"column":93,"offset":7815},"indent":[]}}],"position":{"start":{"line":231,"column":1,"offset":7723},"end":{"line":231,"column":93,"offset":7815},"indent":[]}}],"position":{"start":{"line":226,"column":1,"offset":7244},"end":{"line":231,"column":93,"offset":7815},"indent":[1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Ecosystem","position":{"start":{"line":233,"column":6,"offset":7822},"end":{"line":233,"column":15,"offset":7831},"indent":[]}}],"position":{"start":{"line":233,"column":1,"offset":7817},"end":{"line":233,"column":15,"offset":7831},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fix removal images if disk is almost full (wrong path was defined).","position":{"start":{"line":235,"column":3,"offset":7835},"end":{"line":235,"column":70,"offset":7902},"indent":[]}}],"position":{"start":{"line":235,"column":3,"offset":7835},"end":{"line":235,"column":70,"offset":7902},"indent":[]}}],"position":{"start":{"line":235,"column":1,"offset":7833},"end":{"line":235,"column":70,"offset":7902},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support for the Raspberry Pi Camera module v2.1. ","position":{"start":{"line":236,"column":3,"offset":7905},"end":{"line":236,"column":52,"offset":7954},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/kios/issues/3","children":[{"type":"text","value":"#3","position":{"start":{"line":236,"column":53,"offset":7955},"end":{"line":236,"column":55,"offset":7957},"indent":[]}}],"position":{"start":{"line":236,"column":52,"offset":7954},"end":{"line":236,"column":102,"offset":8004},"indent":[]}}],"position":{"start":{"line":236,"column":3,"offset":7905},"end":{"line":236,"column":102,"offset":8004},"indent":[]}}],"position":{"start":{"line":236,"column":1,"offset":7903},"end":{"line":236,"column":102,"offset":8004},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support for the Raspberry Pi Zero; updated kernel to latest Raspbian. ","position":{"start":{"line":237,"column":3,"offset":8007},"end":{"line":237,"column":73,"offset":8077},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/kios/issues/3","children":[{"type":"text","value":"#3","position":{"start":{"line":237,"column":74,"offset":8078},"end":{"line":237,"column":76,"offset":8080},"indent":[]}}],"position":{"start":{"line":237,"column":73,"offset":8077},"end":{"line":237,"column":123,"offset":8127},"indent":[]}}],"position":{"start":{"line":237,"column":3,"offset":8007},"end":{"line":237,"column":123,"offset":8127},"indent":[]}}],"position":{"start":{"line":237,"column":1,"offset":8005},"end":{"line":237,"column":123,"offset":8127},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"KiOS GUI installer.","position":{"start":{"line":238,"column":3,"offset":8130},"end":{"line":238,"column":22,"offset":8149},"indent":[]}}],"position":{"start":{"line":238,"column":3,"offset":8130},"end":{"line":238,"column":22,"offset":8149},"indent":[]}}],"position":{"start":{"line":238,"column":1,"offset":8128},"end":{"line":238,"column":22,"offset":8149},"indent":[]}}],"position":{"start":{"line":235,"column":1,"offset":7833},"end":{"line":238,"column":22,"offset":8149},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.0.0","position":{"start":{"line":240,"column":5,"offset":8155},"end":{"line":240,"column":10,"offset":8160},"indent":[]}}],"position":{"start":{"line":240,"column":1,"offset":8151},"end":{"line":240,"column":10,"offset":8160},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":242,"column":6,"offset":8167},"end":{"line":242,"column":9,"offset":8170},"indent":[]}}],"position":{"start":{"line":242,"column":1,"offset":8162},"end":{"line":242,"column":9,"offset":8170},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Add simple ON/OFF toggle. ","position":{"start":{"line":244,"column":3,"offset":8174},"end":{"line":244,"column":29,"offset":8200},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/24","children":[{"type":"text","value":"#24","position":{"start":{"line":244,"column":30,"offset":8201},"end":{"line":244,"column":33,"offset":8204},"indent":[]}}],"position":{"start":{"line":244,"column":29,"offset":8200},"end":{"line":244,"column":80,"offset":8251},"indent":[]}}],"position":{"start":{"line":244,"column":3,"offset":8174},"end":{"line":244,"column":80,"offset":8251},"indent":[]}}],"position":{"start":{"line":244,"column":1,"offset":8172},"end":{"line":244,"column":80,"offset":8251},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added update strategy when using KiOS. ","position":{"start":{"line":245,"column":3,"offset":8254},"end":{"line":245,"column":42,"offset":8293},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/23","children":[{"type":"text","value":"#23","position":{"start":{"line":245,"column":43,"offset":8294},"end":{"line":245,"column":46,"offset":8297},"indent":[]}}],"position":{"start":{"line":245,"column":42,"offset":8293},"end":{"line":245,"column":93,"offset":8344},"indent":[]}}],"position":{"start":{"line":245,"column":3,"offset":8254},"end":{"line":245,"column":93,"offset":8344},"indent":[]}}],"position":{"start":{"line":245,"column":1,"offset":8252},"end":{"line":245,"column":93,"offset":8344},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"A system page which shows system information. ","position":{"start":{"line":246,"column":3,"offset":8347},"end":{"line":246,"column":49,"offset":8393},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/20","children":[{"type":"text","value":"#20","position":{"start":{"line":246,"column":50,"offset":8394},"end":{"line":246,"column":53,"offset":8397},"indent":[]}}],"position":{"start":{"line":246,"column":49,"offset":8393},"end":{"line":246,"column":100,"offset":8444},"indent":[]}}],"position":{"start":{"line":246,"column":3,"offset":8347},"end":{"line":246,"column":100,"offset":8444},"indent":[]}}],"position":{"start":{"line":246,"column":1,"offset":8345},"end":{"line":246,"column":100,"offset":8444},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Heatmap on dashboard page ","position":{"start":{"line":247,"column":3,"offset":8447},"end":{"line":247,"column":29,"offset":8473},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/19","children":[{"type":"text","value":"#19","position":{"start":{"line":247,"column":30,"offset":8474},"end":{"line":247,"column":33,"offset":8477},"indent":[]}}],"position":{"start":{"line":247,"column":29,"offset":8473},"end":{"line":247,"column":80,"offset":8524},"indent":[]}}],"position":{"start":{"line":247,"column":3,"offset":8447},"end":{"line":247,"column":80,"offset":8524},"indent":[]}}],"position":{"start":{"line":247,"column":1,"offset":8445},"end":{"line":247,"column":80,"offset":8524},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added live stream view on the dashboard page ","position":{"start":{"line":248,"column":3,"offset":8527},"end":{"line":248,"column":48,"offset":8572},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/2","children":[{"type":"text","value":"#2","position":{"start":{"line":248,"column":49,"offset":8573},"end":{"line":248,"column":51,"offset":8575},"indent":[]}}],"position":{"start":{"line":248,"column":48,"offset":8572},"end":{"line":248,"column":97,"offset":8621},"indent":[]}}],"position":{"start":{"line":248,"column":3,"offset":8527},"end":{"line":248,"column":97,"offset":8621},"indent":[]}}],"position":{"start":{"line":248,"column":1,"offset":8525},"end":{"line":248,"column":97,"offset":8621},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fixed bug cloud syncing ","position":{"start":{"line":249,"column":3,"offset":8624},"end":{"line":249,"column":27,"offset":8648},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/16","children":[{"type":"text","value":"#16","position":{"start":{"line":249,"column":28,"offset":8649},"end":{"line":249,"column":31,"offset":8652},"indent":[]}}],"position":{"start":{"line":249,"column":27,"offset":8648},"end":{"line":249,"column":78,"offset":8699},"indent":[]}}],"position":{"start":{"line":249,"column":3,"offset":8624},"end":{"line":249,"column":78,"offset":8699},"indent":[]}}],"position":{"start":{"line":249,"column":1,"offset":8622},"end":{"line":249,"column":78,"offset":8699},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fixed broken settings page when space in instane name ","position":{"start":{"line":250,"column":3,"offset":8702},"end":{"line":250,"column":57,"offset":8756},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/16","children":[{"type":"text","value":"#16","position":{"start":{"line":250,"column":58,"offset":8757},"end":{"line":250,"column":61,"offset":8760},"indent":[]}}],"position":{"start":{"line":250,"column":57,"offset":8756},"end":{"line":250,"column":108,"offset":8807},"indent":[]}}],"position":{"start":{"line":250,"column":3,"offset":8702},"end":{"line":250,"column":108,"offset":8807},"indent":[]}}],"position":{"start":{"line":250,"column":1,"offset":8700},"end":{"line":250,"column":108,"offset":8807},"indent":[]}}],"position":{"start":{"line":244,"column":1,"offset":8172},"end":{"line":250,"column":108,"offset":8807},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":252,"column":6,"offset":8814},"end":{"line":252,"column":15,"offset":8823},"indent":[]}}],"position":{"start":{"line":252,"column":1,"offset":8809},"end":{"line":252,"column":15,"offset":8823},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"RTSP support for IP-camera's. ","position":{"start":{"line":254,"column":3,"offset":8827},"end":{"line":254,"column":33,"offset":8857},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/21","children":[{"type":"text","value":"#21","position":{"start":{"line":254,"column":34,"offset":8858},"end":{"line":254,"column":37,"offset":8861},"indent":[]}}],"position":{"start":{"line":254,"column":33,"offset":8857},"end":{"line":254,"column":90,"offset":8914},"indent":[]}}],"position":{"start":{"line":254,"column":3,"offset":8827},"end":{"line":254,"column":90,"offset":8914},"indent":[]}}],"position":{"start":{"line":254,"column":1,"offset":8825},"end":{"line":254,"column":90,"offset":8914},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Verbose logging. ","position":{"start":{"line":255,"column":3,"offset":8917},"end":{"line":255,"column":20,"offset":8934},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/35","children":[{"type":"text","value":"#35","position":{"start":{"line":255,"column":21,"offset":8935},"end":{"line":255,"column":24,"offset":8938},"indent":[]}}],"position":{"start":{"line":255,"column":20,"offset":8934},"end":{"line":255,"column":77,"offset":8991},"indent":[]}}],"position":{"start":{"line":255,"column":3,"offset":8917},"end":{"line":255,"column":77,"offset":8991},"indent":[]}}],"position":{"start":{"line":255,"column":1,"offset":8915},"end":{"line":255,"column":77,"offset":8991},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"IO-devices are executed in a seperate thread. ","position":{"start":{"line":256,"column":3,"offset":8994},"end":{"line":256,"column":49,"offset":9040},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/28","children":[{"type":"text","value":"#28","position":{"start":{"line":256,"column":50,"offset":9041},"end":{"line":256,"column":53,"offset":9044},"indent":[]}}],"position":{"start":{"line":256,"column":49,"offset":9040},"end":{"line":256,"column":106,"offset":9097},"indent":[]}}],"position":{"start":{"line":256,"column":3,"offset":8994},"end":{"line":256,"column":106,"offset":9097},"indent":[]}}],"position":{"start":{"line":256,"column":1,"offset":8992},"end":{"line":256,"column":106,"offset":9097},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Live streaming (MJPEG). ","position":{"start":{"line":257,"column":3,"offset":9100},"end":{"line":257,"column":27,"offset":9124},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/26","children":[{"type":"text","value":"#26","position":{"start":{"line":257,"column":28,"offset":9125},"end":{"line":257,"column":31,"offset":9128},"indent":[]}}],"position":{"start":{"line":257,"column":27,"offset":9124},"end":{"line":257,"column":84,"offset":9181},"indent":[]}}],"position":{"start":{"line":257,"column":3,"offset":9100},"end":{"line":257,"column":84,"offset":9181},"indent":[]}}],"position":{"start":{"line":257,"column":1,"offset":9098},"end":{"line":257,"column":84,"offset":9181},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Execute multiple instances on a machine. ","position":{"start":{"line":258,"column":3,"offset":9184},"end":{"line":258,"column":44,"offset":9225},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/24","children":[{"type":"text","value":"#24","position":{"start":{"line":258,"column":45,"offset":9226},"end":{"line":258,"column":48,"offset":9229},"indent":[]}}],"position":{"start":{"line":258,"column":44,"offset":9225},"end":{"line":258,"column":101,"offset":9282},"indent":[]}}],"position":{"start":{"line":258,"column":3,"offset":9184},"end":{"line":258,"column":101,"offset":9282},"indent":[]}}],"position":{"start":{"line":258,"column":1,"offset":9182},"end":{"line":258,"column":101,"offset":9282},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Override config by arguments. ","position":{"start":{"line":259,"column":3,"offset":9285},"end":{"line":259,"column":33,"offset":9315},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/22","children":[{"type":"text","value":"#22","position":{"start":{"line":259,"column":34,"offset":9316},"end":{"line":259,"column":37,"offset":9319},"indent":[]}}],"position":{"start":{"line":259,"column":33,"offset":9315},"end":{"line":259,"column":90,"offset":9372},"indent":[]}}],"position":{"start":{"line":259,"column":3,"offset":9285},"end":{"line":259,"column":90,"offset":9372},"indent":[]}}],"position":{"start":{"line":259,"column":1,"offset":9283},"end":{"line":259,"column":90,"offset":9372},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Move S3 upload to machinery and remove sync-s3 repository. ","position":{"start":{"line":260,"column":3,"offset":9375},"end":{"line":260,"column":62,"offset":9434},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/16","children":[{"type":"text","value":"#16","position":{"start":{"line":260,"column":63,"offset":9435},"end":{"line":260,"column":66,"offset":9438},"indent":[]}}],"position":{"start":{"line":260,"column":62,"offset":9434},"end":{"line":260,"column":119,"offset":9491},"indent":[]}}],"position":{"start":{"line":260,"column":3,"offset":9375},"end":{"line":260,"column":119,"offset":9491},"indent":[]}}],"position":{"start":{"line":260,"column":1,"offset":9373},"end":{"line":260,"column":119,"offset":9491},"indent":[]}}],"position":{"start":{"line":254,"column":1,"offset":8825},"end":{"line":260,"column":119,"offset":9491},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Docker","position":{"start":{"line":262,"column":6,"offset":9498},"end":{"line":262,"column":12,"offset":9504},"indent":[]}}],"position":{"start":{"line":262,"column":1,"offset":9493},"end":{"line":262,"column":12,"offset":9504},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added Docker image (x86_x64) to Docker Hub.","position":{"start":{"line":264,"column":3,"offset":9508},"end":{"line":264,"column":46,"offset":9551},"indent":[]}}],"position":{"start":{"line":264,"column":3,"offset":9508},"end":{"line":264,"column":46,"offset":9551},"indent":[]}}],"position":{"start":{"line":264,"column":1,"offset":9506},"end":{"line":264,"column":46,"offset":9551},"indent":[]}}],"position":{"start":{"line":264,"column":1,"offset":9506},"end":{"line":264,"column":46,"offset":9551},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Ecosystem","position":{"start":{"line":266,"column":6,"offset":9558},"end":{"line":266,"column":15,"offset":9567},"indent":[]}}],"position":{"start":{"line":266,"column":1,"offset":9553},"end":{"line":266,"column":15,"offset":9567},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Add support for Raspberry Pi 1, 2 and 3. ","position":{"start":{"line":268,"column":3,"offset":9571},"end":{"line":268,"column":44,"offset":9612},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/kios/issues/1","children":[{"type":"text","value":"#1","position":{"start":{"line":268,"column":45,"offset":9613},"end":{"line":268,"column":47,"offset":9615},"indent":[]}}],"position":{"start":{"line":268,"column":44,"offset":9612},"end":{"line":268,"column":94,"offset":9662},"indent":[]}}],"position":{"start":{"line":268,"column":3,"offset":9571},"end":{"line":268,"column":94,"offset":9662},"indent":[]}}],"position":{"start":{"line":268,"column":1,"offset":9569},"end":{"line":268,"column":94,"offset":9662},"indent":[]}}],"position":{"start":{"line":268,"column":1,"offset":9569},"end":{"line":268,"column":94,"offset":9662},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1.1.0","position":{"start":{"line":270,"column":5,"offset":9668},"end":{"line":270,"column":10,"offset":9673},"indent":[]}}],"position":{"start":{"line":270,"column":1,"offset":9664},"end":{"line":270,"column":10,"offset":9673},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":272,"column":6,"offset":9680},"end":{"line":272,"column":9,"offset":9683},"indent":[]}}],"position":{"start":{"line":272,"column":1,"offset":9675},"end":{"line":272,"column":9,"offset":9683},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support IP camera's with MJPEG stream. ","position":{"start":{"line":274,"column":3,"offset":9687},"end":{"line":274,"column":42,"offset":9726},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/3","children":[{"type":"text","value":"#3","position":{"start":{"line":274,"column":43,"offset":9727},"end":{"line":274,"column":45,"offset":9729},"indent":[]}}],"position":{"start":{"line":274,"column":42,"offset":9726},"end":{"line":274,"column":91,"offset":9775},"indent":[]}}],"position":{"start":{"line":274,"column":3,"offset":9687},"end":{"line":274,"column":91,"offset":9775},"indent":[]}}],"position":{"start":{"line":274,"column":1,"offset":9685},"end":{"line":274,"column":91,"offset":9775},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Introduce new API methods to configure the machinery, using basic auth. ","position":{"start":{"line":275,"column":3,"offset":9778},"end":{"line":275,"column":75,"offset":9850},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/4","children":[{"type":"text","value":"#4","position":{"start":{"line":275,"column":76,"offset":9851},"end":{"line":275,"column":78,"offset":9853},"indent":[]}}],"position":{"start":{"line":275,"column":75,"offset":9850},"end":{"line":275,"column":124,"offset":9899},"indent":[]}}],"position":{"start":{"line":275,"column":3,"offset":9778},"end":{"line":275,"column":124,"offset":9899},"indent":[]}}],"position":{"start":{"line":275,"column":1,"offset":9776},"end":{"line":275,"column":124,"offset":9899},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Optimization of loading image and dashboard page, completely redesigned the retrieval of images. ","position":{"start":{"line":276,"column":3,"offset":9902},"end":{"line":276,"column":100,"offset":9999},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/5","children":[{"type":"text","value":"#5","position":{"start":{"line":276,"column":101,"offset":10000},"end":{"line":276,"column":103,"offset":10002},"indent":[]}}],"position":{"start":{"line":276,"column":100,"offset":9999},"end":{"line":276,"column":149,"offset":10048},"indent":[]}}],"position":{"start":{"line":276,"column":3,"offset":9902},"end":{"line":276,"column":149,"offset":10048},"indent":[]}}],"position":{"start":{"line":276,"column":1,"offset":9900},"end":{"line":276,"column":149,"offset":10048},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Optimization of settings page. ","position":{"start":{"line":277,"column":3,"offset":10051},"end":{"line":277,"column":34,"offset":10082},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/5","children":[{"type":"text","value":"#5","position":{"start":{"line":277,"column":35,"offset":10083},"end":{"line":277,"column":37,"offset":10085},"indent":[]}}],"position":{"start":{"line":277,"column":34,"offset":10082},"end":{"line":277,"column":83,"offset":10131},"indent":[]}}],"position":{"start":{"line":277,"column":3,"offset":10051},"end":{"line":277,"column":83,"offset":10131},"indent":[]}}],"position":{"start":{"line":277,"column":1,"offset":10049},"end":{"line":277,"column":83,"offset":10131},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Timebar gradient only works in Chrome. ","position":{"start":{"line":278,"column":3,"offset":10134},"end":{"line":278,"column":42,"offset":10173},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/6","children":[{"type":"text","value":"#6","position":{"start":{"line":278,"column":43,"offset":10174},"end":{"line":278,"column":45,"offset":10176},"indent":[]}}],"position":{"start":{"line":278,"column":42,"offset":10173},"end":{"line":278,"column":91,"offset":10222},"indent":[]}}],"position":{"start":{"line":278,"column":3,"offset":10134},"end":{"line":278,"column":91,"offset":10222},"indent":[]}}],"position":{"start":{"line":278,"column":1,"offset":10132},"end":{"line":278,"column":91,"offset":10222},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Minor CSS fixes for responsive layout.","position":{"start":{"line":279,"column":3,"offset":10225},"end":{"line":279,"column":41,"offset":10263},"indent":[]}}],"position":{"start":{"line":279,"column":3,"offset":10225},"end":{"line":279,"column":41,"offset":10263},"indent":[]}}],"position":{"start":{"line":279,"column":1,"offset":10223},"end":{"line":279,"column":41,"offset":10263},"indent":[]}}],"position":{"start":{"line":274,"column":1,"offset":9685},"end":{"line":279,"column":41,"offset":10263},"indent":[1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":281,"column":6,"offset":10270},"end":{"line":281,"column":15,"offset":10279},"indent":[]}}],"position":{"start":{"line":281,"column":1,"offset":10265},"end":{"line":281,"column":15,"offset":10279},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Flip/rotate option for capture devices. ","position":{"start":{"line":283,"column":3,"offset":10283},"end":{"line":283,"column":43,"offset":10323},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/1","children":[{"type":"text","value":"#5","position":{"start":{"line":283,"column":44,"offset":10324},"end":{"line":283,"column":46,"offset":10326},"indent":[]}}],"position":{"start":{"line":283,"column":43,"offset":10323},"end":{"line":283,"column":98,"offset":10378},"indent":[]}}],"position":{"start":{"line":283,"column":3,"offset":10283},"end":{"line":283,"column":98,"offset":10378},"indent":[]}}],"position":{"start":{"line":283,"column":1,"offset":10281},"end":{"line":283,"column":98,"offset":10378},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support IP camera's with MJPEG stream. ","position":{"start":{"line":284,"column":3,"offset":10381},"end":{"line":284,"column":42,"offset":10420},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/4","children":[{"type":"text","value":"#4","position":{"start":{"line":284,"column":43,"offset":10421},"end":{"line":284,"column":45,"offset":10423},"indent":[]}}],"position":{"start":{"line":284,"column":42,"offset":10420},"end":{"line":284,"column":97,"offset":10475},"indent":[]}}],"position":{"start":{"line":284,"column":3,"offset":10381},"end":{"line":284,"column":97,"offset":10475},"indent":[]}}],"position":{"start":{"line":284,"column":1,"offset":10379},"end":{"line":284,"column":97,"offset":10475},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Introduced webhook io device. ","position":{"start":{"line":285,"column":3,"offset":10478},"end":{"line":285,"column":33,"offset":10508},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/5","children":[{"type":"text","value":"#5","position":{"start":{"line":285,"column":34,"offset":10509},"end":{"line":285,"column":36,"offset":10511},"indent":[]}}],"position":{"start":{"line":285,"column":33,"offset":10508},"end":{"line":285,"column":88,"offset":10563},"indent":[]}}],"position":{"start":{"line":285,"column":3,"offset":10478},"end":{"line":285,"column":88,"offset":10563},"indent":[]}}],"position":{"start":{"line":285,"column":1,"offset":10476},"end":{"line":285,"column":88,"offset":10563},"indent":[]}}],"position":{"start":{"line":283,"column":1,"offset":10281},"end":{"line":285,"column":88,"offset":10563},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Cloud","position":{"start":{"line":287,"column":6,"offset":10570},"end":{"line":287,"column":11,"offset":10575},"indent":[]}}],"position":{"start":{"line":287,"column":1,"offset":10565},"end":{"line":287,"column":11,"offset":10575},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fixed problem when syncing a huge amount of images. ","position":{"start":{"line":289,"column":3,"offset":10579},"end":{"line":289,"column":55,"offset":10631},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/sync-s3/issues/1","children":[{"type":"text","value":"#1","position":{"start":{"line":289,"column":56,"offset":10632},"end":{"line":289,"column":58,"offset":10634},"indent":[]}}],"position":{"start":{"line":289,"column":55,"offset":10631},"end":{"line":289,"column":108,"offset":10684},"indent":[]}}],"position":{"start":{"line":289,"column":3,"offset":10579},"end":{"line":289,"column":108,"offset":10684},"indent":[]}}],"position":{"start":{"line":289,"column":1,"offset":10577},"end":{"line":289,"column":108,"offset":10684},"indent":[]}}],"position":{"start":{"line":289,"column":1,"offset":10577},"end":{"line":289,"column":108,"offset":10684},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1.0.3","position":{"start":{"line":291,"column":5,"offset":10690},"end":{"line":291,"column":10,"offset":10695},"indent":[]}}],"position":{"start":{"line":291,"column":1,"offset":10686},"end":{"line":291,"column":10,"offset":10695},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":293,"column":6,"offset":10702},"end":{"line":293,"column":9,"offset":10705},"indent":[]}}],"position":{"start":{"line":293,"column":1,"offset":10697},"end":{"line":293,"column":9,"offset":10705},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Optimize performance, new datastructure has been implemented.","position":{"start":{"line":295,"column":3,"offset":10709},"end":{"line":295,"column":64,"offset":10770},"indent":[]}}],"position":{"start":{"line":295,"column":3,"offset":10709},"end":{"line":295,"column":64,"offset":10770},"indent":[]}}],"position":{"start":{"line":295,"column":1,"offset":10707},"end":{"line":295,"column":64,"offset":10770},"indent":[]}}],"position":{"start":{"line":295,"column":1,"offset":10707},"end":{"line":295,"column":64,"offset":10770},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":297,"column":6,"offset":10777},"end":{"line":297,"column":15,"offset":10786},"indent":[]}}],"position":{"start":{"line":297,"column":1,"offset":10772},"end":{"line":297,"column":15,"offset":10786},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Memory optimization.","position":{"start":{"line":299,"column":3,"offset":10790},"end":{"line":299,"column":23,"offset":10810},"indent":[]}}],"position":{"start":{"line":299,"column":3,"offset":10790},"end":{"line":299,"column":23,"offset":10810},"indent":[]}}],"position":{"start":{"line":299,"column":1,"offset":10788},"end":{"line":299,"column":23,"offset":10810},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Removal of images older than 3 days have been removed.","position":{"start":{"line":300,"column":3,"offset":10813},"end":{"line":300,"column":57,"offset":10867},"indent":[]}}],"position":{"start":{"line":300,"column":3,"offset":10813},"end":{"line":300,"column":57,"offset":10867},"indent":[]}}],"position":{"start":{"line":300,"column":1,"offset":10811},"end":{"line":300,"column":57,"offset":10867},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Start machinery automatically (delay has been removed).","position":{"start":{"line":301,"column":3,"offset":10870},"end":{"line":301,"column":58,"offset":10925},"indent":[]}}],"position":{"start":{"line":301,"column":3,"offset":10870},"end":{"line":301,"column":58,"offset":10925},"indent":[]}}],"position":{"start":{"line":301,"column":1,"offset":10868},"end":{"line":301,"column":58,"offset":10925},"indent":[]}}],"position":{"start":{"line":299,"column":1,"offset":10788},"end":{"line":301,"column":58,"offset":10925},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Cloud","position":{"start":{"line":303,"column":6,"offset":10932},"end":{"line":303,"column":11,"offset":10937},"indent":[]}}],"position":{"start":{"line":303,"column":1,"offset":10927},"end":{"line":303,"column":11,"offset":10937},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Resolved file exist problem.","position":{"start":{"line":305,"column":3,"offset":10941},"end":{"line":305,"column":31,"offset":10969},"indent":[]}}],"position":{"start":{"line":305,"column":3,"offset":10941},"end":{"line":305,"column":31,"offset":10969},"indent":[]}}],"position":{"start":{"line":305,"column":1,"offset":10939},"end":{"line":305,"column":31,"offset":10969},"indent":[]}}],"position":{"start":{"line":305,"column":1,"offset":10939},"end":{"line":305,"column":31,"offset":10969},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1.0.2","position":{"start":{"line":307,"column":5,"offset":10975},"end":{"line":307,"column":10,"offset":10980},"indent":[]}}],"position":{"start":{"line":307,"column":1,"offset":10971},"end":{"line":307,"column":10,"offset":10980},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":309,"column":6,"offset":10987},"end":{"line":309,"column":9,"offset":10990},"indent":[]}}],"position":{"start":{"line":309,"column":1,"offset":10982},"end":{"line":309,"column":9,"offset":10990},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Timezone on settings page is also used for the webinterface.","position":{"start":{"line":311,"column":3,"offset":10994},"end":{"line":311,"column":63,"offset":11054},"indent":[]}}],"position":{"start":{"line":311,"column":3,"offset":10994},"end":{"line":311,"column":63,"offset":11054},"indent":[]}}],"position":{"start":{"line":311,"column":1,"offset":10992},"end":{"line":311,"column":63,"offset":11054},"indent":[]}}],"position":{"start":{"line":311,"column":1,"offset":10992},"end":{"line":311,"column":63,"offset":11054},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":313,"column":6,"offset":11061},"end":{"line":313,"column":15,"offset":11070},"indent":[]}}],"position":{"start":{"line":313,"column":1,"offset":11056},"end":{"line":313,"column":15,"offset":11070},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added extra timezones to timezone.xml.","position":{"start":{"line":315,"column":3,"offset":11074},"end":{"line":315,"column":41,"offset":11112},"indent":[]}}],"position":{"start":{"line":315,"column":3,"offset":11074},"end":{"line":315,"column":41,"offset":11112},"indent":[]}}],"position":{"start":{"line":315,"column":1,"offset":11072},"end":{"line":315,"column":41,"offset":11112},"indent":[]}}],"position":{"start":{"line":315,"column":1,"offset":11072},"end":{"line":315,"column":41,"offset":11112},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1.0.1","position":{"start":{"line":317,"column":5,"offset":11118},"end":{"line":317,"column":10,"offset":11123},"indent":[]}}],"position":{"start":{"line":317,"column":1,"offset":11114},"end":{"line":317,"column":10,"offset":11123},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":319,"column":6,"offset":11130},"end":{"line":319,"column":9,"offset":11133},"indent":[]}}],"position":{"start":{"line":319,"column":1,"offset":11125},"end":{"line":319,"column":9,"offset":11133},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Improved error handling (date search).","position":{"start":{"line":321,"column":3,"offset":11137},"end":{"line":321,"column":41,"offset":11175},"indent":[]}}],"position":{"start":{"line":321,"column":3,"offset":11137},"end":{"line":321,"column":41,"offset":11175},"indent":[]}}],"position":{"start":{"line":321,"column":1,"offset":11135},"end":{"line":321,"column":41,"offset":11175},"indent":[]}}],"position":{"start":{"line":321,"column":1,"offset":11135},"end":{"line":321,"column":41,"offset":11175},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":323,"column":6,"offset":11182},"end":{"line":323,"column":15,"offset":11191},"indent":[]}}],"position":{"start":{"line":323,"column":1,"offset":11177},"end":{"line":323,"column":15,"offset":11191},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Improved memory cleanup.","position":{"start":{"line":325,"column":3,"offset":11195},"end":{"line":325,"column":27,"offset":11219},"indent":[]}}],"position":{"start":{"line":325,"column":3,"offset":11195},"end":{"line":325,"column":27,"offset":11219},"indent":[]}}],"position":{"start":{"line":325,"column":1,"offset":11193},"end":{"line":325,"column":27,"offset":11219},"indent":[]}}],"position":{"start":{"line":325,"column":1,"offset":11193},"end":{"line":325,"column":27,"offset":11219},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1.0.0","position":{"start":{"line":327,"column":5,"offset":11225},"end":{"line":327,"column":10,"offset":11230},"indent":[]}}],"position":{"start":{"line":327,"column":1,"offset":11221},"end":{"line":327,"column":10,"offset":11230},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"First commit of Kerberos.io","position":{"start":{"line":329,"column":6,"offset":11237},"end":{"line":329,"column":33,"offset":11264},"indent":[]}}],"position":{"start":{"line":329,"column":1,"offset":11232},"end":{"line":329,"column":33,"offset":11264},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Camera support: ","position":{"start":{"line":331,"column":3,"offset":11268},"end":{"line":331,"column":19,"offset":11284},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"USBCamera","position":{"start":{"line":331,"column":21,"offset":11286},"end":{"line":331,"column":30,"offset":11295},"indent":[]}}],"position":{"start":{"line":331,"column":19,"offset":11284},"end":{"line":331,"column":32,"offset":11297},"indent":[]}},{"type":"text","value":" (V4L), ","position":{"start":{"line":331,"column":32,"offset":11297},"end":{"line":331,"column":40,"offset":11305},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Raspberry Pi camera module","position":{"start":{"line":331,"column":42,"offset":11307},"end":{"line":331,"column":68,"offset":11333},"indent":[]}}],"position":{"start":{"line":331,"column":40,"offset":11305},"end":{"line":331,"column":70,"offset":11335},"indent":[]}},{"type":"text","value":" (MMAL).","position":{"start":{"line":331,"column":70,"offset":11335},"end":{"line":331,"column":78,"offset":11343},"indent":[]}}],"position":{"start":{"line":331,"column":3,"offset":11268},"end":{"line":331,"column":78,"offset":11343},"indent":[]}}],"position":{"start":{"line":331,"column":1,"offset":11266},"end":{"line":331,"column":78,"offset":11343},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Conditions: ","position":{"start":{"line":332,"column":3,"offset":11346},"end":{"line":332,"column":15,"offset":11358},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Enabled","position":{"start":{"line":332,"column":17,"offset":11360},"end":{"line":332,"column":24,"offset":11367},"indent":[]}}],"position":{"start":{"line":332,"column":15,"offset":11358},"end":{"line":332,"column":26,"offset":11369},"indent":[]}},{"type":"text","value":" (turn on/off Kerberos) and active ","position":{"start":{"line":332,"column":26,"offset":11369},"end":{"line":332,"column":61,"offset":11404},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Time","position":{"start":{"line":332,"column":63,"offset":11406},"end":{"line":332,"column":67,"offset":11410},"indent":[]}}],"position":{"start":{"line":332,"column":61,"offset":11404},"end":{"line":332,"column":69,"offset":11412},"indent":[]}},{"type":"text","value":" per day.","position":{"start":{"line":332,"column":69,"offset":11412},"end":{"line":332,"column":78,"offset":11421},"indent":[]}}],"position":{"start":{"line":332,"column":3,"offset":11346},"end":{"line":332,"column":78,"offset":11421},"indent":[]}}],"position":{"start":{"line":332,"column":1,"offset":11344},"end":{"line":332,"column":78,"offset":11421},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Algorithms: ","position":{"start":{"line":333,"column":3,"offset":11424},"end":{"line":333,"column":15,"offset":11436},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Differential Images","position":{"start":{"line":333,"column":17,"offset":11438},"end":{"line":333,"column":36,"offset":11457},"indent":[]}}],"position":{"start":{"line":333,"column":15,"offset":11436},"end":{"line":333,"column":38,"offset":11459},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":333,"column":38,"offset":11459},"end":{"line":333,"column":39,"offset":11460},"indent":[]}}],"position":{"start":{"line":333,"column":3,"offset":11424},"end":{"line":333,"column":39,"offset":11460},"indent":[]}}],"position":{"start":{"line":333,"column":1,"offset":11422},"end":{"line":333,"column":39,"offset":11460},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Heuristics: ","position":{"start":{"line":334,"column":3,"offset":11463},"end":{"line":334,"column":15,"offset":11475},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Sequence","position":{"start":{"line":334,"column":17,"offset":11477},"end":{"line":334,"column":25,"offset":11485},"indent":[]}}],"position":{"start":{"line":334,"column":15,"offset":11475},"end":{"line":334,"column":27,"offset":11487},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":334,"column":27,"offset":11487},"end":{"line":334,"column":28,"offset":11488},"indent":[]}}],"position":{"start":{"line":334,"column":3,"offset":11463},"end":{"line":334,"column":28,"offset":11488},"indent":[]}}],"position":{"start":{"line":334,"column":1,"offset":11461},"end":{"line":334,"column":28,"offset":11488},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Expositors: Select a ","position":{"start":{"line":335,"column":3,"offset":11491},"end":{"line":335,"column":24,"offset":11512},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Hull","position":{"start":{"line":335,"column":26,"offset":11514},"end":{"line":335,"column":30,"offset":11518},"indent":[]}}],"position":{"start":{"line":335,"column":24,"offset":11512},"end":{"line":335,"column":32,"offset":11520},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":335,"column":32,"offset":11520},"end":{"line":335,"column":36,"offset":11524},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Rectangle","position":{"start":{"line":335,"column":38,"offset":11526},"end":{"line":335,"column":47,"offset":11535},"indent":[]}}],"position":{"start":{"line":335,"column":36,"offset":11524},"end":{"line":335,"column":49,"offset":11537},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":335,"column":49,"offset":11537},"end":{"line":335,"column":50,"offset":11538},"indent":[]}}],"position":{"start":{"line":335,"column":3,"offset":11491},"end":{"line":335,"column":50,"offset":11538},"indent":[]}}],"position":{"start":{"line":335,"column":1,"offset":11489},"end":{"line":335,"column":50,"offset":11538},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Outputs: Write image to ","position":{"start":{"line":336,"column":3,"offset":11541},"end":{"line":336,"column":27,"offset":11565},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Disk","position":{"start":{"line":336,"column":29,"offset":11567},"end":{"line":336,"column":33,"offset":11571},"indent":[]}}],"position":{"start":{"line":336,"column":27,"offset":11565},"end":{"line":336,"column":35,"offset":11573},"indent":[]}},{"type":"text","value":", trigger an ","position":{"start":{"line":336,"column":35,"offset":11573},"end":{"line":336,"column":48,"offset":11586},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"GPIO","position":{"start":{"line":336,"column":50,"offset":11588},"end":{"line":336,"column":54,"offset":11592},"indent":[]}}],"position":{"start":{"line":336,"column":48,"offset":11586},"end":{"line":336,"column":56,"offset":11594},"indent":[]}},{"type":"text","value":" output pin and send a ","position":{"start":{"line":336,"column":56,"offset":11594},"end":{"line":336,"column":79,"offset":11617},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"TCP/IP packet","position":{"start":{"line":336,"column":81,"offset":11619},"end":{"line":336,"column":94,"offset":11632},"indent":[]}}],"position":{"start":{"line":336,"column":79,"offset":11617},"end":{"line":336,"column":96,"offset":11634},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":336,"column":96,"offset":11634},"end":{"line":336,"column":97,"offset":11635},"indent":[]}}],"position":{"start":{"line":336,"column":3,"offset":11541},"end":{"line":336,"column":97,"offset":11635},"indent":[]}}],"position":{"start":{"line":336,"column":1,"offset":11539},"end":{"line":336,"column":97,"offset":11635},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Cloud: send your images to the ","position":{"start":{"line":337,"column":3,"offset":11638},"end":{"line":337,"column":34,"offset":11669},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Kerberos.io cloud aplication","position":{"start":{"line":337,"column":36,"offset":11671},"end":{"line":337,"column":64,"offset":11699},"indent":[]}}],"position":{"start":{"line":337,"column":34,"offset":11669},"end":{"line":337,"column":66,"offset":11701},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":337,"column":66,"offset":11701},"end":{"line":337,"column":67,"offset":11702},"indent":[]}}],"position":{"start":{"line":337,"column":3,"offset":11638},"end":{"line":337,"column":67,"offset":11702},"indent":[]}}],"position":{"start":{"line":337,"column":1,"offset":11636},"end":{"line":337,"column":67,"offset":11702},"indent":[]}}],"position":{"start":{"line":331,"column":1,"offset":11266},"end":{"line":337,"column":67,"offset":11702},"indent":[1,1,1,1,1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":340,"column":1,"offset":11705},"end":{"line":340,"column":31,"offset":11735},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":340,"column":31,"offset":11735}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Release notes`}

\n

{`2.8.0`}

\n

{`Aligned machinery, web and KiOS versions. Too many people were confused by the versioning.`}

\n

{`Web`}

\n
    \n
  • {`Videos displayed on canvas were blocked in latest browsers.`}
    • \n
  • {`Disabled reboot and shutdown.`}
    • \n
  • {`Disabled upgrade process, use fwupdate shell command instead.`}
    • \n
\n

{`KiOS`}

\n
    \n
  • {`Major upgrade, solved many different problems (list to long); not possible to upgrade from 2.7.0 to 2.8.0.`}
    • \n
  • {`Updated firmware to latest Raspbian (raspberrypi-kernel_1.20180417-1).`}
    • \n
  • {`Support for the Raspberry Pi 4.`}
    • \n
\n

{`2.7.2`}

\n

{`Machinery`}

\n
    \n
  • {`To optimise the cloud experience we've added a proxy.kerberos.io machine in between.`}
    • \n
  • {`We've changed the S3 storage scheme (class:ONEZONE_IA).`}
    • \n
\n

{`2.7.1`}

\n

{`Machinery`}

\n
    \n
  • {`Resolved deadlock with livestreaming while restarting machinery.`}
    • \n
  • {`Revert logging library; enabled log rotating.`}
    • \n
\n

{`KiOS`}

\n
    \n
  • {`Updated firmware to latest Raspbian (raspberrypi-kernel_1.20180417-1).`}
    • \n
  • {`Resolved issue with WIFI on Raspberry Pi 3B+`}
    • \n
\n

{`2.7.0`}

\n

{`Web`}

\n
    \n
  • {`Unique session cookie, which allows to open multiple web interfaces (e.g. when using docker).`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Added live streaming feature for app.kerberos.io`}
    • \n
  • {`Upgraded logging library: log file can be max 5MB, and will rotate.`}
    • \n
  • {`Better logging for cloud uploads (failed information).`}
    • \n
\n

{`Docker`}

\n
    \n
  • {`No longer need docker-compose, we merged the web and machinery containers to `}{`a single container`}{`.`}
    • \n
\n

{`KiOS`}

\n
    \n
  • {`Updated firmware to latest Raspbian.`}
    • \n
  • {`Support for the Raspberry Pi 3B+.`}
    • \n
\n

{`2.6.1`}

\n

{`Web`}

\n
    \n
  • {`Solved issue with persisting login configuration. `}{`#111`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Added Pushbullet. `}{`#139`}
    • \n
  • {`Cloud upload was not longer working (hotfix also in 2.6.0).`}
    • \n
\n

{`2.6.0`}

\n

{`Web`}

\n
    \n
  • {`Add a cloud connection verification method. `}{`#112`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Add background color timestamp. `}{`#128`}
    • \n
  • {`Send instanceId in AWS header when uploading to cloud (necessary for new cloud app).`}
    • \n
  • {`Better support for Chinese IP cameras.`}
    • \n
\n

{`Docker`}

\n
    \n
  • {`Bug: Autoremove old images/video within Docker Containers. `}{`#104`}
    • \n
\n

{`2.5.0`}

\n

{`Web`}

\n
    \n
  • {`Added Chinese and Italian language.`}
    • \n
  • {`Resolved issue with INSTALLED=true.`}
    • \n
  • {`Make latest_sequence available with basic auth. `}{`#99`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Provide an IO service for publishing events to MQTT. `}{`#89`}
    • \n
  • {`Optimize recording with H264_OMX. `}{`#83`}
    • \n
  • {`Implement throttler for Io detections. `}{`#96`}
    • \n
  • {`SSL version 1.0.0 is no longer accessible in Raspbian. `}{`#109`}
    • \n
\n

{`2.4.2`}

\n

{`Web`}

\n
    \n
  • {`Typo in french translation, causes the web interface crash.`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Resolved major bug in livestream: memory leak in stream class. `}{`#94`}
    • \n
  • {`Capture health verification: check if the chosen capture device is still grabbing (and didn't stalled).`}
    • \n
  • {`Extra logging when recording with raspberry pi camera.`}
    • \n
  • {`Make sure the cloud upload is functioning properly, after an upload it's verified if the files really exist in the cloud.`}
    • \n
\n

{`2.4.1`}

\n

{`Web`}

\n
    \n
  • {`Show warning when system is disabled. `}{`#88`}{`.`}
    • \n
  • {`Hull selector in basic view not always working.`}
    • \n
\n

{`2.4.0`}

\n

{`Ecosystem`}

\n
    \n
  • {`Enable/Disable force network mode.`}
    • \n
  • {`Enable/Disable auto removal media.`}
    • \n
\n

{`Web`}

\n
    \n
  • {`Upgrade from Laravel 4.2 to Laravel 5.4 `}{`#70`}{`.`}
    • \n
  • {`Fix bug with heatmap radius slider `}{`#84`}{`.`}
    • \n
  • {`Design tweaks toggle button (remove outline).`}
    • \n
  • {`Disabled possibility to timestamp video when using hardware acceleration.`}
    • \n
\n

{`Docker`}

\n
    \n
  • {`Fix SSL support `}{`#4`}{`.`}
    • \n
  • {`Auto removal if disk is full.`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`OpenMAX IL hardware encoding for Raspberry Pi camera. `}{`#83`}
      \n
    • {`Optimized live streaming.`}
      • \n
    • {`Optimized h264 recording.`}
      • \n
    • \n
  • {`Basic authentication for live streaming (username and password). `}{`#80`}
    • \n
\n

{`2.3.1`}

\n

{`Machinery`}

\n
    \n
  • {`Update for kerberos.cloud: pushing content-type.`}
    • \n
  • {`Change default configurations.`}
    • \n
\n

{`2.3.0`}

\n

{`Ecosystem`}

\n
    \n
  • {`Support for Raspberry Pi Zero W. `}{`#8`}
    • \n
\n

{`2.2.1`}

\n

{`Ecosystem`}

\n
    \n
  • {`Upgraded FFmpeg and libx264 on KiOS.`}
    • \n
\n

{`Web`}

\n
    \n
  • {`Add Bulgarian translation. `}{`#81`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Bug: IoVideo crashes due to a memory leak. `}{`#70`}
    • \n
\n

{`2.2.0`}

\n

{`Ecosystem`}

\n
    \n
  • {`Added support for Armbian.`}
    • \n
  • {`Raspbian: Async requests causes session corruption. `}{`#78`}
    • \n
\n

{`Web`}

\n
    \n
  • {`Bug: Issue format instance name. `}{`#57`}
    • \n
  • {`Redesign settings page (better UX). `}{`#39`}
    • \n
  • {`Possibility to edit password through web interface. `}{`#63`}
    • \n
  • {`Support for viewing videos.`}
    • \n
  • {`Update radius of heatmap.`}
    • \n
  • {`PHP7 support. `}{`#60`}
    • \n
  • {`Welcome/installation page. `}{`#60`}
    • \n
  • {`Translation updated. `}{`#74`}
    • \n
  • {`Privacy mode. `}{`#54`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Output as video file. `}{`#60`}
    • \n
  • {`Bug: System hangs when a wrong IP camera url was defined. `}{`#48`}
    • \n
  • {`Run arbitrary script/program. `}{`#31`}
    • \n
  • {`Bug: Weird colors from RPi Camera. `}{`#64`}
    • \n
  • {`Upgrade to OpenCV 3.2.0.`}
    • \n
\n

{`2.1.0`}

\n

{`Web`}

\n
    \n
  • {`Added PhotoSwipe for image overview (easier to browse through images). `}{`#45`}
    • \n
  • {`Added reboot and shutdown commands. `}{`#46`}
    • \n
  • {`Added logging view to system page. `}{`#33`}
    • \n
  • {`Added labels to check if machinery is running.`}
    • \n
  • {`Added error handling if web interface isn’t working properly.`}
    • \n
  • {`Fixed Heatmap.js fail to load by ad-blocker. `}{`#42`}
    • \n
  • {`Show additional information on the dashboard (streaming is opening or not) there is no data available.`}
    • \n
  • {`Settings page is now visible on mobile (+ changed icon).`}
    • \n
  • {`Fixed sorting of news articles.`}
    • \n
  • {`Removed links to assets in the cloud (.css files).`}
    • \n
  • {`Design: improved layout of login page, async loading of image view.`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Added configurable streaming port and quality. `}{`#41`}
    • \n
  • {`Added new algorithm: Background subtraction.`}
    • \n
  • {`Added new heuristic: Counter (for object/people counting). `}{`#42`}
    • \n
  • {`Added video capture, which can be used for debugging purposes (replay a video fragment).`}
    • \n
  • {`It’s now possible to mark the images with a timestamp. `}{`#36`}
    • \n
  • {`Fixed blocking streaming socket. `}{`#39`}
    • \n
\n

{`Ecosystem`}

\n
    \n
  • {`Fix removal images if disk is almost full (wrong path was defined).`}
    • \n
  • {`Support for the Raspberry Pi Camera module v2.1. `}{`#3`}
    • \n
  • {`Support for the Raspberry Pi Zero; updated kernel to latest Raspbian. `}{`#3`}
    • \n
  • {`KiOS GUI installer.`}
    • \n
\n

{`2.0.0`}

\n

{`Web`}

\n
    \n
  • {`Add simple ON/OFF toggle. `}{`#24`}
    • \n
  • {`Added update strategy when using KiOS. `}{`#23`}
    • \n
  • {`A system page which shows system information. `}{`#20`}
    • \n
  • {`Heatmap on dashboard page `}{`#19`}
    • \n
  • {`Added live stream view on the dashboard page `}{`#2`}
    • \n
  • {`Fixed bug cloud syncing `}{`#16`}
    • \n
  • {`Fixed broken settings page when space in instane name `}{`#16`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`RTSP support for IP-camera's. `}{`#21`}
    • \n
  • {`Verbose logging. `}{`#35`}
    • \n
  • {`IO-devices are executed in a seperate thread. `}{`#28`}
    • \n
  • {`Live streaming (MJPEG). `}{`#26`}
    • \n
  • {`Execute multiple instances on a machine. `}{`#24`}
    • \n
  • {`Override config by arguments. `}{`#22`}
    • \n
  • {`Move S3 upload to machinery and remove sync-s3 repository. `}{`#16`}
    • \n
\n

{`Docker`}

\n
    \n
  • {`Added Docker image (x86_x64) to Docker Hub.`}
    • \n
\n

{`Ecosystem`}

\n
    \n
  • {`Add support for Raspberry Pi 1, 2 and 3. `}{`#1`}
    • \n
\n

{`1.1.0`}

\n

{`Web`}

\n
    \n
  • {`Support IP camera's with MJPEG stream. `}{`#3`}
    • \n
  • {`Introduce new API methods to configure the machinery, using basic auth. `}{`#4`}
    • \n
  • {`Optimization of loading image and dashboard page, completely redesigned the retrieval of images. `}{`#5`}
    • \n
  • {`Optimization of settings page. `}{`#5`}
    • \n
  • {`Timebar gradient only works in Chrome. `}{`#6`}
    • \n
  • {`Minor CSS fixes for responsive layout.`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Flip/rotate option for capture devices. `}{`#5`}
    • \n
  • {`Support IP camera's with MJPEG stream. `}{`#4`}
    • \n
  • {`Introduced webhook io device. `}{`#5`}
    • \n
\n

{`Cloud`}

\n
    \n
  • {`Fixed problem when syncing a huge amount of images. `}{`#1`}
    • \n
\n

{`1.0.3`}

\n

{`Web`}

\n
    \n
  • {`Optimize performance, new datastructure has been implemented.`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Memory optimization.`}
    • \n
  • {`Removal of images older than 3 days have been removed.`}
    • \n
  • {`Start machinery automatically (delay has been removed).`}
    • \n
\n

{`Cloud`}

\n
    \n
  • {`Resolved file exist problem.`}
    • \n
\n

{`1.0.2`}

\n

{`Web`}

\n
    \n
  • {`Timezone on settings page is also used for the webinterface.`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Added extra timezones to timezone.xml.`}
    • \n
\n

{`1.0.1`}

\n

{`Web`}

\n
    \n
  • {`Improved error handling (date search).`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Improved memory cleanup.`}
    • \n
\n

{`1.0.0`}

\n

{`First commit of Kerberos.io`}

\n
    \n
  • {`Camera support: `}{`USBCamera`}{` (V4L), `}{`Raspberry Pi camera module`}{` (MMAL).`}
    • \n
  • {`Conditions: `}{`Enabled`}{` (turn on/off Kerberos) and active `}{`Time`}{` per day.`}
    • \n
  • {`Algorithms: `}{`Differential Images`}{`.`}
    • \n
  • {`Heuristics: `}{`Sequence`}{`.`}
    • \n
  • {`Expositors: Select a `}{`Hull`}{` or `}{`Rectangle`}{`.`}
    • \n
  • {`Outputs: Write image to `}{`Disk`}{`, trigger an `}{`GPIO`}{` output pin and send a `}{`TCP/IP packet`}{`.`}
    • \n
  • {`Cloud: send your images to the `}{`Kerberos.io cloud aplication`}{`.`}
    • \n
\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750177000,"key":"gatsby-plugin-mdx-entire-payload-6b3b0bb987de28787ec211d312f8356b-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Release notes","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":16,"offset":174},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":16,"offset":174},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.8.0","position":{"start":{"line":10,"column":5,"offset":180},"end":{"line":10,"column":10,"offset":185},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":176},"end":{"line":10,"column":10,"offset":185},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Aligned machinery, web and KiOS versions. Too many people were confused by the versioning.","position":{"start":{"line":12,"column":1,"offset":187},"end":{"line":12,"column":91,"offset":277},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":187},"end":{"line":12,"column":91,"offset":277},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":14,"column":6,"offset":284},"end":{"line":14,"column":9,"offset":287},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":279},"end":{"line":14,"column":9,"offset":287},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Videos displayed on canvas were blocked in latest browsers.","position":{"start":{"line":16,"column":3,"offset":291},"end":{"line":16,"column":62,"offset":350},"indent":[]}}],"position":{"start":{"line":16,"column":3,"offset":291},"end":{"line":16,"column":62,"offset":350},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":289},"end":{"line":16,"column":62,"offset":350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Disabled reboot and shutdown.","position":{"start":{"line":17,"column":3,"offset":353},"end":{"line":17,"column":32,"offset":382},"indent":[]}}],"position":{"start":{"line":17,"column":3,"offset":353},"end":{"line":17,"column":32,"offset":382},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":351},"end":{"line":17,"column":32,"offset":382},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Disabled upgrade process, use fwupdate shell command instead.","position":{"start":{"line":18,"column":3,"offset":385},"end":{"line":18,"column":64,"offset":446},"indent":[]}}],"position":{"start":{"line":18,"column":3,"offset":385},"end":{"line":18,"column":64,"offset":446},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":383},"end":{"line":18,"column":64,"offset":446},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":289},"end":{"line":18,"column":64,"offset":446},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"KiOS","position":{"start":{"line":20,"column":6,"offset":453},"end":{"line":20,"column":10,"offset":457},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":448},"end":{"line":20,"column":10,"offset":457},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Major upgrade, solved many different problems (list to long); not possible to upgrade from 2.7.0 to 2.8.0.","position":{"start":{"line":22,"column":3,"offset":461},"end":{"line":22,"column":109,"offset":567},"indent":[]}}],"position":{"start":{"line":22,"column":3,"offset":461},"end":{"line":22,"column":109,"offset":567},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":459},"end":{"line":22,"column":109,"offset":567},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Updated firmware to latest Raspbian (raspberrypi-kernel_1.20180417-1).","position":{"start":{"line":23,"column":3,"offset":570},"end":{"line":23,"column":73,"offset":640},"indent":[]}}],"position":{"start":{"line":23,"column":3,"offset":570},"end":{"line":23,"column":73,"offset":640},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":568},"end":{"line":23,"column":73,"offset":640},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support for the Raspberry Pi 4.","position":{"start":{"line":24,"column":3,"offset":643},"end":{"line":24,"column":34,"offset":674},"indent":[]}}],"position":{"start":{"line":24,"column":3,"offset":643},"end":{"line":24,"column":34,"offset":674},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":641},"end":{"line":24,"column":34,"offset":674},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":459},"end":{"line":24,"column":34,"offset":674},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.7.2","position":{"start":{"line":26,"column":5,"offset":680},"end":{"line":26,"column":10,"offset":685},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":676},"end":{"line":26,"column":10,"offset":685},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":28,"column":6,"offset":692},"end":{"line":28,"column":15,"offset":701},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":687},"end":{"line":28,"column":15,"offset":701},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"To optimise the cloud experience we've added a proxy.kerberos.io machine in between.","position":{"start":{"line":30,"column":3,"offset":705},"end":{"line":30,"column":87,"offset":789},"indent":[]}}],"position":{"start":{"line":30,"column":3,"offset":705},"end":{"line":30,"column":87,"offset":789},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":703},"end":{"line":30,"column":87,"offset":789},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"We've changed the S3 storage scheme (class:ONEZONE_IA).","position":{"start":{"line":31,"column":3,"offset":792},"end":{"line":31,"column":58,"offset":847},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":792},"end":{"line":31,"column":58,"offset":847},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":790},"end":{"line":31,"column":58,"offset":847},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":703},"end":{"line":31,"column":58,"offset":847},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.7.1","position":{"start":{"line":33,"column":5,"offset":853},"end":{"line":33,"column":10,"offset":858},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":849},"end":{"line":33,"column":10,"offset":858},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":35,"column":6,"offset":865},"end":{"line":35,"column":15,"offset":874},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":860},"end":{"line":35,"column":15,"offset":874},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Resolved deadlock with livestreaming while restarting machinery.","position":{"start":{"line":37,"column":3,"offset":878},"end":{"line":37,"column":67,"offset":942},"indent":[]}}],"position":{"start":{"line":37,"column":3,"offset":878},"end":{"line":37,"column":67,"offset":942},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":876},"end":{"line":37,"column":67,"offset":942},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Revert logging library; enabled log rotating.","position":{"start":{"line":38,"column":3,"offset":945},"end":{"line":38,"column":48,"offset":990},"indent":[]}}],"position":{"start":{"line":38,"column":3,"offset":945},"end":{"line":38,"column":48,"offset":990},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":943},"end":{"line":38,"column":48,"offset":990},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":876},"end":{"line":38,"column":48,"offset":990},"indent":[1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"KiOS","position":{"start":{"line":40,"column":6,"offset":997},"end":{"line":40,"column":10,"offset":1001},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":992},"end":{"line":40,"column":10,"offset":1001},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Updated firmware to latest Raspbian (raspberrypi-kernel_1.20180417-1).","position":{"start":{"line":42,"column":3,"offset":1005},"end":{"line":42,"column":73,"offset":1075},"indent":[]}}],"position":{"start":{"line":42,"column":3,"offset":1005},"end":{"line":42,"column":73,"offset":1075},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":1003},"end":{"line":42,"column":73,"offset":1075},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Resolved issue with WIFI on Raspberry Pi 3B+","position":{"start":{"line":43,"column":3,"offset":1078},"end":{"line":43,"column":47,"offset":1122},"indent":[]}}],"position":{"start":{"line":43,"column":3,"offset":1078},"end":{"line":43,"column":47,"offset":1122},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":1076},"end":{"line":43,"column":47,"offset":1122},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":1003},"end":{"line":43,"column":47,"offset":1122},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.7.0","position":{"start":{"line":45,"column":5,"offset":1128},"end":{"line":45,"column":10,"offset":1133},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":1124},"end":{"line":45,"column":10,"offset":1133},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":47,"column":6,"offset":1140},"end":{"line":47,"column":9,"offset":1143},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":1135},"end":{"line":47,"column":9,"offset":1143},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Unique session cookie, which allows to open multiple web interfaces (e.g. when using docker).","position":{"start":{"line":49,"column":3,"offset":1147},"end":{"line":49,"column":96,"offset":1240},"indent":[]}}],"position":{"start":{"line":49,"column":3,"offset":1147},"end":{"line":49,"column":96,"offset":1240},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":1145},"end":{"line":49,"column":96,"offset":1240},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":1145},"end":{"line":49,"column":96,"offset":1240},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":51,"column":6,"offset":1247},"end":{"line":51,"column":15,"offset":1256},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":1242},"end":{"line":51,"column":15,"offset":1256},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added live streaming feature for app.kerberos.io","position":{"start":{"line":53,"column":3,"offset":1260},"end":{"line":53,"column":51,"offset":1308},"indent":[]}}],"position":{"start":{"line":53,"column":3,"offset":1260},"end":{"line":53,"column":51,"offset":1308},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":1258},"end":{"line":53,"column":51,"offset":1308},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Upgraded logging library: log file can be max 5MB, and will rotate.","position":{"start":{"line":54,"column":3,"offset":1311},"end":{"line":54,"column":70,"offset":1378},"indent":[]}}],"position":{"start":{"line":54,"column":3,"offset":1311},"end":{"line":54,"column":70,"offset":1378},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":1309},"end":{"line":54,"column":70,"offset":1378},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Better logging for cloud uploads (failed information).","position":{"start":{"line":55,"column":3,"offset":1381},"end":{"line":55,"column":57,"offset":1435},"indent":[]}}],"position":{"start":{"line":55,"column":3,"offset":1381},"end":{"line":55,"column":57,"offset":1435},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":1379},"end":{"line":55,"column":57,"offset":1435},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":1258},"end":{"line":55,"column":57,"offset":1435},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Docker","position":{"start":{"line":57,"column":6,"offset":1442},"end":{"line":57,"column":12,"offset":1448},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":1437},"end":{"line":57,"column":12,"offset":1448},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"No longer need docker-compose, we merged the web and machinery containers to ","position":{"start":{"line":59,"column":3,"offset":1452},"end":{"line":59,"column":80,"offset":1529},"indent":[]}},{"type":"link","title":null,"url":"http://hub.docker.com/r/kerberos/kerberos","children":[{"type":"text","value":"a single container","position":{"start":{"line":59,"column":81,"offset":1530},"end":{"line":59,"column":99,"offset":1548},"indent":[]}}],"position":{"start":{"line":59,"column":80,"offset":1529},"end":{"line":59,"column":143,"offset":1592},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":59,"column":143,"offset":1592},"end":{"line":59,"column":144,"offset":1593},"indent":[]}}],"position":{"start":{"line":59,"column":3,"offset":1452},"end":{"line":59,"column":144,"offset":1593},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":1450},"end":{"line":59,"column":144,"offset":1593},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":1450},"end":{"line":59,"column":144,"offset":1593},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"KiOS","position":{"start":{"line":61,"column":6,"offset":1600},"end":{"line":61,"column":10,"offset":1604},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":1595},"end":{"line":61,"column":10,"offset":1604},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Updated firmware to latest Raspbian.","position":{"start":{"line":63,"column":3,"offset":1608},"end":{"line":63,"column":39,"offset":1644},"indent":[]}}],"position":{"start":{"line":63,"column":3,"offset":1608},"end":{"line":63,"column":39,"offset":1644},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":1606},"end":{"line":63,"column":39,"offset":1644},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support for the Raspberry Pi 3B+.","position":{"start":{"line":64,"column":3,"offset":1647},"end":{"line":64,"column":36,"offset":1680},"indent":[]}}],"position":{"start":{"line":64,"column":3,"offset":1647},"end":{"line":64,"column":36,"offset":1680},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":1645},"end":{"line":64,"column":36,"offset":1680},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":1606},"end":{"line":64,"column":36,"offset":1680},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.6.1","position":{"start":{"line":66,"column":5,"offset":1686},"end":{"line":66,"column":10,"offset":1691},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":1682},"end":{"line":66,"column":10,"offset":1691},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":68,"column":6,"offset":1698},"end":{"line":68,"column":9,"offset":1701},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":1693},"end":{"line":68,"column":9,"offset":1701},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Solved issue with persisting login configuration. ","position":{"start":{"line":70,"column":3,"offset":1705},"end":{"line":70,"column":53,"offset":1755},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/111","children":[{"type":"text","value":"#111","position":{"start":{"line":70,"column":54,"offset":1756},"end":{"line":70,"column":58,"offset":1760},"indent":[]}}],"position":{"start":{"line":70,"column":53,"offset":1755},"end":{"line":70,"column":106,"offset":1808},"indent":[]}}],"position":{"start":{"line":70,"column":3,"offset":1705},"end":{"line":70,"column":106,"offset":1808},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":1703},"end":{"line":70,"column":106,"offset":1808},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":1703},"end":{"line":70,"column":106,"offset":1808},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":72,"column":6,"offset":1815},"end":{"line":72,"column":15,"offset":1824},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":1810},"end":{"line":72,"column":15,"offset":1824},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added Pushbullet. ","position":{"start":{"line":74,"column":3,"offset":1828},"end":{"line":74,"column":21,"offset":1846},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/pull/139","children":[{"type":"text","value":"#139","position":{"start":{"line":74,"column":22,"offset":1847},"end":{"line":74,"column":26,"offset":1851},"indent":[]}}],"position":{"start":{"line":74,"column":21,"offset":1846},"end":{"line":74,"column":78,"offset":1903},"indent":[]}}],"position":{"start":{"line":74,"column":3,"offset":1828},"end":{"line":74,"column":78,"offset":1903},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":1826},"end":{"line":74,"column":78,"offset":1903},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Cloud upload was not longer working (hotfix also in 2.6.0).","position":{"start":{"line":75,"column":3,"offset":1906},"end":{"line":75,"column":62,"offset":1965},"indent":[]}}],"position":{"start":{"line":75,"column":3,"offset":1906},"end":{"line":75,"column":62,"offset":1965},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":1904},"end":{"line":75,"column":62,"offset":1965},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":1826},"end":{"line":75,"column":62,"offset":1965},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.6.0","position":{"start":{"line":77,"column":5,"offset":1971},"end":{"line":77,"column":10,"offset":1976},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":1967},"end":{"line":77,"column":10,"offset":1976},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":79,"column":6,"offset":1983},"end":{"line":79,"column":9,"offset":1986},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":1978},"end":{"line":79,"column":9,"offset":1986},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Add a cloud connection verification method. ","position":{"start":{"line":81,"column":3,"offset":1990},"end":{"line":81,"column":47,"offset":2034},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/112","children":[{"type":"text","value":"#112","position":{"start":{"line":81,"column":48,"offset":2035},"end":{"line":81,"column":52,"offset":2039},"indent":[]}}],"position":{"start":{"line":81,"column":47,"offset":2034},"end":{"line":81,"column":100,"offset":2087},"indent":[]}}],"position":{"start":{"line":81,"column":3,"offset":1990},"end":{"line":81,"column":100,"offset":2087},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":1988},"end":{"line":81,"column":100,"offset":2087},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":1988},"end":{"line":81,"column":100,"offset":2087},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":83,"column":6,"offset":2094},"end":{"line":83,"column":15,"offset":2103},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":2089},"end":{"line":83,"column":15,"offset":2103},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Add background color timestamp. ","position":{"start":{"line":85,"column":3,"offset":2107},"end":{"line":85,"column":35,"offset":2139},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/128","children":[{"type":"text","value":"#128","position":{"start":{"line":85,"column":36,"offset":2140},"end":{"line":85,"column":40,"offset":2144},"indent":[]}}],"position":{"start":{"line":85,"column":35,"offset":2139},"end":{"line":85,"column":94,"offset":2198},"indent":[]}}],"position":{"start":{"line":85,"column":3,"offset":2107},"end":{"line":85,"column":94,"offset":2198},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":2105},"end":{"line":85,"column":94,"offset":2198},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Send instanceId in AWS header when uploading to cloud (necessary for new cloud app).","position":{"start":{"line":86,"column":3,"offset":2201},"end":{"line":86,"column":87,"offset":2285},"indent":[]}}],"position":{"start":{"line":86,"column":3,"offset":2201},"end":{"line":86,"column":87,"offset":2285},"indent":[]}}],"position":{"start":{"line":86,"column":1,"offset":2199},"end":{"line":86,"column":87,"offset":2285},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Better support for Chinese IP cameras.","position":{"start":{"line":87,"column":3,"offset":2288},"end":{"line":87,"column":41,"offset":2326},"indent":[]}}],"position":{"start":{"line":87,"column":3,"offset":2288},"end":{"line":87,"column":41,"offset":2326},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":2286},"end":{"line":87,"column":41,"offset":2326},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":2105},"end":{"line":87,"column":41,"offset":2326},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Docker","position":{"start":{"line":89,"column":6,"offset":2333},"end":{"line":89,"column":12,"offset":2339},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":2328},"end":{"line":89,"column":12,"offset":2339},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Bug: Autoremove old images/video within Docker Containers. ","position":{"start":{"line":91,"column":3,"offset":2343},"end":{"line":91,"column":62,"offset":2402},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/104","children":[{"type":"text","value":"#104","position":{"start":{"line":91,"column":63,"offset":2403},"end":{"line":91,"column":67,"offset":2407},"indent":[]}}],"position":{"start":{"line":91,"column":62,"offset":2402},"end":{"line":91,"column":115,"offset":2455},"indent":[]}}],"position":{"start":{"line":91,"column":3,"offset":2343},"end":{"line":91,"column":115,"offset":2455},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":2341},"end":{"line":91,"column":115,"offset":2455},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":2341},"end":{"line":91,"column":115,"offset":2455},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.5.0","position":{"start":{"line":93,"column":5,"offset":2461},"end":{"line":93,"column":10,"offset":2466},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":2457},"end":{"line":93,"column":10,"offset":2466},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":95,"column":6,"offset":2473},"end":{"line":95,"column":9,"offset":2476},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":2468},"end":{"line":95,"column":9,"offset":2476},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added Chinese and Italian language.","position":{"start":{"line":97,"column":3,"offset":2480},"end":{"line":97,"column":38,"offset":2515},"indent":[]}}],"position":{"start":{"line":97,"column":3,"offset":2480},"end":{"line":97,"column":38,"offset":2515},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":2478},"end":{"line":97,"column":38,"offset":2515},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Resolved issue with INSTALLED=true.","position":{"start":{"line":98,"column":3,"offset":2518},"end":{"line":98,"column":38,"offset":2553},"indent":[]}}],"position":{"start":{"line":98,"column":3,"offset":2518},"end":{"line":98,"column":38,"offset":2553},"indent":[]}}],"position":{"start":{"line":98,"column":1,"offset":2516},"end":{"line":98,"column":38,"offset":2553},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Make latest_sequence available with basic auth. ","position":{"start":{"line":99,"column":3,"offset":2556},"end":{"line":99,"column":52,"offset":2605},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/99","children":[{"type":"text","value":"#99","position":{"start":{"line":99,"column":53,"offset":2606},"end":{"line":99,"column":56,"offset":2609},"indent":[]}}],"position":{"start":{"line":99,"column":52,"offset":2605},"end":{"line":99,"column":103,"offset":2656},"indent":[]}}],"position":{"start":{"line":99,"column":3,"offset":2556},"end":{"line":99,"column":103,"offset":2656},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":2554},"end":{"line":99,"column":103,"offset":2656},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":2478},"end":{"line":99,"column":103,"offset":2656},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":101,"column":6,"offset":2663},"end":{"line":101,"column":15,"offset":2672},"indent":[]}}],"position":{"start":{"line":101,"column":1,"offset":2658},"end":{"line":101,"column":15,"offset":2672},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Provide an IO service for publishing events to MQTT. ","position":{"start":{"line":103,"column":3,"offset":2676},"end":{"line":103,"column":56,"offset":2729},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/89","children":[{"type":"text","value":"#89","position":{"start":{"line":103,"column":57,"offset":2730},"end":{"line":103,"column":60,"offset":2733},"indent":[]}}],"position":{"start":{"line":103,"column":56,"offset":2729},"end":{"line":103,"column":113,"offset":2786},"indent":[]}}],"position":{"start":{"line":103,"column":3,"offset":2676},"end":{"line":103,"column":113,"offset":2786},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":2674},"end":{"line":103,"column":113,"offset":2786},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Optimize recording with H264_OMX. ","position":{"start":{"line":104,"column":3,"offset":2789},"end":{"line":104,"column":37,"offset":2823},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/83","children":[{"type":"text","value":"#83","position":{"start":{"line":104,"column":38,"offset":2824},"end":{"line":104,"column":41,"offset":2827},"indent":[]}}],"position":{"start":{"line":104,"column":37,"offset":2823},"end":{"line":104,"column":94,"offset":2880},"indent":[]}}],"position":{"start":{"line":104,"column":3,"offset":2789},"end":{"line":104,"column":94,"offset":2880},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":2787},"end":{"line":104,"column":94,"offset":2880},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Implement throttler for Io detections. ","position":{"start":{"line":105,"column":3,"offset":2883},"end":{"line":105,"column":42,"offset":2922},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/96","children":[{"type":"text","value":"#96","position":{"start":{"line":105,"column":43,"offset":2923},"end":{"line":105,"column":46,"offset":2926},"indent":[]}}],"position":{"start":{"line":105,"column":42,"offset":2922},"end":{"line":105,"column":99,"offset":2979},"indent":[]}}],"position":{"start":{"line":105,"column":3,"offset":2883},"end":{"line":105,"column":99,"offset":2979},"indent":[]}}],"position":{"start":{"line":105,"column":1,"offset":2881},"end":{"line":105,"column":99,"offset":2979},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"SSL version 1.0.0 is no longer accessible in Raspbian. ","position":{"start":{"line":106,"column":3,"offset":2982},"end":{"line":106,"column":58,"offset":3037},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/109","children":[{"type":"text","value":"#109","position":{"start":{"line":106,"column":59,"offset":3038},"end":{"line":106,"column":63,"offset":3042},"indent":[]}}],"position":{"start":{"line":106,"column":58,"offset":3037},"end":{"line":106,"column":117,"offset":3096},"indent":[]}}],"position":{"start":{"line":106,"column":3,"offset":2982},"end":{"line":106,"column":117,"offset":3096},"indent":[]}}],"position":{"start":{"line":106,"column":1,"offset":2980},"end":{"line":106,"column":117,"offset":3096},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":2674},"end":{"line":106,"column":117,"offset":3096},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.4.2","position":{"start":{"line":108,"column":5,"offset":3102},"end":{"line":108,"column":10,"offset":3107},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":3098},"end":{"line":108,"column":10,"offset":3107},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":110,"column":6,"offset":3114},"end":{"line":110,"column":9,"offset":3117},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":3109},"end":{"line":110,"column":9,"offset":3117},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Typo in french translation, causes the web interface crash.","position":{"start":{"line":112,"column":3,"offset":3121},"end":{"line":112,"column":62,"offset":3180},"indent":[]}}],"position":{"start":{"line":112,"column":3,"offset":3121},"end":{"line":112,"column":62,"offset":3180},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":3119},"end":{"line":112,"column":62,"offset":3180},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":3119},"end":{"line":112,"column":62,"offset":3180},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":114,"column":6,"offset":3187},"end":{"line":114,"column":15,"offset":3196},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":3182},"end":{"line":114,"column":15,"offset":3196},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Resolved major bug in livestream: memory leak in stream class. ","position":{"start":{"line":116,"column":3,"offset":3200},"end":{"line":116,"column":66,"offset":3263},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/94","children":[{"type":"text","value":"#94","position":{"start":{"line":116,"column":67,"offset":3264},"end":{"line":116,"column":70,"offset":3267},"indent":[]}}],"position":{"start":{"line":116,"column":66,"offset":3263},"end":{"line":116,"column":123,"offset":3320},"indent":[]}}],"position":{"start":{"line":116,"column":3,"offset":3200},"end":{"line":116,"column":123,"offset":3320},"indent":[]}}],"position":{"start":{"line":116,"column":1,"offset":3198},"end":{"line":116,"column":123,"offset":3320},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Capture health verification: check if the chosen capture device is still grabbing (and didn't stalled).","position":{"start":{"line":117,"column":3,"offset":3323},"end":{"line":117,"column":106,"offset":3426},"indent":[]}}],"position":{"start":{"line":117,"column":3,"offset":3323},"end":{"line":117,"column":106,"offset":3426},"indent":[]}}],"position":{"start":{"line":117,"column":1,"offset":3321},"end":{"line":117,"column":106,"offset":3426},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Extra logging when recording with raspberry pi camera.","position":{"start":{"line":118,"column":3,"offset":3429},"end":{"line":118,"column":57,"offset":3483},"indent":[]}}],"position":{"start":{"line":118,"column":3,"offset":3429},"end":{"line":118,"column":57,"offset":3483},"indent":[]}}],"position":{"start":{"line":118,"column":1,"offset":3427},"end":{"line":118,"column":57,"offset":3483},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Make sure the cloud upload is functioning properly, after an upload it's verified if the files really exist in the cloud.","position":{"start":{"line":119,"column":3,"offset":3486},"end":{"line":119,"column":124,"offset":3607},"indent":[]}}],"position":{"start":{"line":119,"column":3,"offset":3486},"end":{"line":119,"column":124,"offset":3607},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":3484},"end":{"line":119,"column":124,"offset":3607},"indent":[]}}],"position":{"start":{"line":116,"column":1,"offset":3198},"end":{"line":119,"column":124,"offset":3607},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.4.1","position":{"start":{"line":121,"column":5,"offset":3613},"end":{"line":121,"column":10,"offset":3618},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":3609},"end":{"line":121,"column":10,"offset":3618},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":123,"column":6,"offset":3625},"end":{"line":123,"column":9,"offset":3628},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":3620},"end":{"line":123,"column":9,"offset":3628},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Show warning when system is disabled. ","position":{"start":{"line":125,"column":3,"offset":3632},"end":{"line":125,"column":41,"offset":3670},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/88","children":[{"type":"text","value":"#88","position":{"start":{"line":125,"column":42,"offset":3671},"end":{"line":125,"column":45,"offset":3674},"indent":[]}}],"position":{"start":{"line":125,"column":41,"offset":3670},"end":{"line":125,"column":92,"offset":3721},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":125,"column":92,"offset":3721},"end":{"line":125,"column":93,"offset":3722},"indent":[]}}],"position":{"start":{"line":125,"column":3,"offset":3632},"end":{"line":125,"column":93,"offset":3722},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":3630},"end":{"line":125,"column":93,"offset":3722},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Hull selector in basic view not always working.","position":{"start":{"line":126,"column":3,"offset":3725},"end":{"line":126,"column":50,"offset":3772},"indent":[]}}],"position":{"start":{"line":126,"column":3,"offset":3725},"end":{"line":126,"column":50,"offset":3772},"indent":[]}}],"position":{"start":{"line":126,"column":1,"offset":3723},"end":{"line":126,"column":50,"offset":3772},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":3630},"end":{"line":126,"column":50,"offset":3772},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.4.0","position":{"start":{"line":128,"column":5,"offset":3778},"end":{"line":128,"column":10,"offset":3783},"indent":[]}}],"position":{"start":{"line":128,"column":1,"offset":3774},"end":{"line":128,"column":10,"offset":3783},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Ecosystem","position":{"start":{"line":130,"column":6,"offset":3790},"end":{"line":130,"column":15,"offset":3799},"indent":[]}}],"position":{"start":{"line":130,"column":1,"offset":3785},"end":{"line":130,"column":15,"offset":3799},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Enable/Disable force network mode.","position":{"start":{"line":132,"column":3,"offset":3803},"end":{"line":132,"column":37,"offset":3837},"indent":[]}}],"position":{"start":{"line":132,"column":3,"offset":3803},"end":{"line":132,"column":37,"offset":3837},"indent":[]}}],"position":{"start":{"line":132,"column":1,"offset":3801},"end":{"line":132,"column":37,"offset":3837},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Enable/Disable auto removal media.","position":{"start":{"line":133,"column":3,"offset":3840},"end":{"line":133,"column":37,"offset":3874},"indent":[]}}],"position":{"start":{"line":133,"column":3,"offset":3840},"end":{"line":133,"column":37,"offset":3874},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":3838},"end":{"line":133,"column":37,"offset":3874},"indent":[]}}],"position":{"start":{"line":132,"column":1,"offset":3801},"end":{"line":133,"column":37,"offset":3874},"indent":[1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":135,"column":6,"offset":3881},"end":{"line":135,"column":9,"offset":3884},"indent":[]}}],"position":{"start":{"line":135,"column":1,"offset":3876},"end":{"line":135,"column":9,"offset":3884},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Upgrade from Laravel 4.2 to Laravel 5.4 ","position":{"start":{"line":137,"column":3,"offset":3888},"end":{"line":137,"column":43,"offset":3928},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/70","children":[{"type":"text","value":"#70","position":{"start":{"line":137,"column":44,"offset":3929},"end":{"line":137,"column":47,"offset":3932},"indent":[]}}],"position":{"start":{"line":137,"column":43,"offset":3928},"end":{"line":137,"column":94,"offset":3979},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":137,"column":94,"offset":3979},"end":{"line":137,"column":95,"offset":3980},"indent":[]}}],"position":{"start":{"line":137,"column":3,"offset":3888},"end":{"line":137,"column":95,"offset":3980},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":3886},"end":{"line":137,"column":95,"offset":3980},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fix bug with heatmap radius slider ","position":{"start":{"line":138,"column":3,"offset":3983},"end":{"line":138,"column":38,"offset":4018},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/84","children":[{"type":"text","value":"#84","position":{"start":{"line":138,"column":39,"offset":4019},"end":{"line":138,"column":42,"offset":4022},"indent":[]}}],"position":{"start":{"line":138,"column":38,"offset":4018},"end":{"line":138,"column":89,"offset":4069},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":138,"column":89,"offset":4069},"end":{"line":138,"column":90,"offset":4070},"indent":[]}}],"position":{"start":{"line":138,"column":3,"offset":3983},"end":{"line":138,"column":90,"offset":4070},"indent":[]}}],"position":{"start":{"line":138,"column":1,"offset":3981},"end":{"line":138,"column":90,"offset":4070},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Design tweaks toggle button (remove outline).","position":{"start":{"line":139,"column":3,"offset":4073},"end":{"line":139,"column":48,"offset":4118},"indent":[]}}],"position":{"start":{"line":139,"column":3,"offset":4073},"end":{"line":139,"column":48,"offset":4118},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":4071},"end":{"line":139,"column":48,"offset":4118},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Disabled possibility to timestamp video when using hardware acceleration.","position":{"start":{"line":140,"column":3,"offset":4121},"end":{"line":140,"column":76,"offset":4194},"indent":[]}}],"position":{"start":{"line":140,"column":3,"offset":4121},"end":{"line":140,"column":76,"offset":4194},"indent":[]}}],"position":{"start":{"line":140,"column":1,"offset":4119},"end":{"line":140,"column":76,"offset":4194},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":3886},"end":{"line":140,"column":76,"offset":4194},"indent":[1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Docker","position":{"start":{"line":142,"column":6,"offset":4201},"end":{"line":142,"column":12,"offset":4207},"indent":[]}}],"position":{"start":{"line":142,"column":1,"offset":4196},"end":{"line":142,"column":12,"offset":4207},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fix SSL support ","position":{"start":{"line":144,"column":3,"offset":4211},"end":{"line":144,"column":19,"offset":4227},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/docker/issues/4","children":[{"type":"text","value":"#4","position":{"start":{"line":144,"column":20,"offset":4228},"end":{"line":144,"column":22,"offset":4230},"indent":[]}}],"position":{"start":{"line":144,"column":19,"offset":4227},"end":{"line":144,"column":71,"offset":4279},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":144,"column":71,"offset":4279},"end":{"line":144,"column":72,"offset":4280},"indent":[]}}],"position":{"start":{"line":144,"column":3,"offset":4211},"end":{"line":144,"column":72,"offset":4280},"indent":[]}}],"position":{"start":{"line":144,"column":1,"offset":4209},"end":{"line":144,"column":72,"offset":4280},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Auto removal if disk is full.","position":{"start":{"line":145,"column":3,"offset":4283},"end":{"line":145,"column":32,"offset":4312},"indent":[]}}],"position":{"start":{"line":145,"column":3,"offset":4283},"end":{"line":145,"column":32,"offset":4312},"indent":[]}}],"position":{"start":{"line":145,"column":1,"offset":4281},"end":{"line":145,"column":32,"offset":4312},"indent":[]}}],"position":{"start":{"line":144,"column":1,"offset":4209},"end":{"line":145,"column":32,"offset":4312},"indent":[1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":147,"column":6,"offset":4319},"end":{"line":147,"column":15,"offset":4328},"indent":[]}}],"position":{"start":{"line":147,"column":1,"offset":4314},"end":{"line":147,"column":15,"offset":4328},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"OpenMAX IL hardware encoding for Raspberry Pi camera. ","position":{"start":{"line":149,"column":3,"offset":4332},"end":{"line":149,"column":57,"offset":4386},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/83","children":[{"type":"text","value":"#83","position":{"start":{"line":149,"column":58,"offset":4387},"end":{"line":149,"column":61,"offset":4390},"indent":[]}}],"position":{"start":{"line":149,"column":57,"offset":4386},"end":{"line":149,"column":114,"offset":4443},"indent":[]}}],"position":{"start":{"line":149,"column":3,"offset":4332},"end":{"line":149,"column":114,"offset":4443},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Optimized live streaming.","position":{"start":{"line":150,"column":5,"offset":4448},"end":{"line":150,"column":30,"offset":4473},"indent":[]}}],"position":{"start":{"line":150,"column":5,"offset":4448},"end":{"line":150,"column":30,"offset":4473},"indent":[]}}],"position":{"start":{"line":150,"column":3,"offset":4446},"end":{"line":150,"column":30,"offset":4473},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Optimized h264 recording.","position":{"start":{"line":151,"column":5,"offset":4478},"end":{"line":151,"column":30,"offset":4503},"indent":[]}}],"position":{"start":{"line":151,"column":5,"offset":4478},"end":{"line":151,"column":30,"offset":4503},"indent":[]}}],"position":{"start":{"line":151,"column":3,"offset":4476},"end":{"line":151,"column":30,"offset":4503},"indent":[]}}],"position":{"start":{"line":150,"column":3,"offset":4446},"end":{"line":151,"column":30,"offset":4503},"indent":[3]}}],"position":{"start":{"line":149,"column":1,"offset":4330},"end":{"line":151,"column":30,"offset":4503},"indent":[1,1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Basic authentication for live streaming (username and password). ","position":{"start":{"line":152,"column":3,"offset":4506},"end":{"line":152,"column":68,"offset":4571},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/80","children":[{"type":"text","value":"#80","position":{"start":{"line":152,"column":69,"offset":4572},"end":{"line":152,"column":72,"offset":4575},"indent":[]}}],"position":{"start":{"line":152,"column":68,"offset":4571},"end":{"line":152,"column":125,"offset":4628},"indent":[]}}],"position":{"start":{"line":152,"column":3,"offset":4506},"end":{"line":152,"column":125,"offset":4628},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":4504},"end":{"line":152,"column":125,"offset":4628},"indent":[]}}],"position":{"start":{"line":149,"column":1,"offset":4330},"end":{"line":152,"column":125,"offset":4628},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.3.1","position":{"start":{"line":154,"column":5,"offset":4634},"end":{"line":154,"column":10,"offset":4639},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":4630},"end":{"line":154,"column":10,"offset":4639},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":156,"column":6,"offset":4646},"end":{"line":156,"column":15,"offset":4655},"indent":[]}}],"position":{"start":{"line":156,"column":1,"offset":4641},"end":{"line":156,"column":15,"offset":4655},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Update for kerberos.cloud: pushing content-type.","position":{"start":{"line":158,"column":3,"offset":4659},"end":{"line":158,"column":51,"offset":4707},"indent":[]}}],"position":{"start":{"line":158,"column":3,"offset":4659},"end":{"line":158,"column":51,"offset":4707},"indent":[]}}],"position":{"start":{"line":158,"column":1,"offset":4657},"end":{"line":158,"column":51,"offset":4707},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Change default configurations.","position":{"start":{"line":159,"column":3,"offset":4710},"end":{"line":159,"column":33,"offset":4740},"indent":[]}}],"position":{"start":{"line":159,"column":3,"offset":4710},"end":{"line":159,"column":33,"offset":4740},"indent":[]}}],"position":{"start":{"line":159,"column":1,"offset":4708},"end":{"line":159,"column":33,"offset":4740},"indent":[]}}],"position":{"start":{"line":158,"column":1,"offset":4657},"end":{"line":159,"column":33,"offset":4740},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.3.0","position":{"start":{"line":161,"column":5,"offset":4746},"end":{"line":161,"column":10,"offset":4751},"indent":[]}}],"position":{"start":{"line":161,"column":1,"offset":4742},"end":{"line":161,"column":10,"offset":4751},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Ecosystem","position":{"start":{"line":163,"column":6,"offset":4758},"end":{"line":163,"column":15,"offset":4767},"indent":[]}}],"position":{"start":{"line":163,"column":1,"offset":4753},"end":{"line":163,"column":15,"offset":4767},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support for Raspberry Pi Zero W. ","position":{"start":{"line":165,"column":3,"offset":4771},"end":{"line":165,"column":36,"offset":4804},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/kios/issues/8","children":[{"type":"text","value":"#8","position":{"start":{"line":165,"column":37,"offset":4805},"end":{"line":165,"column":39,"offset":4807},"indent":[]}}],"position":{"start":{"line":165,"column":36,"offset":4804},"end":{"line":165,"column":86,"offset":4854},"indent":[]}}],"position":{"start":{"line":165,"column":3,"offset":4771},"end":{"line":165,"column":86,"offset":4854},"indent":[]}}],"position":{"start":{"line":165,"column":1,"offset":4769},"end":{"line":165,"column":86,"offset":4854},"indent":[]}}],"position":{"start":{"line":165,"column":1,"offset":4769},"end":{"line":165,"column":86,"offset":4854},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.2.1","position":{"start":{"line":167,"column":5,"offset":4860},"end":{"line":167,"column":10,"offset":4865},"indent":[]}}],"position":{"start":{"line":167,"column":1,"offset":4856},"end":{"line":167,"column":10,"offset":4865},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Ecosystem","position":{"start":{"line":169,"column":6,"offset":4872},"end":{"line":169,"column":15,"offset":4881},"indent":[]}}],"position":{"start":{"line":169,"column":1,"offset":4867},"end":{"line":169,"column":15,"offset":4881},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Upgraded FFmpeg and libx264 on KiOS.","position":{"start":{"line":171,"column":3,"offset":4885},"end":{"line":171,"column":39,"offset":4921},"indent":[]}}],"position":{"start":{"line":171,"column":3,"offset":4885},"end":{"line":171,"column":39,"offset":4921},"indent":[]}}],"position":{"start":{"line":171,"column":1,"offset":4883},"end":{"line":171,"column":39,"offset":4921},"indent":[]}}],"position":{"start":{"line":171,"column":1,"offset":4883},"end":{"line":171,"column":39,"offset":4921},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":173,"column":6,"offset":4928},"end":{"line":173,"column":9,"offset":4931},"indent":[]}}],"position":{"start":{"line":173,"column":1,"offset":4923},"end":{"line":173,"column":9,"offset":4931},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Add Bulgarian translation. ","position":{"start":{"line":175,"column":3,"offset":4935},"end":{"line":175,"column":30,"offset":4962},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/pull/81","children":[{"type":"text","value":"#81","position":{"start":{"line":175,"column":31,"offset":4963},"end":{"line":175,"column":34,"offset":4966},"indent":[]}}],"position":{"start":{"line":175,"column":30,"offset":4962},"end":{"line":175,"column":79,"offset":5011},"indent":[]}}],"position":{"start":{"line":175,"column":3,"offset":4935},"end":{"line":175,"column":79,"offset":5011},"indent":[]}}],"position":{"start":{"line":175,"column":1,"offset":4933},"end":{"line":175,"column":79,"offset":5011},"indent":[]}}],"position":{"start":{"line":175,"column":1,"offset":4933},"end":{"line":175,"column":79,"offset":5011},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":177,"column":6,"offset":5018},"end":{"line":177,"column":15,"offset":5027},"indent":[]}}],"position":{"start":{"line":177,"column":1,"offset":5013},"end":{"line":177,"column":15,"offset":5027},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Bug: IoVideo crashes due to a memory leak. ","position":{"start":{"line":179,"column":3,"offset":5031},"end":{"line":179,"column":46,"offset":5074},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/70","children":[{"type":"text","value":"#70","position":{"start":{"line":179,"column":47,"offset":5075},"end":{"line":179,"column":50,"offset":5078},"indent":[]}}],"position":{"start":{"line":179,"column":46,"offset":5074},"end":{"line":179,"column":103,"offset":5131},"indent":[]}}],"position":{"start":{"line":179,"column":3,"offset":5031},"end":{"line":179,"column":103,"offset":5131},"indent":[]}}],"position":{"start":{"line":179,"column":1,"offset":5029},"end":{"line":179,"column":103,"offset":5131},"indent":[]}}],"position":{"start":{"line":179,"column":1,"offset":5029},"end":{"line":179,"column":103,"offset":5131},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.2.0","position":{"start":{"line":181,"column":5,"offset":5137},"end":{"line":181,"column":10,"offset":5142},"indent":[]}}],"position":{"start":{"line":181,"column":1,"offset":5133},"end":{"line":181,"column":10,"offset":5142},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Ecosystem","position":{"start":{"line":183,"column":6,"offset":5149},"end":{"line":183,"column":15,"offset":5158},"indent":[]}}],"position":{"start":{"line":183,"column":1,"offset":5144},"end":{"line":183,"column":15,"offset":5158},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added support for Armbian.","position":{"start":{"line":185,"column":3,"offset":5162},"end":{"line":185,"column":29,"offset":5188},"indent":[]}}],"position":{"start":{"line":185,"column":3,"offset":5162},"end":{"line":185,"column":29,"offset":5188},"indent":[]}}],"position":{"start":{"line":185,"column":1,"offset":5160},"end":{"line":185,"column":29,"offset":5188},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Raspbian: Async requests causes session corruption. ","position":{"start":{"line":186,"column":3,"offset":5191},"end":{"line":186,"column":55,"offset":5243},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/78","children":[{"type":"text","value":"#78","position":{"start":{"line":186,"column":56,"offset":5244},"end":{"line":186,"column":59,"offset":5247},"indent":[]}}],"position":{"start":{"line":186,"column":55,"offset":5243},"end":{"line":186,"column":106,"offset":5294},"indent":[]}}],"position":{"start":{"line":186,"column":3,"offset":5191},"end":{"line":186,"column":106,"offset":5294},"indent":[]}}],"position":{"start":{"line":186,"column":1,"offset":5189},"end":{"line":186,"column":106,"offset":5294},"indent":[]}}],"position":{"start":{"line":185,"column":1,"offset":5160},"end":{"line":186,"column":106,"offset":5294},"indent":[1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":188,"column":6,"offset":5301},"end":{"line":188,"column":9,"offset":5304},"indent":[]}}],"position":{"start":{"line":188,"column":1,"offset":5296},"end":{"line":188,"column":9,"offset":5304},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Bug: Issue format instance name. ","position":{"start":{"line":190,"column":3,"offset":5308},"end":{"line":190,"column":36,"offset":5341},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/57","children":[{"type":"text","value":"#57","position":{"start":{"line":190,"column":37,"offset":5342},"end":{"line":190,"column":40,"offset":5345},"indent":[]}}],"position":{"start":{"line":190,"column":36,"offset":5341},"end":{"line":190,"column":87,"offset":5392},"indent":[]}}],"position":{"start":{"line":190,"column":3,"offset":5308},"end":{"line":190,"column":87,"offset":5392},"indent":[]}}],"position":{"start":{"line":190,"column":1,"offset":5306},"end":{"line":190,"column":87,"offset":5392},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Redesign settings page (better UX). ","position":{"start":{"line":191,"column":3,"offset":5395},"end":{"line":191,"column":39,"offset":5431},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/39","children":[{"type":"text","value":"#39","position":{"start":{"line":191,"column":40,"offset":5432},"end":{"line":191,"column":43,"offset":5435},"indent":[]}}],"position":{"start":{"line":191,"column":39,"offset":5431},"end":{"line":191,"column":90,"offset":5482},"indent":[]}}],"position":{"start":{"line":191,"column":3,"offset":5395},"end":{"line":191,"column":90,"offset":5482},"indent":[]}}],"position":{"start":{"line":191,"column":1,"offset":5393},"end":{"line":191,"column":90,"offset":5482},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Possibility to edit password through web interface. ","position":{"start":{"line":192,"column":3,"offset":5485},"end":{"line":192,"column":55,"offset":5537},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/63","children":[{"type":"text","value":"#63","position":{"start":{"line":192,"column":56,"offset":5538},"end":{"line":192,"column":59,"offset":5541},"indent":[]}}],"position":{"start":{"line":192,"column":55,"offset":5537},"end":{"line":192,"column":106,"offset":5588},"indent":[]}}],"position":{"start":{"line":192,"column":3,"offset":5485},"end":{"line":192,"column":106,"offset":5588},"indent":[]}}],"position":{"start":{"line":192,"column":1,"offset":5483},"end":{"line":192,"column":106,"offset":5588},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support for viewing videos.","position":{"start":{"line":193,"column":3,"offset":5591},"end":{"line":193,"column":30,"offset":5618},"indent":[]}}],"position":{"start":{"line":193,"column":3,"offset":5591},"end":{"line":193,"column":30,"offset":5618},"indent":[]}}],"position":{"start":{"line":193,"column":1,"offset":5589},"end":{"line":193,"column":30,"offset":5618},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Update radius of heatmap.","position":{"start":{"line":194,"column":3,"offset":5621},"end":{"line":194,"column":28,"offset":5646},"indent":[]}}],"position":{"start":{"line":194,"column":3,"offset":5621},"end":{"line":194,"column":28,"offset":5646},"indent":[]}}],"position":{"start":{"line":194,"column":1,"offset":5619},"end":{"line":194,"column":28,"offset":5646},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"PHP7 support. ","position":{"start":{"line":195,"column":3,"offset":5649},"end":{"line":195,"column":17,"offset":5663},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/60","children":[{"type":"text","value":"#60","position":{"start":{"line":195,"column":18,"offset":5664},"end":{"line":195,"column":21,"offset":5667},"indent":[]}}],"position":{"start":{"line":195,"column":17,"offset":5663},"end":{"line":195,"column":68,"offset":5714},"indent":[]}}],"position":{"start":{"line":195,"column":3,"offset":5649},"end":{"line":195,"column":68,"offset":5714},"indent":[]}}],"position":{"start":{"line":195,"column":1,"offset":5647},"end":{"line":195,"column":68,"offset":5714},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Welcome/installation page. ","position":{"start":{"line":196,"column":3,"offset":5717},"end":{"line":196,"column":30,"offset":5744},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/60","children":[{"type":"text","value":"#60","position":{"start":{"line":196,"column":31,"offset":5745},"end":{"line":196,"column":34,"offset":5748},"indent":[]}}],"position":{"start":{"line":196,"column":30,"offset":5744},"end":{"line":196,"column":81,"offset":5795},"indent":[]}}],"position":{"start":{"line":196,"column":3,"offset":5717},"end":{"line":196,"column":81,"offset":5795},"indent":[]}}],"position":{"start":{"line":196,"column":1,"offset":5715},"end":{"line":196,"column":81,"offset":5795},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Translation updated. ","position":{"start":{"line":197,"column":3,"offset":5798},"end":{"line":197,"column":24,"offset":5819},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/74","children":[{"type":"text","value":"#74","position":{"start":{"line":197,"column":25,"offset":5820},"end":{"line":197,"column":28,"offset":5823},"indent":[]}}],"position":{"start":{"line":197,"column":24,"offset":5819},"end":{"line":197,"column":75,"offset":5870},"indent":[]}}],"position":{"start":{"line":197,"column":3,"offset":5798},"end":{"line":197,"column":75,"offset":5870},"indent":[]}}],"position":{"start":{"line":197,"column":1,"offset":5796},"end":{"line":197,"column":75,"offset":5870},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Privacy mode. ","position":{"start":{"line":198,"column":3,"offset":5873},"end":{"line":198,"column":17,"offset":5887},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/54","children":[{"type":"text","value":"#54","position":{"start":{"line":198,"column":18,"offset":5888},"end":{"line":198,"column":21,"offset":5891},"indent":[]}}],"position":{"start":{"line":198,"column":17,"offset":5887},"end":{"line":198,"column":68,"offset":5938},"indent":[]}}],"position":{"start":{"line":198,"column":3,"offset":5873},"end":{"line":198,"column":68,"offset":5938},"indent":[]}}],"position":{"start":{"line":198,"column":1,"offset":5871},"end":{"line":198,"column":68,"offset":5938},"indent":[]}}],"position":{"start":{"line":190,"column":1,"offset":5306},"end":{"line":198,"column":68,"offset":5938},"indent":[1,1,1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":200,"column":6,"offset":5945},"end":{"line":200,"column":15,"offset":5954},"indent":[]}}],"position":{"start":{"line":200,"column":1,"offset":5940},"end":{"line":200,"column":15,"offset":5954},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Output as video file. ","position":{"start":{"line":202,"column":3,"offset":5958},"end":{"line":202,"column":25,"offset":5980},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/60","children":[{"type":"text","value":"#60","position":{"start":{"line":202,"column":26,"offset":5981},"end":{"line":202,"column":29,"offset":5984},"indent":[]}}],"position":{"start":{"line":202,"column":25,"offset":5980},"end":{"line":202,"column":82,"offset":6037},"indent":[]}}],"position":{"start":{"line":202,"column":3,"offset":5958},"end":{"line":202,"column":82,"offset":6037},"indent":[]}}],"position":{"start":{"line":202,"column":1,"offset":5956},"end":{"line":202,"column":82,"offset":6037},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Bug: System hangs when a wrong IP camera url was defined. ","position":{"start":{"line":203,"column":3,"offset":6040},"end":{"line":203,"column":61,"offset":6098},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/48","children":[{"type":"text","value":"#48","position":{"start":{"line":203,"column":62,"offset":6099},"end":{"line":203,"column":65,"offset":6102},"indent":[]}}],"position":{"start":{"line":203,"column":61,"offset":6098},"end":{"line":203,"column":118,"offset":6155},"indent":[]}}],"position":{"start":{"line":203,"column":3,"offset":6040},"end":{"line":203,"column":118,"offset":6155},"indent":[]}}],"position":{"start":{"line":203,"column":1,"offset":6038},"end":{"line":203,"column":118,"offset":6155},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Run arbitrary script/program. ","position":{"start":{"line":204,"column":3,"offset":6158},"end":{"line":204,"column":33,"offset":6188},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/31","children":[{"type":"text","value":"#31","position":{"start":{"line":204,"column":34,"offset":6189},"end":{"line":204,"column":37,"offset":6192},"indent":[]}}],"position":{"start":{"line":204,"column":33,"offset":6188},"end":{"line":204,"column":90,"offset":6245},"indent":[]}}],"position":{"start":{"line":204,"column":3,"offset":6158},"end":{"line":204,"column":90,"offset":6245},"indent":[]}}],"position":{"start":{"line":204,"column":1,"offset":6156},"end":{"line":204,"column":90,"offset":6245},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Bug: Weird colors from RPi Camera. ","position":{"start":{"line":205,"column":3,"offset":6248},"end":{"line":205,"column":38,"offset":6283},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/64","children":[{"type":"text","value":"#64","position":{"start":{"line":205,"column":39,"offset":6284},"end":{"line":205,"column":42,"offset":6287},"indent":[]}}],"position":{"start":{"line":205,"column":38,"offset":6283},"end":{"line":205,"column":95,"offset":6340},"indent":[]}}],"position":{"start":{"line":205,"column":3,"offset":6248},"end":{"line":205,"column":95,"offset":6340},"indent":[]}}],"position":{"start":{"line":205,"column":1,"offset":6246},"end":{"line":205,"column":95,"offset":6340},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Upgrade to OpenCV 3.2.0.","position":{"start":{"line":206,"column":3,"offset":6343},"end":{"line":206,"column":27,"offset":6367},"indent":[]}}],"position":{"start":{"line":206,"column":3,"offset":6343},"end":{"line":206,"column":27,"offset":6367},"indent":[]}}],"position":{"start":{"line":206,"column":1,"offset":6341},"end":{"line":206,"column":27,"offset":6367},"indent":[]}}],"position":{"start":{"line":202,"column":1,"offset":5956},"end":{"line":206,"column":27,"offset":6367},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.1.0","position":{"start":{"line":208,"column":5,"offset":6373},"end":{"line":208,"column":10,"offset":6378},"indent":[]}}],"position":{"start":{"line":208,"column":1,"offset":6369},"end":{"line":208,"column":10,"offset":6378},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":210,"column":6,"offset":6385},"end":{"line":210,"column":9,"offset":6388},"indent":[]}}],"position":{"start":{"line":210,"column":1,"offset":6380},"end":{"line":210,"column":9,"offset":6388},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added PhotoSwipe for image overview (easier to browse through images). ","position":{"start":{"line":212,"column":3,"offset":6392},"end":{"line":212,"column":74,"offset":6463},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/45","children":[{"type":"text","value":"#45","position":{"start":{"line":212,"column":75,"offset":6464},"end":{"line":212,"column":78,"offset":6467},"indent":[]}}],"position":{"start":{"line":212,"column":74,"offset":6463},"end":{"line":212,"column":125,"offset":6514},"indent":[]}}],"position":{"start":{"line":212,"column":3,"offset":6392},"end":{"line":212,"column":125,"offset":6514},"indent":[]}}],"position":{"start":{"line":212,"column":1,"offset":6390},"end":{"line":212,"column":125,"offset":6514},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added reboot and shutdown commands. ","position":{"start":{"line":213,"column":3,"offset":6517},"end":{"line":213,"column":39,"offset":6553},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/46","children":[{"type":"text","value":"#46","position":{"start":{"line":213,"column":40,"offset":6554},"end":{"line":213,"column":43,"offset":6557},"indent":[]}}],"position":{"start":{"line":213,"column":39,"offset":6553},"end":{"line":213,"column":90,"offset":6604},"indent":[]}}],"position":{"start":{"line":213,"column":3,"offset":6517},"end":{"line":213,"column":90,"offset":6604},"indent":[]}}],"position":{"start":{"line":213,"column":1,"offset":6515},"end":{"line":213,"column":90,"offset":6604},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added logging view to system page. ","position":{"start":{"line":214,"column":3,"offset":6607},"end":{"line":214,"column":38,"offset":6642},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/33","children":[{"type":"text","value":"#33","position":{"start":{"line":214,"column":39,"offset":6643},"end":{"line":214,"column":42,"offset":6646},"indent":[]}}],"position":{"start":{"line":214,"column":38,"offset":6642},"end":{"line":214,"column":89,"offset":6693},"indent":[]}}],"position":{"start":{"line":214,"column":3,"offset":6607},"end":{"line":214,"column":89,"offset":6693},"indent":[]}}],"position":{"start":{"line":214,"column":1,"offset":6605},"end":{"line":214,"column":89,"offset":6693},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added labels to check if machinery is running.","position":{"start":{"line":215,"column":3,"offset":6696},"end":{"line":215,"column":49,"offset":6742},"indent":[]}}],"position":{"start":{"line":215,"column":3,"offset":6696},"end":{"line":215,"column":49,"offset":6742},"indent":[]}}],"position":{"start":{"line":215,"column":1,"offset":6694},"end":{"line":215,"column":49,"offset":6742},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added error handling if web interface isn’t working properly.","position":{"start":{"line":216,"column":3,"offset":6745},"end":{"line":216,"column":64,"offset":6806},"indent":[]}}],"position":{"start":{"line":216,"column":3,"offset":6745},"end":{"line":216,"column":64,"offset":6806},"indent":[]}}],"position":{"start":{"line":216,"column":1,"offset":6743},"end":{"line":216,"column":64,"offset":6806},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fixed Heatmap.js fail to load by ad-blocker. ","position":{"start":{"line":217,"column":3,"offset":6809},"end":{"line":217,"column":48,"offset":6854},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/42","children":[{"type":"text","value":"#42","position":{"start":{"line":217,"column":49,"offset":6855},"end":{"line":217,"column":52,"offset":6858},"indent":[]}}],"position":{"start":{"line":217,"column":48,"offset":6854},"end":{"line":217,"column":99,"offset":6905},"indent":[]}}],"position":{"start":{"line":217,"column":3,"offset":6809},"end":{"line":217,"column":99,"offset":6905},"indent":[]}}],"position":{"start":{"line":217,"column":1,"offset":6807},"end":{"line":217,"column":99,"offset":6905},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Show additional information on the dashboard (streaming is opening or not) there is no data available.","position":{"start":{"line":218,"column":3,"offset":6908},"end":{"line":218,"column":105,"offset":7010},"indent":[]}}],"position":{"start":{"line":218,"column":3,"offset":6908},"end":{"line":218,"column":105,"offset":7010},"indent":[]}}],"position":{"start":{"line":218,"column":1,"offset":6906},"end":{"line":218,"column":105,"offset":7010},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Settings page is now visible on mobile (+ changed icon).","position":{"start":{"line":219,"column":3,"offset":7013},"end":{"line":219,"column":59,"offset":7069},"indent":[]}}],"position":{"start":{"line":219,"column":3,"offset":7013},"end":{"line":219,"column":59,"offset":7069},"indent":[]}}],"position":{"start":{"line":219,"column":1,"offset":7011},"end":{"line":219,"column":59,"offset":7069},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fixed sorting of news articles.","position":{"start":{"line":220,"column":3,"offset":7072},"end":{"line":220,"column":34,"offset":7103},"indent":[]}}],"position":{"start":{"line":220,"column":3,"offset":7072},"end":{"line":220,"column":34,"offset":7103},"indent":[]}}],"position":{"start":{"line":220,"column":1,"offset":7070},"end":{"line":220,"column":34,"offset":7103},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Removed links to assets in the cloud (.css files).","position":{"start":{"line":221,"column":3,"offset":7106},"end":{"line":221,"column":53,"offset":7156},"indent":[]}}],"position":{"start":{"line":221,"column":3,"offset":7106},"end":{"line":221,"column":53,"offset":7156},"indent":[]}}],"position":{"start":{"line":221,"column":1,"offset":7104},"end":{"line":221,"column":53,"offset":7156},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Design: improved layout of login page, async loading of image view.","position":{"start":{"line":222,"column":3,"offset":7159},"end":{"line":222,"column":70,"offset":7226},"indent":[]}}],"position":{"start":{"line":222,"column":3,"offset":7159},"end":{"line":222,"column":70,"offset":7226},"indent":[]}}],"position":{"start":{"line":222,"column":1,"offset":7157},"end":{"line":222,"column":70,"offset":7226},"indent":[]}}],"position":{"start":{"line":212,"column":1,"offset":6390},"end":{"line":222,"column":70,"offset":7226},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":224,"column":6,"offset":7233},"end":{"line":224,"column":15,"offset":7242},"indent":[]}}],"position":{"start":{"line":224,"column":1,"offset":7228},"end":{"line":224,"column":15,"offset":7242},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added configurable streaming port and quality. ","position":{"start":{"line":226,"column":3,"offset":7246},"end":{"line":226,"column":50,"offset":7293},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/41","children":[{"type":"text","value":"#41","position":{"start":{"line":226,"column":51,"offset":7294},"end":{"line":226,"column":54,"offset":7297},"indent":[]}}],"position":{"start":{"line":226,"column":50,"offset":7293},"end":{"line":226,"column":107,"offset":7350},"indent":[]}}],"position":{"start":{"line":226,"column":3,"offset":7246},"end":{"line":226,"column":107,"offset":7350},"indent":[]}}],"position":{"start":{"line":226,"column":1,"offset":7244},"end":{"line":226,"column":107,"offset":7350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added new algorithm: Background subtraction.","position":{"start":{"line":227,"column":3,"offset":7353},"end":{"line":227,"column":47,"offset":7397},"indent":[]}}],"position":{"start":{"line":227,"column":3,"offset":7353},"end":{"line":227,"column":47,"offset":7397},"indent":[]}}],"position":{"start":{"line":227,"column":1,"offset":7351},"end":{"line":227,"column":47,"offset":7397},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added new heuristic: Counter (for object/people counting). ","position":{"start":{"line":228,"column":3,"offset":7400},"end":{"line":228,"column":62,"offset":7459},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/42","children":[{"type":"text","value":"#42","position":{"start":{"line":228,"column":63,"offset":7460},"end":{"line":228,"column":66,"offset":7463},"indent":[]}}],"position":{"start":{"line":228,"column":62,"offset":7459},"end":{"line":228,"column":119,"offset":7516},"indent":[]}}],"position":{"start":{"line":228,"column":3,"offset":7400},"end":{"line":228,"column":119,"offset":7516},"indent":[]}}],"position":{"start":{"line":228,"column":1,"offset":7398},"end":{"line":228,"column":119,"offset":7516},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added video capture, which can be used for debugging purposes (replay a video fragment).","position":{"start":{"line":229,"column":3,"offset":7519},"end":{"line":229,"column":91,"offset":7607},"indent":[]}}],"position":{"start":{"line":229,"column":3,"offset":7519},"end":{"line":229,"column":91,"offset":7607},"indent":[]}}],"position":{"start":{"line":229,"column":1,"offset":7517},"end":{"line":229,"column":91,"offset":7607},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"It’s now possible to mark the images with a timestamp. ","position":{"start":{"line":230,"column":3,"offset":7610},"end":{"line":230,"column":58,"offset":7665},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/36","children":[{"type":"text","value":"#36","position":{"start":{"line":230,"column":59,"offset":7666},"end":{"line":230,"column":62,"offset":7669},"indent":[]}}],"position":{"start":{"line":230,"column":58,"offset":7665},"end":{"line":230,"column":115,"offset":7722},"indent":[]}}],"position":{"start":{"line":230,"column":3,"offset":7610},"end":{"line":230,"column":115,"offset":7722},"indent":[]}}],"position":{"start":{"line":230,"column":1,"offset":7608},"end":{"line":230,"column":115,"offset":7722},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fixed blocking streaming socket. ","position":{"start":{"line":231,"column":3,"offset":7725},"end":{"line":231,"column":36,"offset":7758},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/39","children":[{"type":"text","value":"#39","position":{"start":{"line":231,"column":37,"offset":7759},"end":{"line":231,"column":40,"offset":7762},"indent":[]}}],"position":{"start":{"line":231,"column":36,"offset":7758},"end":{"line":231,"column":93,"offset":7815},"indent":[]}}],"position":{"start":{"line":231,"column":3,"offset":7725},"end":{"line":231,"column":93,"offset":7815},"indent":[]}}],"position":{"start":{"line":231,"column":1,"offset":7723},"end":{"line":231,"column":93,"offset":7815},"indent":[]}}],"position":{"start":{"line":226,"column":1,"offset":7244},"end":{"line":231,"column":93,"offset":7815},"indent":[1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Ecosystem","position":{"start":{"line":233,"column":6,"offset":7822},"end":{"line":233,"column":15,"offset":7831},"indent":[]}}],"position":{"start":{"line":233,"column":1,"offset":7817},"end":{"line":233,"column":15,"offset":7831},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fix removal images if disk is almost full (wrong path was defined).","position":{"start":{"line":235,"column":3,"offset":7835},"end":{"line":235,"column":70,"offset":7902},"indent":[]}}],"position":{"start":{"line":235,"column":3,"offset":7835},"end":{"line":235,"column":70,"offset":7902},"indent":[]}}],"position":{"start":{"line":235,"column":1,"offset":7833},"end":{"line":235,"column":70,"offset":7902},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support for the Raspberry Pi Camera module v2.1. ","position":{"start":{"line":236,"column":3,"offset":7905},"end":{"line":236,"column":52,"offset":7954},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/kios/issues/3","children":[{"type":"text","value":"#3","position":{"start":{"line":236,"column":53,"offset":7955},"end":{"line":236,"column":55,"offset":7957},"indent":[]}}],"position":{"start":{"line":236,"column":52,"offset":7954},"end":{"line":236,"column":102,"offset":8004},"indent":[]}}],"position":{"start":{"line":236,"column":3,"offset":7905},"end":{"line":236,"column":102,"offset":8004},"indent":[]}}],"position":{"start":{"line":236,"column":1,"offset":7903},"end":{"line":236,"column":102,"offset":8004},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support for the Raspberry Pi Zero; updated kernel to latest Raspbian. ","position":{"start":{"line":237,"column":3,"offset":8007},"end":{"line":237,"column":73,"offset":8077},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/kios/issues/3","children":[{"type":"text","value":"#3","position":{"start":{"line":237,"column":74,"offset":8078},"end":{"line":237,"column":76,"offset":8080},"indent":[]}}],"position":{"start":{"line":237,"column":73,"offset":8077},"end":{"line":237,"column":123,"offset":8127},"indent":[]}}],"position":{"start":{"line":237,"column":3,"offset":8007},"end":{"line":237,"column":123,"offset":8127},"indent":[]}}],"position":{"start":{"line":237,"column":1,"offset":8005},"end":{"line":237,"column":123,"offset":8127},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"KiOS GUI installer.","position":{"start":{"line":238,"column":3,"offset":8130},"end":{"line":238,"column":22,"offset":8149},"indent":[]}}],"position":{"start":{"line":238,"column":3,"offset":8130},"end":{"line":238,"column":22,"offset":8149},"indent":[]}}],"position":{"start":{"line":238,"column":1,"offset":8128},"end":{"line":238,"column":22,"offset":8149},"indent":[]}}],"position":{"start":{"line":235,"column":1,"offset":7833},"end":{"line":238,"column":22,"offset":8149},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2.0.0","position":{"start":{"line":240,"column":5,"offset":8155},"end":{"line":240,"column":10,"offset":8160},"indent":[]}}],"position":{"start":{"line":240,"column":1,"offset":8151},"end":{"line":240,"column":10,"offset":8160},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":242,"column":6,"offset":8167},"end":{"line":242,"column":9,"offset":8170},"indent":[]}}],"position":{"start":{"line":242,"column":1,"offset":8162},"end":{"line":242,"column":9,"offset":8170},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Add simple ON/OFF toggle. ","position":{"start":{"line":244,"column":3,"offset":8174},"end":{"line":244,"column":29,"offset":8200},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/24","children":[{"type":"text","value":"#24","position":{"start":{"line":244,"column":30,"offset":8201},"end":{"line":244,"column":33,"offset":8204},"indent":[]}}],"position":{"start":{"line":244,"column":29,"offset":8200},"end":{"line":244,"column":80,"offset":8251},"indent":[]}}],"position":{"start":{"line":244,"column":3,"offset":8174},"end":{"line":244,"column":80,"offset":8251},"indent":[]}}],"position":{"start":{"line":244,"column":1,"offset":8172},"end":{"line":244,"column":80,"offset":8251},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added update strategy when using KiOS. ","position":{"start":{"line":245,"column":3,"offset":8254},"end":{"line":245,"column":42,"offset":8293},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/23","children":[{"type":"text","value":"#23","position":{"start":{"line":245,"column":43,"offset":8294},"end":{"line":245,"column":46,"offset":8297},"indent":[]}}],"position":{"start":{"line":245,"column":42,"offset":8293},"end":{"line":245,"column":93,"offset":8344},"indent":[]}}],"position":{"start":{"line":245,"column":3,"offset":8254},"end":{"line":245,"column":93,"offset":8344},"indent":[]}}],"position":{"start":{"line":245,"column":1,"offset":8252},"end":{"line":245,"column":93,"offset":8344},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"A system page which shows system information. ","position":{"start":{"line":246,"column":3,"offset":8347},"end":{"line":246,"column":49,"offset":8393},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/20","children":[{"type":"text","value":"#20","position":{"start":{"line":246,"column":50,"offset":8394},"end":{"line":246,"column":53,"offset":8397},"indent":[]}}],"position":{"start":{"line":246,"column":49,"offset":8393},"end":{"line":246,"column":100,"offset":8444},"indent":[]}}],"position":{"start":{"line":246,"column":3,"offset":8347},"end":{"line":246,"column":100,"offset":8444},"indent":[]}}],"position":{"start":{"line":246,"column":1,"offset":8345},"end":{"line":246,"column":100,"offset":8444},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Heatmap on dashboard page ","position":{"start":{"line":247,"column":3,"offset":8447},"end":{"line":247,"column":29,"offset":8473},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/19","children":[{"type":"text","value":"#19","position":{"start":{"line":247,"column":30,"offset":8474},"end":{"line":247,"column":33,"offset":8477},"indent":[]}}],"position":{"start":{"line":247,"column":29,"offset":8473},"end":{"line":247,"column":80,"offset":8524},"indent":[]}}],"position":{"start":{"line":247,"column":3,"offset":8447},"end":{"line":247,"column":80,"offset":8524},"indent":[]}}],"position":{"start":{"line":247,"column":1,"offset":8445},"end":{"line":247,"column":80,"offset":8524},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added live stream view on the dashboard page ","position":{"start":{"line":248,"column":3,"offset":8527},"end":{"line":248,"column":48,"offset":8572},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/2","children":[{"type":"text","value":"#2","position":{"start":{"line":248,"column":49,"offset":8573},"end":{"line":248,"column":51,"offset":8575},"indent":[]}}],"position":{"start":{"line":248,"column":48,"offset":8572},"end":{"line":248,"column":97,"offset":8621},"indent":[]}}],"position":{"start":{"line":248,"column":3,"offset":8527},"end":{"line":248,"column":97,"offset":8621},"indent":[]}}],"position":{"start":{"line":248,"column":1,"offset":8525},"end":{"line":248,"column":97,"offset":8621},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fixed bug cloud syncing ","position":{"start":{"line":249,"column":3,"offset":8624},"end":{"line":249,"column":27,"offset":8648},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/16","children":[{"type":"text","value":"#16","position":{"start":{"line":249,"column":28,"offset":8649},"end":{"line":249,"column":31,"offset":8652},"indent":[]}}],"position":{"start":{"line":249,"column":27,"offset":8648},"end":{"line":249,"column":78,"offset":8699},"indent":[]}}],"position":{"start":{"line":249,"column":3,"offset":8624},"end":{"line":249,"column":78,"offset":8699},"indent":[]}}],"position":{"start":{"line":249,"column":1,"offset":8622},"end":{"line":249,"column":78,"offset":8699},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fixed broken settings page when space in instane name ","position":{"start":{"line":250,"column":3,"offset":8702},"end":{"line":250,"column":57,"offset":8756},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/16","children":[{"type":"text","value":"#16","position":{"start":{"line":250,"column":58,"offset":8757},"end":{"line":250,"column":61,"offset":8760},"indent":[]}}],"position":{"start":{"line":250,"column":57,"offset":8756},"end":{"line":250,"column":108,"offset":8807},"indent":[]}}],"position":{"start":{"line":250,"column":3,"offset":8702},"end":{"line":250,"column":108,"offset":8807},"indent":[]}}],"position":{"start":{"line":250,"column":1,"offset":8700},"end":{"line":250,"column":108,"offset":8807},"indent":[]}}],"position":{"start":{"line":244,"column":1,"offset":8172},"end":{"line":250,"column":108,"offset":8807},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":252,"column":6,"offset":8814},"end":{"line":252,"column":15,"offset":8823},"indent":[]}}],"position":{"start":{"line":252,"column":1,"offset":8809},"end":{"line":252,"column":15,"offset":8823},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"RTSP support for IP-camera's. ","position":{"start":{"line":254,"column":3,"offset":8827},"end":{"line":254,"column":33,"offset":8857},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/21","children":[{"type":"text","value":"#21","position":{"start":{"line":254,"column":34,"offset":8858},"end":{"line":254,"column":37,"offset":8861},"indent":[]}}],"position":{"start":{"line":254,"column":33,"offset":8857},"end":{"line":254,"column":90,"offset":8914},"indent":[]}}],"position":{"start":{"line":254,"column":3,"offset":8827},"end":{"line":254,"column":90,"offset":8914},"indent":[]}}],"position":{"start":{"line":254,"column":1,"offset":8825},"end":{"line":254,"column":90,"offset":8914},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Verbose logging. ","position":{"start":{"line":255,"column":3,"offset":8917},"end":{"line":255,"column":20,"offset":8934},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/35","children":[{"type":"text","value":"#35","position":{"start":{"line":255,"column":21,"offset":8935},"end":{"line":255,"column":24,"offset":8938},"indent":[]}}],"position":{"start":{"line":255,"column":20,"offset":8934},"end":{"line":255,"column":77,"offset":8991},"indent":[]}}],"position":{"start":{"line":255,"column":3,"offset":8917},"end":{"line":255,"column":77,"offset":8991},"indent":[]}}],"position":{"start":{"line":255,"column":1,"offset":8915},"end":{"line":255,"column":77,"offset":8991},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"IO-devices are executed in a seperate thread. ","position":{"start":{"line":256,"column":3,"offset":8994},"end":{"line":256,"column":49,"offset":9040},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/28","children":[{"type":"text","value":"#28","position":{"start":{"line":256,"column":50,"offset":9041},"end":{"line":256,"column":53,"offset":9044},"indent":[]}}],"position":{"start":{"line":256,"column":49,"offset":9040},"end":{"line":256,"column":106,"offset":9097},"indent":[]}}],"position":{"start":{"line":256,"column":3,"offset":8994},"end":{"line":256,"column":106,"offset":9097},"indent":[]}}],"position":{"start":{"line":256,"column":1,"offset":8992},"end":{"line":256,"column":106,"offset":9097},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Live streaming (MJPEG). ","position":{"start":{"line":257,"column":3,"offset":9100},"end":{"line":257,"column":27,"offset":9124},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/26","children":[{"type":"text","value":"#26","position":{"start":{"line":257,"column":28,"offset":9125},"end":{"line":257,"column":31,"offset":9128},"indent":[]}}],"position":{"start":{"line":257,"column":27,"offset":9124},"end":{"line":257,"column":84,"offset":9181},"indent":[]}}],"position":{"start":{"line":257,"column":3,"offset":9100},"end":{"line":257,"column":84,"offset":9181},"indent":[]}}],"position":{"start":{"line":257,"column":1,"offset":9098},"end":{"line":257,"column":84,"offset":9181},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Execute multiple instances on a machine. ","position":{"start":{"line":258,"column":3,"offset":9184},"end":{"line":258,"column":44,"offset":9225},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/24","children":[{"type":"text","value":"#24","position":{"start":{"line":258,"column":45,"offset":9226},"end":{"line":258,"column":48,"offset":9229},"indent":[]}}],"position":{"start":{"line":258,"column":44,"offset":9225},"end":{"line":258,"column":101,"offset":9282},"indent":[]}}],"position":{"start":{"line":258,"column":3,"offset":9184},"end":{"line":258,"column":101,"offset":9282},"indent":[]}}],"position":{"start":{"line":258,"column":1,"offset":9182},"end":{"line":258,"column":101,"offset":9282},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Override config by arguments. ","position":{"start":{"line":259,"column":3,"offset":9285},"end":{"line":259,"column":33,"offset":9315},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/22","children":[{"type":"text","value":"#22","position":{"start":{"line":259,"column":34,"offset":9316},"end":{"line":259,"column":37,"offset":9319},"indent":[]}}],"position":{"start":{"line":259,"column":33,"offset":9315},"end":{"line":259,"column":90,"offset":9372},"indent":[]}}],"position":{"start":{"line":259,"column":3,"offset":9285},"end":{"line":259,"column":90,"offset":9372},"indent":[]}}],"position":{"start":{"line":259,"column":1,"offset":9283},"end":{"line":259,"column":90,"offset":9372},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Move S3 upload to machinery and remove sync-s3 repository. ","position":{"start":{"line":260,"column":3,"offset":9375},"end":{"line":260,"column":62,"offset":9434},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/16","children":[{"type":"text","value":"#16","position":{"start":{"line":260,"column":63,"offset":9435},"end":{"line":260,"column":66,"offset":9438},"indent":[]}}],"position":{"start":{"line":260,"column":62,"offset":9434},"end":{"line":260,"column":119,"offset":9491},"indent":[]}}],"position":{"start":{"line":260,"column":3,"offset":9375},"end":{"line":260,"column":119,"offset":9491},"indent":[]}}],"position":{"start":{"line":260,"column":1,"offset":9373},"end":{"line":260,"column":119,"offset":9491},"indent":[]}}],"position":{"start":{"line":254,"column":1,"offset":8825},"end":{"line":260,"column":119,"offset":9491},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Docker","position":{"start":{"line":262,"column":6,"offset":9498},"end":{"line":262,"column":12,"offset":9504},"indent":[]}}],"position":{"start":{"line":262,"column":1,"offset":9493},"end":{"line":262,"column":12,"offset":9504},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added Docker image (x86_x64) to Docker Hub.","position":{"start":{"line":264,"column":3,"offset":9508},"end":{"line":264,"column":46,"offset":9551},"indent":[]}}],"position":{"start":{"line":264,"column":3,"offset":9508},"end":{"line":264,"column":46,"offset":9551},"indent":[]}}],"position":{"start":{"line":264,"column":1,"offset":9506},"end":{"line":264,"column":46,"offset":9551},"indent":[]}}],"position":{"start":{"line":264,"column":1,"offset":9506},"end":{"line":264,"column":46,"offset":9551},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Ecosystem","position":{"start":{"line":266,"column":6,"offset":9558},"end":{"line":266,"column":15,"offset":9567},"indent":[]}}],"position":{"start":{"line":266,"column":1,"offset":9553},"end":{"line":266,"column":15,"offset":9567},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Add support for Raspberry Pi 1, 2 and 3. ","position":{"start":{"line":268,"column":3,"offset":9571},"end":{"line":268,"column":44,"offset":9612},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/kios/issues/1","children":[{"type":"text","value":"#1","position":{"start":{"line":268,"column":45,"offset":9613},"end":{"line":268,"column":47,"offset":9615},"indent":[]}}],"position":{"start":{"line":268,"column":44,"offset":9612},"end":{"line":268,"column":94,"offset":9662},"indent":[]}}],"position":{"start":{"line":268,"column":3,"offset":9571},"end":{"line":268,"column":94,"offset":9662},"indent":[]}}],"position":{"start":{"line":268,"column":1,"offset":9569},"end":{"line":268,"column":94,"offset":9662},"indent":[]}}],"position":{"start":{"line":268,"column":1,"offset":9569},"end":{"line":268,"column":94,"offset":9662},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1.1.0","position":{"start":{"line":270,"column":5,"offset":9668},"end":{"line":270,"column":10,"offset":9673},"indent":[]}}],"position":{"start":{"line":270,"column":1,"offset":9664},"end":{"line":270,"column":10,"offset":9673},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":272,"column":6,"offset":9680},"end":{"line":272,"column":9,"offset":9683},"indent":[]}}],"position":{"start":{"line":272,"column":1,"offset":9675},"end":{"line":272,"column":9,"offset":9683},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support IP camera's with MJPEG stream. ","position":{"start":{"line":274,"column":3,"offset":9687},"end":{"line":274,"column":42,"offset":9726},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/3","children":[{"type":"text","value":"#3","position":{"start":{"line":274,"column":43,"offset":9727},"end":{"line":274,"column":45,"offset":9729},"indent":[]}}],"position":{"start":{"line":274,"column":42,"offset":9726},"end":{"line":274,"column":91,"offset":9775},"indent":[]}}],"position":{"start":{"line":274,"column":3,"offset":9687},"end":{"line":274,"column":91,"offset":9775},"indent":[]}}],"position":{"start":{"line":274,"column":1,"offset":9685},"end":{"line":274,"column":91,"offset":9775},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Introduce new API methods to configure the machinery, using basic auth. ","position":{"start":{"line":275,"column":3,"offset":9778},"end":{"line":275,"column":75,"offset":9850},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/4","children":[{"type":"text","value":"#4","position":{"start":{"line":275,"column":76,"offset":9851},"end":{"line":275,"column":78,"offset":9853},"indent":[]}}],"position":{"start":{"line":275,"column":75,"offset":9850},"end":{"line":275,"column":124,"offset":9899},"indent":[]}}],"position":{"start":{"line":275,"column":3,"offset":9778},"end":{"line":275,"column":124,"offset":9899},"indent":[]}}],"position":{"start":{"line":275,"column":1,"offset":9776},"end":{"line":275,"column":124,"offset":9899},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Optimization of loading image and dashboard page, completely redesigned the retrieval of images. ","position":{"start":{"line":276,"column":3,"offset":9902},"end":{"line":276,"column":100,"offset":9999},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/5","children":[{"type":"text","value":"#5","position":{"start":{"line":276,"column":101,"offset":10000},"end":{"line":276,"column":103,"offset":10002},"indent":[]}}],"position":{"start":{"line":276,"column":100,"offset":9999},"end":{"line":276,"column":149,"offset":10048},"indent":[]}}],"position":{"start":{"line":276,"column":3,"offset":9902},"end":{"line":276,"column":149,"offset":10048},"indent":[]}}],"position":{"start":{"line":276,"column":1,"offset":9900},"end":{"line":276,"column":149,"offset":10048},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Optimization of settings page. ","position":{"start":{"line":277,"column":3,"offset":10051},"end":{"line":277,"column":34,"offset":10082},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/5","children":[{"type":"text","value":"#5","position":{"start":{"line":277,"column":35,"offset":10083},"end":{"line":277,"column":37,"offset":10085},"indent":[]}}],"position":{"start":{"line":277,"column":34,"offset":10082},"end":{"line":277,"column":83,"offset":10131},"indent":[]}}],"position":{"start":{"line":277,"column":3,"offset":10051},"end":{"line":277,"column":83,"offset":10131},"indent":[]}}],"position":{"start":{"line":277,"column":1,"offset":10049},"end":{"line":277,"column":83,"offset":10131},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Timebar gradient only works in Chrome. ","position":{"start":{"line":278,"column":3,"offset":10134},"end":{"line":278,"column":42,"offset":10173},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/web/issues/6","children":[{"type":"text","value":"#6","position":{"start":{"line":278,"column":43,"offset":10174},"end":{"line":278,"column":45,"offset":10176},"indent":[]}}],"position":{"start":{"line":278,"column":42,"offset":10173},"end":{"line":278,"column":91,"offset":10222},"indent":[]}}],"position":{"start":{"line":278,"column":3,"offset":10134},"end":{"line":278,"column":91,"offset":10222},"indent":[]}}],"position":{"start":{"line":278,"column":1,"offset":10132},"end":{"line":278,"column":91,"offset":10222},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Minor CSS fixes for responsive layout.","position":{"start":{"line":279,"column":3,"offset":10225},"end":{"line":279,"column":41,"offset":10263},"indent":[]}}],"position":{"start":{"line":279,"column":3,"offset":10225},"end":{"line":279,"column":41,"offset":10263},"indent":[]}}],"position":{"start":{"line":279,"column":1,"offset":10223},"end":{"line":279,"column":41,"offset":10263},"indent":[]}}],"position":{"start":{"line":274,"column":1,"offset":9685},"end":{"line":279,"column":41,"offset":10263},"indent":[1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":281,"column":6,"offset":10270},"end":{"line":281,"column":15,"offset":10279},"indent":[]}}],"position":{"start":{"line":281,"column":1,"offset":10265},"end":{"line":281,"column":15,"offset":10279},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Flip/rotate option for capture devices. ","position":{"start":{"line":283,"column":3,"offset":10283},"end":{"line":283,"column":43,"offset":10323},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/1","children":[{"type":"text","value":"#5","position":{"start":{"line":283,"column":44,"offset":10324},"end":{"line":283,"column":46,"offset":10326},"indent":[]}}],"position":{"start":{"line":283,"column":43,"offset":10323},"end":{"line":283,"column":98,"offset":10378},"indent":[]}}],"position":{"start":{"line":283,"column":3,"offset":10283},"end":{"line":283,"column":98,"offset":10378},"indent":[]}}],"position":{"start":{"line":283,"column":1,"offset":10281},"end":{"line":283,"column":98,"offset":10378},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Support IP camera's with MJPEG stream. ","position":{"start":{"line":284,"column":3,"offset":10381},"end":{"line":284,"column":42,"offset":10420},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/4","children":[{"type":"text","value":"#4","position":{"start":{"line":284,"column":43,"offset":10421},"end":{"line":284,"column":45,"offset":10423},"indent":[]}}],"position":{"start":{"line":284,"column":42,"offset":10420},"end":{"line":284,"column":97,"offset":10475},"indent":[]}}],"position":{"start":{"line":284,"column":3,"offset":10381},"end":{"line":284,"column":97,"offset":10475},"indent":[]}}],"position":{"start":{"line":284,"column":1,"offset":10379},"end":{"line":284,"column":97,"offset":10475},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Introduced webhook io device. ","position":{"start":{"line":285,"column":3,"offset":10478},"end":{"line":285,"column":33,"offset":10508},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/issues/5","children":[{"type":"text","value":"#5","position":{"start":{"line":285,"column":34,"offset":10509},"end":{"line":285,"column":36,"offset":10511},"indent":[]}}],"position":{"start":{"line":285,"column":33,"offset":10508},"end":{"line":285,"column":88,"offset":10563},"indent":[]}}],"position":{"start":{"line":285,"column":3,"offset":10478},"end":{"line":285,"column":88,"offset":10563},"indent":[]}}],"position":{"start":{"line":285,"column":1,"offset":10476},"end":{"line":285,"column":88,"offset":10563},"indent":[]}}],"position":{"start":{"line":283,"column":1,"offset":10281},"end":{"line":285,"column":88,"offset":10563},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Cloud","position":{"start":{"line":287,"column":6,"offset":10570},"end":{"line":287,"column":11,"offset":10575},"indent":[]}}],"position":{"start":{"line":287,"column":1,"offset":10565},"end":{"line":287,"column":11,"offset":10575},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Fixed problem when syncing a huge amount of images. ","position":{"start":{"line":289,"column":3,"offset":10579},"end":{"line":289,"column":55,"offset":10631},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/sync-s3/issues/1","children":[{"type":"text","value":"#1","position":{"start":{"line":289,"column":56,"offset":10632},"end":{"line":289,"column":58,"offset":10634},"indent":[]}}],"position":{"start":{"line":289,"column":55,"offset":10631},"end":{"line":289,"column":108,"offset":10684},"indent":[]}}],"position":{"start":{"line":289,"column":3,"offset":10579},"end":{"line":289,"column":108,"offset":10684},"indent":[]}}],"position":{"start":{"line":289,"column":1,"offset":10577},"end":{"line":289,"column":108,"offset":10684},"indent":[]}}],"position":{"start":{"line":289,"column":1,"offset":10577},"end":{"line":289,"column":108,"offset":10684},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1.0.3","position":{"start":{"line":291,"column":5,"offset":10690},"end":{"line":291,"column":10,"offset":10695},"indent":[]}}],"position":{"start":{"line":291,"column":1,"offset":10686},"end":{"line":291,"column":10,"offset":10695},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":293,"column":6,"offset":10702},"end":{"line":293,"column":9,"offset":10705},"indent":[]}}],"position":{"start":{"line":293,"column":1,"offset":10697},"end":{"line":293,"column":9,"offset":10705},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Optimize performance, new datastructure has been implemented.","position":{"start":{"line":295,"column":3,"offset":10709},"end":{"line":295,"column":64,"offset":10770},"indent":[]}}],"position":{"start":{"line":295,"column":3,"offset":10709},"end":{"line":295,"column":64,"offset":10770},"indent":[]}}],"position":{"start":{"line":295,"column":1,"offset":10707},"end":{"line":295,"column":64,"offset":10770},"indent":[]}}],"position":{"start":{"line":295,"column":1,"offset":10707},"end":{"line":295,"column":64,"offset":10770},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":297,"column":6,"offset":10777},"end":{"line":297,"column":15,"offset":10786},"indent":[]}}],"position":{"start":{"line":297,"column":1,"offset":10772},"end":{"line":297,"column":15,"offset":10786},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Memory optimization.","position":{"start":{"line":299,"column":3,"offset":10790},"end":{"line":299,"column":23,"offset":10810},"indent":[]}}],"position":{"start":{"line":299,"column":3,"offset":10790},"end":{"line":299,"column":23,"offset":10810},"indent":[]}}],"position":{"start":{"line":299,"column":1,"offset":10788},"end":{"line":299,"column":23,"offset":10810},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Removal of images older than 3 days have been removed.","position":{"start":{"line":300,"column":3,"offset":10813},"end":{"line":300,"column":57,"offset":10867},"indent":[]}}],"position":{"start":{"line":300,"column":3,"offset":10813},"end":{"line":300,"column":57,"offset":10867},"indent":[]}}],"position":{"start":{"line":300,"column":1,"offset":10811},"end":{"line":300,"column":57,"offset":10867},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Start machinery automatically (delay has been removed).","position":{"start":{"line":301,"column":3,"offset":10870},"end":{"line":301,"column":58,"offset":10925},"indent":[]}}],"position":{"start":{"line":301,"column":3,"offset":10870},"end":{"line":301,"column":58,"offset":10925},"indent":[]}}],"position":{"start":{"line":301,"column":1,"offset":10868},"end":{"line":301,"column":58,"offset":10925},"indent":[]}}],"position":{"start":{"line":299,"column":1,"offset":10788},"end":{"line":301,"column":58,"offset":10925},"indent":[1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Cloud","position":{"start":{"line":303,"column":6,"offset":10932},"end":{"line":303,"column":11,"offset":10937},"indent":[]}}],"position":{"start":{"line":303,"column":1,"offset":10927},"end":{"line":303,"column":11,"offset":10937},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Resolved file exist problem.","position":{"start":{"line":305,"column":3,"offset":10941},"end":{"line":305,"column":31,"offset":10969},"indent":[]}}],"position":{"start":{"line":305,"column":3,"offset":10941},"end":{"line":305,"column":31,"offset":10969},"indent":[]}}],"position":{"start":{"line":305,"column":1,"offset":10939},"end":{"line":305,"column":31,"offset":10969},"indent":[]}}],"position":{"start":{"line":305,"column":1,"offset":10939},"end":{"line":305,"column":31,"offset":10969},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1.0.2","position":{"start":{"line":307,"column":5,"offset":10975},"end":{"line":307,"column":10,"offset":10980},"indent":[]}}],"position":{"start":{"line":307,"column":1,"offset":10971},"end":{"line":307,"column":10,"offset":10980},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":309,"column":6,"offset":10987},"end":{"line":309,"column":9,"offset":10990},"indent":[]}}],"position":{"start":{"line":309,"column":1,"offset":10982},"end":{"line":309,"column":9,"offset":10990},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Timezone on settings page is also used for the webinterface.","position":{"start":{"line":311,"column":3,"offset":10994},"end":{"line":311,"column":63,"offset":11054},"indent":[]}}],"position":{"start":{"line":311,"column":3,"offset":10994},"end":{"line":311,"column":63,"offset":11054},"indent":[]}}],"position":{"start":{"line":311,"column":1,"offset":10992},"end":{"line":311,"column":63,"offset":11054},"indent":[]}}],"position":{"start":{"line":311,"column":1,"offset":10992},"end":{"line":311,"column":63,"offset":11054},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":313,"column":6,"offset":11061},"end":{"line":313,"column":15,"offset":11070},"indent":[]}}],"position":{"start":{"line":313,"column":1,"offset":11056},"end":{"line":313,"column":15,"offset":11070},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Added extra timezones to timezone.xml.","position":{"start":{"line":315,"column":3,"offset":11074},"end":{"line":315,"column":41,"offset":11112},"indent":[]}}],"position":{"start":{"line":315,"column":3,"offset":11074},"end":{"line":315,"column":41,"offset":11112},"indent":[]}}],"position":{"start":{"line":315,"column":1,"offset":11072},"end":{"line":315,"column":41,"offset":11112},"indent":[]}}],"position":{"start":{"line":315,"column":1,"offset":11072},"end":{"line":315,"column":41,"offset":11112},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1.0.1","position":{"start":{"line":317,"column":5,"offset":11118},"end":{"line":317,"column":10,"offset":11123},"indent":[]}}],"position":{"start":{"line":317,"column":1,"offset":11114},"end":{"line":317,"column":10,"offset":11123},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Web","position":{"start":{"line":319,"column":6,"offset":11130},"end":{"line":319,"column":9,"offset":11133},"indent":[]}}],"position":{"start":{"line":319,"column":1,"offset":11125},"end":{"line":319,"column":9,"offset":11133},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Improved error handling (date search).","position":{"start":{"line":321,"column":3,"offset":11137},"end":{"line":321,"column":41,"offset":11175},"indent":[]}}],"position":{"start":{"line":321,"column":3,"offset":11137},"end":{"line":321,"column":41,"offset":11175},"indent":[]}}],"position":{"start":{"line":321,"column":1,"offset":11135},"end":{"line":321,"column":41,"offset":11175},"indent":[]}}],"position":{"start":{"line":321,"column":1,"offset":11135},"end":{"line":321,"column":41,"offset":11175},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":323,"column":6,"offset":11182},"end":{"line":323,"column":15,"offset":11191},"indent":[]}}],"position":{"start":{"line":323,"column":1,"offset":11177},"end":{"line":323,"column":15,"offset":11191},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Improved memory cleanup.","position":{"start":{"line":325,"column":3,"offset":11195},"end":{"line":325,"column":27,"offset":11219},"indent":[]}}],"position":{"start":{"line":325,"column":3,"offset":11195},"end":{"line":325,"column":27,"offset":11219},"indent":[]}}],"position":{"start":{"line":325,"column":1,"offset":11193},"end":{"line":325,"column":27,"offset":11219},"indent":[]}}],"position":{"start":{"line":325,"column":1,"offset":11193},"end":{"line":325,"column":27,"offset":11219},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1.0.0","position":{"start":{"line":327,"column":5,"offset":11225},"end":{"line":327,"column":10,"offset":11230},"indent":[]}}],"position":{"start":{"line":327,"column":1,"offset":11221},"end":{"line":327,"column":10,"offset":11230},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"First commit of Kerberos.io","position":{"start":{"line":329,"column":6,"offset":11237},"end":{"line":329,"column":33,"offset":11264},"indent":[]}}],"position":{"start":{"line":329,"column":1,"offset":11232},"end":{"line":329,"column":33,"offset":11264},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Camera support: ","position":{"start":{"line":331,"column":3,"offset":11268},"end":{"line":331,"column":19,"offset":11284},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"USBCamera","position":{"start":{"line":331,"column":21,"offset":11286},"end":{"line":331,"column":30,"offset":11295},"indent":[]}}],"position":{"start":{"line":331,"column":19,"offset":11284},"end":{"line":331,"column":32,"offset":11297},"indent":[]}},{"type":"text","value":" (V4L), ","position":{"start":{"line":331,"column":32,"offset":11297},"end":{"line":331,"column":40,"offset":11305},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Raspberry Pi camera module","position":{"start":{"line":331,"column":42,"offset":11307},"end":{"line":331,"column":68,"offset":11333},"indent":[]}}],"position":{"start":{"line":331,"column":40,"offset":11305},"end":{"line":331,"column":70,"offset":11335},"indent":[]}},{"type":"text","value":" (MMAL).","position":{"start":{"line":331,"column":70,"offset":11335},"end":{"line":331,"column":78,"offset":11343},"indent":[]}}],"position":{"start":{"line":331,"column":3,"offset":11268},"end":{"line":331,"column":78,"offset":11343},"indent":[]}}],"position":{"start":{"line":331,"column":1,"offset":11266},"end":{"line":331,"column":78,"offset":11343},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Conditions: ","position":{"start":{"line":332,"column":3,"offset":11346},"end":{"line":332,"column":15,"offset":11358},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Enabled","position":{"start":{"line":332,"column":17,"offset":11360},"end":{"line":332,"column":24,"offset":11367},"indent":[]}}],"position":{"start":{"line":332,"column":15,"offset":11358},"end":{"line":332,"column":26,"offset":11369},"indent":[]}},{"type":"text","value":" (turn on/off Kerberos) and active ","position":{"start":{"line":332,"column":26,"offset":11369},"end":{"line":332,"column":61,"offset":11404},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Time","position":{"start":{"line":332,"column":63,"offset":11406},"end":{"line":332,"column":67,"offset":11410},"indent":[]}}],"position":{"start":{"line":332,"column":61,"offset":11404},"end":{"line":332,"column":69,"offset":11412},"indent":[]}},{"type":"text","value":" per day.","position":{"start":{"line":332,"column":69,"offset":11412},"end":{"line":332,"column":78,"offset":11421},"indent":[]}}],"position":{"start":{"line":332,"column":3,"offset":11346},"end":{"line":332,"column":78,"offset":11421},"indent":[]}}],"position":{"start":{"line":332,"column":1,"offset":11344},"end":{"line":332,"column":78,"offset":11421},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Algorithms: ","position":{"start":{"line":333,"column":3,"offset":11424},"end":{"line":333,"column":15,"offset":11436},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Differential Images","position":{"start":{"line":333,"column":17,"offset":11438},"end":{"line":333,"column":36,"offset":11457},"indent":[]}}],"position":{"start":{"line":333,"column":15,"offset":11436},"end":{"line":333,"column":38,"offset":11459},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":333,"column":38,"offset":11459},"end":{"line":333,"column":39,"offset":11460},"indent":[]}}],"position":{"start":{"line":333,"column":3,"offset":11424},"end":{"line":333,"column":39,"offset":11460},"indent":[]}}],"position":{"start":{"line":333,"column":1,"offset":11422},"end":{"line":333,"column":39,"offset":11460},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Heuristics: ","position":{"start":{"line":334,"column":3,"offset":11463},"end":{"line":334,"column":15,"offset":11475},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Sequence","position":{"start":{"line":334,"column":17,"offset":11477},"end":{"line":334,"column":25,"offset":11485},"indent":[]}}],"position":{"start":{"line":334,"column":15,"offset":11475},"end":{"line":334,"column":27,"offset":11487},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":334,"column":27,"offset":11487},"end":{"line":334,"column":28,"offset":11488},"indent":[]}}],"position":{"start":{"line":334,"column":3,"offset":11463},"end":{"line":334,"column":28,"offset":11488},"indent":[]}}],"position":{"start":{"line":334,"column":1,"offset":11461},"end":{"line":334,"column":28,"offset":11488},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Expositors: Select a ","position":{"start":{"line":335,"column":3,"offset":11491},"end":{"line":335,"column":24,"offset":11512},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Hull","position":{"start":{"line":335,"column":26,"offset":11514},"end":{"line":335,"column":30,"offset":11518},"indent":[]}}],"position":{"start":{"line":335,"column":24,"offset":11512},"end":{"line":335,"column":32,"offset":11520},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":335,"column":32,"offset":11520},"end":{"line":335,"column":36,"offset":11524},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Rectangle","position":{"start":{"line":335,"column":38,"offset":11526},"end":{"line":335,"column":47,"offset":11535},"indent":[]}}],"position":{"start":{"line":335,"column":36,"offset":11524},"end":{"line":335,"column":49,"offset":11537},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":335,"column":49,"offset":11537},"end":{"line":335,"column":50,"offset":11538},"indent":[]}}],"position":{"start":{"line":335,"column":3,"offset":11491},"end":{"line":335,"column":50,"offset":11538},"indent":[]}}],"position":{"start":{"line":335,"column":1,"offset":11489},"end":{"line":335,"column":50,"offset":11538},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Outputs: Write image to ","position":{"start":{"line":336,"column":3,"offset":11541},"end":{"line":336,"column":27,"offset":11565},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Disk","position":{"start":{"line":336,"column":29,"offset":11567},"end":{"line":336,"column":33,"offset":11571},"indent":[]}}],"position":{"start":{"line":336,"column":27,"offset":11565},"end":{"line":336,"column":35,"offset":11573},"indent":[]}},{"type":"text","value":", trigger an ","position":{"start":{"line":336,"column":35,"offset":11573},"end":{"line":336,"column":48,"offset":11586},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"GPIO","position":{"start":{"line":336,"column":50,"offset":11588},"end":{"line":336,"column":54,"offset":11592},"indent":[]}}],"position":{"start":{"line":336,"column":48,"offset":11586},"end":{"line":336,"column":56,"offset":11594},"indent":[]}},{"type":"text","value":" output pin and send a ","position":{"start":{"line":336,"column":56,"offset":11594},"end":{"line":336,"column":79,"offset":11617},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"TCP/IP packet","position":{"start":{"line":336,"column":81,"offset":11619},"end":{"line":336,"column":94,"offset":11632},"indent":[]}}],"position":{"start":{"line":336,"column":79,"offset":11617},"end":{"line":336,"column":96,"offset":11634},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":336,"column":96,"offset":11634},"end":{"line":336,"column":97,"offset":11635},"indent":[]}}],"position":{"start":{"line":336,"column":3,"offset":11541},"end":{"line":336,"column":97,"offset":11635},"indent":[]}}],"position":{"start":{"line":336,"column":1,"offset":11539},"end":{"line":336,"column":97,"offset":11635},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Cloud: send your images to the ","position":{"start":{"line":337,"column":3,"offset":11638},"end":{"line":337,"column":34,"offset":11669},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Kerberos.io cloud aplication","position":{"start":{"line":337,"column":36,"offset":11671},"end":{"line":337,"column":64,"offset":11699},"indent":[]}}],"position":{"start":{"line":337,"column":34,"offset":11669},"end":{"line":337,"column":66,"offset":11701},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":337,"column":66,"offset":11701},"end":{"line":337,"column":67,"offset":11702},"indent":[]}}],"position":{"start":{"line":337,"column":3,"offset":11638},"end":{"line":337,"column":67,"offset":11702},"indent":[]}}],"position":{"start":{"line":337,"column":1,"offset":11636},"end":{"line":337,"column":67,"offset":11702},"indent":[]}}],"position":{"start":{"line":331,"column":1,"offset":11266},"end":{"line":337,"column":67,"offset":11702},"indent":[1,1,1,1,1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":340,"column":1,"offset":11705},"end":{"line":340,"column":31,"offset":11735},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":340,"column":31,"offset":11735}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Release notes`}

\n

{`2.8.0`}

\n

{`Aligned machinery, web and KiOS versions. Too many people were confused by the versioning.`}

\n

{`Web`}

\n
    \n
  • {`Videos displayed on canvas were blocked in latest browsers.`}
    • \n
  • {`Disabled reboot and shutdown.`}
    • \n
  • {`Disabled upgrade process, use fwupdate shell command instead.`}
    • \n
\n

{`KiOS`}

\n
    \n
  • {`Major upgrade, solved many different problems (list to long); not possible to upgrade from 2.7.0 to 2.8.0.`}
    • \n
  • {`Updated firmware to latest Raspbian (raspberrypi-kernel_1.20180417-1).`}
    • \n
  • {`Support for the Raspberry Pi 4.`}
    • \n
\n

{`2.7.2`}

\n

{`Machinery`}

\n
    \n
  • {`To optimise the cloud experience we've added a proxy.kerberos.io machine in between.`}
    • \n
  • {`We've changed the S3 storage scheme (class:ONEZONE_IA).`}
    • \n
\n

{`2.7.1`}

\n

{`Machinery`}

\n
    \n
  • {`Resolved deadlock with livestreaming while restarting machinery.`}
    • \n
  • {`Revert logging library; enabled log rotating.`}
    • \n
\n

{`KiOS`}

\n
    \n
  • {`Updated firmware to latest Raspbian (raspberrypi-kernel_1.20180417-1).`}
    • \n
  • {`Resolved issue with WIFI on Raspberry Pi 3B+`}
    • \n
\n

{`2.7.0`}

\n

{`Web`}

\n
    \n
  • {`Unique session cookie, which allows to open multiple web interfaces (e.g. when using docker).`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Added live streaming feature for app.kerberos.io`}
    • \n
  • {`Upgraded logging library: log file can be max 5MB, and will rotate.`}
    • \n
  • {`Better logging for cloud uploads (failed information).`}
    • \n
\n

{`Docker`}

\n
    \n
  • {`No longer need docker-compose, we merged the web and machinery containers to `}{`a single container`}{`.`}
    • \n
\n

{`KiOS`}

\n
    \n
  • {`Updated firmware to latest Raspbian.`}
    • \n
  • {`Support for the Raspberry Pi 3B+.`}
    • \n
\n

{`2.6.1`}

\n

{`Web`}

\n
    \n
  • {`Solved issue with persisting login configuration. `}{`#111`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Added Pushbullet. `}{`#139`}
    • \n
  • {`Cloud upload was not longer working (hotfix also in 2.6.0).`}
    • \n
\n

{`2.6.0`}

\n

{`Web`}

\n
    \n
  • {`Add a cloud connection verification method. `}{`#112`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Add background color timestamp. `}{`#128`}
    • \n
  • {`Send instanceId in AWS header when uploading to cloud (necessary for new cloud app).`}
    • \n
  • {`Better support for Chinese IP cameras.`}
    • \n
\n

{`Docker`}

\n
    \n
  • {`Bug: Autoremove old images/video within Docker Containers. `}{`#104`}
    • \n
\n

{`2.5.0`}

\n

{`Web`}

\n
    \n
  • {`Added Chinese and Italian language.`}
    • \n
  • {`Resolved issue with INSTALLED=true.`}
    • \n
  • {`Make latest_sequence available with basic auth. `}{`#99`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Provide an IO service for publishing events to MQTT. `}{`#89`}
    • \n
  • {`Optimize recording with H264_OMX. `}{`#83`}
    • \n
  • {`Implement throttler for Io detections. `}{`#96`}
    • \n
  • {`SSL version 1.0.0 is no longer accessible in Raspbian. `}{`#109`}
    • \n
\n

{`2.4.2`}

\n

{`Web`}

\n
    \n
  • {`Typo in french translation, causes the web interface crash.`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Resolved major bug in livestream: memory leak in stream class. `}{`#94`}
    • \n
  • {`Capture health verification: check if the chosen capture device is still grabbing (and didn't stalled).`}
    • \n
  • {`Extra logging when recording with raspberry pi camera.`}
    • \n
  • {`Make sure the cloud upload is functioning properly, after an upload it's verified if the files really exist in the cloud.`}
    • \n
\n

{`2.4.1`}

\n

{`Web`}

\n
    \n
  • {`Show warning when system is disabled. `}{`#88`}{`.`}
    • \n
  • {`Hull selector in basic view not always working.`}
    • \n
\n

{`2.4.0`}

\n

{`Ecosystem`}

\n
    \n
  • {`Enable/Disable force network mode.`}
    • \n
  • {`Enable/Disable auto removal media.`}
    • \n
\n

{`Web`}

\n
    \n
  • {`Upgrade from Laravel 4.2 to Laravel 5.4 `}{`#70`}{`.`}
    • \n
  • {`Fix bug with heatmap radius slider `}{`#84`}{`.`}
    • \n
  • {`Design tweaks toggle button (remove outline).`}
    • \n
  • {`Disabled possibility to timestamp video when using hardware acceleration.`}
    • \n
\n

{`Docker`}

\n
    \n
  • {`Fix SSL support `}{`#4`}{`.`}
    • \n
  • {`Auto removal if disk is full.`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`OpenMAX IL hardware encoding for Raspberry Pi camera. `}{`#83`}
      \n
    • {`Optimized live streaming.`}
      • \n
    • {`Optimized h264 recording.`}
      • \n
    • \n
  • {`Basic authentication for live streaming (username and password). `}{`#80`}
    • \n
\n

{`2.3.1`}

\n

{`Machinery`}

\n
    \n
  • {`Update for kerberos.cloud: pushing content-type.`}
    • \n
  • {`Change default configurations.`}
    • \n
\n

{`2.3.0`}

\n

{`Ecosystem`}

\n
    \n
  • {`Support for Raspberry Pi Zero W. `}{`#8`}
    • \n
\n

{`2.2.1`}

\n

{`Ecosystem`}

\n
    \n
  • {`Upgraded FFmpeg and libx264 on KiOS.`}
    • \n
\n

{`Web`}

\n
    \n
  • {`Add Bulgarian translation. `}{`#81`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Bug: IoVideo crashes due to a memory leak. `}{`#70`}
    • \n
\n

{`2.2.0`}

\n

{`Ecosystem`}

\n
    \n
  • {`Added support for Armbian.`}
    • \n
  • {`Raspbian: Async requests causes session corruption. `}{`#78`}
    • \n
\n

{`Web`}

\n
    \n
  • {`Bug: Issue format instance name. `}{`#57`}
    • \n
  • {`Redesign settings page (better UX). `}{`#39`}
    • \n
  • {`Possibility to edit password through web interface. `}{`#63`}
    • \n
  • {`Support for viewing videos.`}
    • \n
  • {`Update radius of heatmap.`}
    • \n
  • {`PHP7 support. `}{`#60`}
    • \n
  • {`Welcome/installation page. `}{`#60`}
    • \n
  • {`Translation updated. `}{`#74`}
    • \n
  • {`Privacy mode. `}{`#54`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Output as video file. `}{`#60`}
    • \n
  • {`Bug: System hangs when a wrong IP camera url was defined. `}{`#48`}
    • \n
  • {`Run arbitrary script/program. `}{`#31`}
    • \n
  • {`Bug: Weird colors from RPi Camera. `}{`#64`}
    • \n
  • {`Upgrade to OpenCV 3.2.0.`}
    • \n
\n

{`2.1.0`}

\n

{`Web`}

\n
    \n
  • {`Added PhotoSwipe for image overview (easier to browse through images). `}{`#45`}
    • \n
  • {`Added reboot and shutdown commands. `}{`#46`}
    • \n
  • {`Added logging view to system page. `}{`#33`}
    • \n
  • {`Added labels to check if machinery is running.`}
    • \n
  • {`Added error handling if web interface isn’t working properly.`}
    • \n
  • {`Fixed Heatmap.js fail to load by ad-blocker. `}{`#42`}
    • \n
  • {`Show additional information on the dashboard (streaming is opening or not) there is no data available.`}
    • \n
  • {`Settings page is now visible on mobile (+ changed icon).`}
    • \n
  • {`Fixed sorting of news articles.`}
    • \n
  • {`Removed links to assets in the cloud (.css files).`}
    • \n
  • {`Design: improved layout of login page, async loading of image view.`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Added configurable streaming port and quality. `}{`#41`}
    • \n
  • {`Added new algorithm: Background subtraction.`}
    • \n
  • {`Added new heuristic: Counter (for object/people counting). `}{`#42`}
    • \n
  • {`Added video capture, which can be used for debugging purposes (replay a video fragment).`}
    • \n
  • {`It’s now possible to mark the images with a timestamp. `}{`#36`}
    • \n
  • {`Fixed blocking streaming socket. `}{`#39`}
    • \n
\n

{`Ecosystem`}

\n
    \n
  • {`Fix removal images if disk is almost full (wrong path was defined).`}
    • \n
  • {`Support for the Raspberry Pi Camera module v2.1. `}{`#3`}
    • \n
  • {`Support for the Raspberry Pi Zero; updated kernel to latest Raspbian. `}{`#3`}
    • \n
  • {`KiOS GUI installer.`}
    • \n
\n

{`2.0.0`}

\n

{`Web`}

\n
    \n
  • {`Add simple ON/OFF toggle. `}{`#24`}
    • \n
  • {`Added update strategy when using KiOS. `}{`#23`}
    • \n
  • {`A system page which shows system information. `}{`#20`}
    • \n
  • {`Heatmap on dashboard page `}{`#19`}
    • \n
  • {`Added live stream view on the dashboard page `}{`#2`}
    • \n
  • {`Fixed bug cloud syncing `}{`#16`}
    • \n
  • {`Fixed broken settings page when space in instane name `}{`#16`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`RTSP support for IP-camera's. `}{`#21`}
    • \n
  • {`Verbose logging. `}{`#35`}
    • \n
  • {`IO-devices are executed in a seperate thread. `}{`#28`}
    • \n
  • {`Live streaming (MJPEG). `}{`#26`}
    • \n
  • {`Execute multiple instances on a machine. `}{`#24`}
    • \n
  • {`Override config by arguments. `}{`#22`}
    • \n
  • {`Move S3 upload to machinery and remove sync-s3 repository. `}{`#16`}
    • \n
\n

{`Docker`}

\n
    \n
  • {`Added Docker image (x86_x64) to Docker Hub.`}
    • \n
\n

{`Ecosystem`}

\n
    \n
  • {`Add support for Raspberry Pi 1, 2 and 3. `}{`#1`}
    • \n
\n

{`1.1.0`}

\n

{`Web`}

\n
    \n
  • {`Support IP camera's with MJPEG stream. `}{`#3`}
    • \n
  • {`Introduce new API methods to configure the machinery, using basic auth. `}{`#4`}
    • \n
  • {`Optimization of loading image and dashboard page, completely redesigned the retrieval of images. `}{`#5`}
    • \n
  • {`Optimization of settings page. `}{`#5`}
    • \n
  • {`Timebar gradient only works in Chrome. `}{`#6`}
    • \n
  • {`Minor CSS fixes for responsive layout.`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Flip/rotate option for capture devices. `}{`#5`}
    • \n
  • {`Support IP camera's with MJPEG stream. `}{`#4`}
    • \n
  • {`Introduced webhook io device. `}{`#5`}
    • \n
\n

{`Cloud`}

\n
    \n
  • {`Fixed problem when syncing a huge amount of images. `}{`#1`}
    • \n
\n

{`1.0.3`}

\n

{`Web`}

\n
    \n
  • {`Optimize performance, new datastructure has been implemented.`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Memory optimization.`}
    • \n
  • {`Removal of images older than 3 days have been removed.`}
    • \n
  • {`Start machinery automatically (delay has been removed).`}
    • \n
\n

{`Cloud`}

\n
    \n
  • {`Resolved file exist problem.`}
    • \n
\n

{`1.0.2`}

\n

{`Web`}

\n
    \n
  • {`Timezone on settings page is also used for the webinterface.`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Added extra timezones to timezone.xml.`}
    • \n
\n

{`1.0.1`}

\n

{`Web`}

\n
    \n
  • {`Improved error handling (date search).`}
    • \n
\n

{`Machinery`}

\n
    \n
  • {`Improved memory cleanup.`}
    • \n
\n

{`1.0.0`}

\n

{`First commit of Kerberos.io`}

\n
    \n
  • {`Camera support: `}{`USBCamera`}{` (V4L), `}{`Raspberry Pi camera module`}{` (MMAL).`}
    • \n
  • {`Conditions: `}{`Enabled`}{` (turn on/off Kerberos) and active `}{`Time`}{` per day.`}
    • \n
  • {`Algorithms: `}{`Differential Images`}{`.`}
    • \n
  • {`Heuristics: `}{`Sequence`}{`.`}
    • \n
  • {`Expositors: Select a `}{`Hull`}{` or `}{`Rectangle`}{`.`}
    • \n
  • {`Outputs: Write image to `}{`Disk`}{`, trigger an `}{`GPIO`}{` output pin and send a `}{`TCP/IP packet`}{`.`}
    • \n
  • {`Cloud: send your images to the `}{`Kerberos.io cloud aplication`}{`.`}
    • \n
\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-3cfb607ae4ae0b917bcd0e443c139c7a.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-3cfb607ae4ae0b917bcd0e443c139c7a.json new file mode 100644 index 0000000..bbd3cc7 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-3cfb607ae4ae0b917bcd0e443c139c7a.json @@ -0,0 +1 @@ +{"expireTime":9007200861859974000,"key":"gatsby-plugin-mdx-entire-payload-709488d6fdf89d3d1b61f8aefdba52b8-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":15,"offset":173},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":15,"offset":173},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If not already the case, start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (","position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":113,"offset":287},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"AWS","position":{"start":{"line":10,"column":115,"offset":289},"end":{"line":10,"column":118,"offset":292},"indent":[]}}],"position":{"start":{"line":10,"column":113,"offset":287},"end":{"line":10,"column":120,"offset":294},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":10,"column":120,"offset":294},"end":{"line":10,"column":122,"offset":296},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"GCP","position":{"start":{"line":10,"column":124,"offset":298},"end":{"line":10,"column":127,"offset":301},"indent":[]}}],"position":{"start":{"line":10,"column":122,"offset":296},"end":{"line":10,"column":129,"offset":303},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":10,"column":129,"offset":303},"end":{"line":10,"column":133,"offset":307},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Azure","position":{"start":{"line":10,"column":135,"offset":309},"end":{"line":10,"column":140,"offset":314},"indent":[]}}],"position":{"start":{"line":10,"column":133,"offset":307},"end":{"line":10,"column":142,"offset":316},"indent":[]}},{"type":"text","value":"), cloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.","position":{"start":{"line":10,"column":142,"offset":316},"end":{"line":10,"column":234,"offset":408},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":234,"offset":408},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":12,"column":1,"offset":410},"end":{"line":14,"column":11,"offset":612},"indent":[1,1]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":16,"column":3,"offset":616},"end":{"line":16,"column":16,"offset":629},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":614},"end":{"line":16,"column":16,"offset":629},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is the storage component for Kerberos Enterprise. It is used to store your recordings at a central place, in the storage system you prefer. Next to that it can be used for extension and integration capabilities. Learn more about ","position":{"start":{"line":18,"column":1,"offset":631},"end":{"line":18,"column":247,"offset":877},"indent":[]}},{"type":"link","title":null,"url":"/storage","children":[{"type":"text","value":"Kerberos Storage here","position":{"start":{"line":18,"column":248,"offset":878},"end":{"line":18,"column":269,"offset":899},"indent":[]}}],"position":{"start":{"line":18,"column":247,"offset":877},"end":{"line":18,"column":280,"offset":910},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":18,"column":280,"offset":910},"end":{"line":18,"column":281,"offset":911},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":631},"end":{"line":18,"column":281,"offset":911},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To use Kerberos Storage, you will need to have Kerberos Enterprise installed, and deployments running. Independent from that one can also use the Kerberos Storage API ","position":{"start":{"line":20,"column":1,"offset":913},"end":{"line":20,"column":168,"offset":1080},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":20,"column":168,"offset":1080},"end":{"line":20,"column":189,"offset":1101},"indent":[]}},{"type":"text","value":" to send recordings from a custom build VMS.","position":{"start":{"line":20,"column":189,"offset":1101},"end":{"line":20,"column":233,"offset":1145},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":913},"end":{"line":20,"column":233,"offset":1145},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":22,"column":3,"offset":1149},"end":{"line":22,"column":15,"offset":1161},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1147},"end":{"line":22,"column":15,"offset":1161},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to Kerberos Enterprise, Kerberos Storage, requires some initial components to be installed. If you will run Kerberos Storage in the same cluster as where you have Kerberos Enterprise running, there is not much to do.","position":{"start":{"line":24,"column":1,"offset":1163},"end":{"line":24,"column":225,"offset":1387},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1163},"end":{"line":24,"column":225,"offset":1387},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":26,"column":1,"offset":1389},"end":{"line":26,"column":99,"offset":1487},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1389},"end":{"line":26,"column":99,"offset":1487},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"However if you plan to run Kerberos Storage in a different cluster (which is perfectly possible), you will need to make sure you complete the initial setup of ","position":{"start":{"line":28,"column":1,"offset":1489},"end":{"line":28,"column":160,"offset":1648},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/installation","children":[{"type":"text","value":"Kerberos Enterprise installation","position":{"start":{"line":28,"column":161,"offset":1649},"end":{"line":28,"column":193,"offset":1681},"indent":[]}}],"position":{"start":{"line":28,"column":160,"offset":1648},"end":{"line":28,"column":220,"offset":1708},"indent":[]}},{"type":"text","value":". To be more specific you will need the following components running:","position":{"start":{"line":28,"column":220,"offset":1708},"end":{"line":28,"column":289,"offset":1777},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1489},"end":{"line":28,"column":289,"offset":1777},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Helm","position":{"start":{"line":30,"column":3,"offset":1781},"end":{"line":30,"column":7,"offset":1785},"indent":[]}}],"position":{"start":{"line":30,"column":3,"offset":1781},"end":{"line":30,"column":7,"offset":1785},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1779},"end":{"line":30,"column":7,"offset":1785},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":31,"column":3,"offset":1788},"end":{"line":31,"column":10,"offset":1795},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1788},"end":{"line":31,"column":10,"offset":1795},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1786},"end":{"line":31,"column":10,"offset":1795},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":32,"column":3,"offset":1798},"end":{"line":32,"column":10,"offset":1805},"indent":[]}}],"position":{"start":{"line":32,"column":3,"offset":1798},"end":{"line":32,"column":10,"offset":1805},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1796},"end":{"line":32,"column":10,"offset":1805},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1779},"end":{"line":32,"column":10,"offset":1805},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once this is done start by cloning the configurations from our ","position":{"start":{"line":34,"column":1,"offset":1807},"end":{"line":34,"column":64,"offset":1870},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/storage","children":[{"type":"text","value":"Github repo","position":{"start":{"line":34,"column":65,"offset":1871},"end":{"line":34,"column":76,"offset":1882},"indent":[]}}],"position":{"start":{"line":34,"column":64,"offset":1870},"end":{"line":34,"column":117,"offset":1923},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":34,"column":117,"offset":1923},"end":{"line":34,"column":118,"offset":1924},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":1807},"end":{"line":34,"column":118,"offset":1924},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/storage","position":{"start":{"line":36,"column":1,"offset":1926},"end":{"line":36,"column":53,"offset":1978},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage","position":{"start":{"line":38,"column":4,"offset":1983},"end":{"line":38,"column":11,"offset":1990},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1980},"end":{"line":38,"column":11,"offset":1990},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to Kerberos Enterprise, Kerberos Storage is managed through a web app. It allows you to add storage providers (S3, minio, etc), add queues for messaging, accounts for security and much more. It also comes with API's, which you can use to interact and retrieve information from Kerberos Storage. All is documented in the form of Swagger APIs ","position":{"start":{"line":40,"column":1,"offset":1992},"end":{"line":40,"column":350,"offset":2341},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":40,"column":350,"offset":2341},"end":{"line":40,"column":371,"offset":2362},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":40,"column":371,"offset":2362},"end":{"line":40,"column":372,"offset":2363},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1992},"end":{"line":40,"column":372,"offset":2363},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing Kerberos Storage, open the ","position":{"start":{"line":42,"column":1,"offset":2365},"end":{"line":42,"column":46,"offset":2410},"indent":[]}},{"type":"inlineCode","value":"./storage/yaml/deployment.yaml","position":{"start":{"line":42,"column":46,"offset":2410},"end":{"line":42,"column":78,"offset":2442},"indent":[]}},{"type":"text","value":" configuration file. At the bottom file you will find two endpoints, similar to the Traefik config file below. Update the domain names to your own domain, and add these to your DNS server or ","position":{"start":{"line":42,"column":78,"offset":2442},"end":{"line":42,"column":269,"offset":2633},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":42,"column":269,"offset":2633},"end":{"line":42,"column":281,"offset":2645},"indent":[]}},{"type":"text","value":" file (and point to the same IP as the Traefik EXTERNAL-IP).","position":{"start":{"line":42,"column":281,"offset":2645},"end":{"line":42,"column":341,"offset":2705},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2365},"end":{"line":42,"column":341,"offset":2705},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: storage.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: kerberos-storage\n servicePort: 80\n--> - host: api.storage.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: kerberos-storage\n servicePort: 8081","position":{"start":{"line":44,"column":1,"offset":2707},"end":{"line":59,"column":36,"offset":3157},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Ingress Nginx, do not forgot to comment ","position":{"start":{"line":61,"column":1,"offset":3159},"end":{"line":61,"column":58,"offset":3216},"indent":[]}},{"type":"inlineCode","value":"Traefik","position":{"start":{"line":61,"column":58,"offset":3216},"end":{"line":61,"column":67,"offset":3225},"indent":[]}},{"type":"text","value":" and uncomment ","position":{"start":{"line":61,"column":67,"offset":3225},"end":{"line":61,"column":82,"offset":3240},"indent":[]}},{"type":"inlineCode","value":"Ingress Nginx","position":{"start":{"line":61,"column":82,"offset":3240},"end":{"line":61,"column":97,"offset":3255},"indent":[]}},{"type":"text","value":". Also note the extra argument ","position":{"start":{"line":61,"column":97,"offset":3255},"end":{"line":61,"column":128,"offset":3286},"indent":[]}},{"type":"inlineCode","value":"proxy-body-size","position":{"start":{"line":61,"column":128,"offset":3286},"end":{"line":61,"column":145,"offset":3303},"indent":[]}},{"type":"text","value":", this is required for not reaching the default 1MB body size limit. If you do not enable this, you might experience ","position":{"start":{"line":61,"column":145,"offset":3303},"end":{"line":61,"column":262,"offset":3420},"indent":[]}},{"type":"inlineCode","value":"413","position":{"start":{"line":61,"column":262,"offset":3420},"end":{"line":61,"column":267,"offset":3425},"indent":[]}},{"type":"text","value":" errors in your Kerberos Enterprise agents.","position":{"start":{"line":61,"column":267,"offset":3425},"end":{"line":61,"column":310,"offset":3468},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3159},"end":{"line":61,"column":310,"offset":3468},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"apiVersion: extensions/v1beta1\nkind: Ingress\nmetadata:\n name: kerberos-storage\n annotations:\n #kubernetes.io/ingress.class: traefik\n kubernetes.io/ingress.class: nginx\n nginx.ingress.kubernetes.io/proxy-body-size: 200m","position":{"start":{"line":63,"column":1,"offset":3470},"end":{"line":70,"column":58,"offset":3731},"indent":[1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":72,"column":1,"offset":3733},"end":{"line":72,"column":112,"offset":3844},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3733},"end":{"line":72,"column":112,"offset":3844},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":74,"column":1,"offset":3846},"end":{"line":77,"column":30,"offset":3965},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names and MongoDB credentials, install Kerberos Storage inside your cluster.","position":{"start":{"line":79,"column":1,"offset":3967},"end":{"line":79,"column":109,"offset":4075},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3967},"end":{"line":79,"column":109,"offset":4075},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./storage/yaml/deployment.yaml","position":{"start":{"line":81,"column":1,"offset":4077},"end":{"line":81,"column":52,"offset":4128},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":83,"column":4,"offset":4133},"end":{"line":83,"column":26,"offset":4155},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":4130},"end":{"line":83,"column":26,"offset":4155},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":85,"column":1,"offset":4157},"end":{"line":85,"column":94,"offset":4250},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":4157},"end":{"line":85,"column":94,"offset":4250},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":87,"column":5,"offset":4256},"end":{"line":87,"column":12,"offset":4263},"indent":[]}}],"position":{"start":{"line":87,"column":5,"offset":4256},"end":{"line":87,"column":12,"offset":4263},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4252},"end":{"line":87,"column":12,"offset":4263},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":88,"column":5,"offset":4268},"end":{"line":88,"column":12,"offset":4275},"indent":[]}}],"position":{"start":{"line":88,"column":5,"offset":4268},"end":{"line":88,"column":12,"offset":4275},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":4264},"end":{"line":88,"column":12,"offset":4275},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Storage","position":{"start":{"line":89,"column":5,"offset":4280},"end":{"line":89,"column":12,"offset":4287},"indent":[]}}],"position":{"start":{"line":89,"column":5,"offset":4280},"end":{"line":89,"column":12,"offset":4287},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4276},"end":{"line":89,"column":12,"offset":4287},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Enterprise (optional)","position":{"start":{"line":90,"column":5,"offset":4292},"end":{"line":90,"column":26,"offset":4313},"indent":[]}}],"position":{"start":{"line":90,"column":5,"offset":4292},"end":{"line":90,"column":26,"offset":4313},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4288},"end":{"line":90,"column":26,"offset":4313},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4252},"end":{"line":90,"column":26,"offset":4313},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":92,"column":1,"offset":4315},"end":{"line":92,"column":26,"offset":4340},"indent":[]}}],"position":{"start":{"line":92,"column":1,"offset":4315},"end":{"line":92,"column":26,"offset":4340},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nkerberos-storage-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-55566dc65c-xgmns 2/2 Running 0 4d13h\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":94,"column":1,"offset":4342},"end":{"line":98,"column":73,"offset":4654},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":100,"column":4,"offset":4659},"end":{"line":100,"column":21,"offset":4676},"indent":[]}}],"position":{"start":{"line":100,"column":1,"offset":4656},"end":{"line":100,"column":21,"offset":4676},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS or ","position":{"start":{"line":102,"column":1,"offset":4678},"end":{"line":102,"column":65,"offset":4742},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":102,"column":65,"offset":4742},"end":{"line":102,"column":77,"offset":4754},"indent":[]}},{"type":"text","value":" file, you should be able to access the Storage application. By navigating to the Storage domain ","position":{"start":{"line":102,"column":77,"offset":4754},"end":{"line":102,"column":174,"offset":4851},"indent":[]}},{"type":"inlineCode","value":"storage.domain.com","position":{"start":{"line":102,"column":174,"offset":4851},"end":{"line":102,"column":194,"offset":4871},"indent":[]}},{"type":"text","value":" in your browser you will see the Storage login page showing up.","position":{"start":{"line":102,"column":194,"offset":4871},"end":{"line":102,"column":258,"offset":4935},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":4678},"end":{"line":102,"column":258,"offset":4935},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Storage","position":{"start":{"line":104,"column":1,"offset":4937},"end":{"line":104,"column":71,"offset":5007},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":4937},"end":{"line":104,"column":71,"offset":5007},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":107,"column":1,"offset":5010},"end":{"line":107,"column":31,"offset":5040},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":107,"column":31,"offset":5040}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Introduction`}

\n

{`If not already the case, start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (`}{`AWS`}{`, `}{`GCP`}{` or `}{`Azure`}{`), cloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.`}

\n
\n
\n

\n

{`Prerequisites`}

\n

{`Kerberos Storage is the storage component for Kerberos Enterprise. It is used to store your recordings at a central place, in the storage system you prefer. Next to that it can be used for extension and integration capabilities. Learn more about `}{`Kerberos Storage here`}{`.`}

\n

{`To use Kerberos Storage, you will need to have Kerberos Enterprise installed, and deployments running. Independent from that one can also use the Kerberos Storage API `}{`/swagger/index.html`}{` to send recordings from a custom build VMS.`}

\n

{`Installation`}

\n

{`Similar to Kerberos Enterprise, Kerberos Storage, requires some initial components to be installed. If you will run Kerberos Storage in the same cluster as where you have Kerberos Enterprise running, there is not much to do.`}

\n

\"architecture

\n

{`However if you plan to run Kerberos Storage in a different cluster (which is perfectly possible), you will need to make sure you complete the initial setup of `}{`Kerberos Enterprise installation`}{`. To be more specific you will need the following components running:`}

\n
    \n
  • {`Helm`}
    • \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
\n

{`Once this is done start by cloning the configurations from our `}{`Github repo`}{`.`}

\n 
{`git clone https://github.com/kerberos-io/storage`}
\n

{`Storage`}

\n

{`Similar to Kerberos Enterprise, Kerberos Storage is managed through a web app. It allows you to add storage providers (S3, minio, etc), add queues for messaging, accounts for security and much more. It also comes with API's, which you can use to interact and retrieve information from Kerberos Storage. All is documented in the form of Swagger APIs `}{`/swagger/index.html`}{`.`}

\n

{`Before installing Kerberos Storage, open the `}{`./storage/yaml/deployment.yaml`}{` configuration file. At the bottom file you will find two endpoints, similar to the Traefik config file below. Update the domain names to your own domain, and add these to your DNS server or `}{`/etc/hosts`}{` file (and point to the same IP as the Traefik EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: storage.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: kerberos-storage`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.storage.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: kerberos-storage`}{`\n`}{`              servicePort: 8081`}
\n

{`If you are using Ingress Nginx, do not forgot to comment `}{`Traefik`}{` and uncomment `}{`Ingress Nginx`}{`. Also note the extra argument `}{`proxy-body-size`}{`, this is required for not reaching the default 1MB body size limit. If you do not enable this, you might experience `}{`413`}{` errors in your Kerberos Enterprise agents.`}

\n 
{`apiVersion: extensions/v1beta1`}{`\n`}{`kind: Ingress`}{`\n`}{`metadata:`}{`\n`}{`  name: kerberos-storage`}{`\n`}{`  annotations:`}{`\n`}{`    #kubernetes.io/ingress.class: traefik`}{`\n`}{`    kubernetes.io/ingress.class: nginx`}{`\n`}{`    nginx.ingress.kubernetes.io/proxy-body-size: 200m`}
\n

{`Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names and MongoDB credentials, install Kerberos Storage inside your cluster.`}

\n 
{`kubectl apply -f ./storage/yaml/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Storage`}
    • \n
  • {`Enterprise (optional)`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`kerberos-storage-6f5c877d7c-hf77p 1/1     Running   0          2d11h`}{`\n`}{`mongodb-55566dc65c-xgmns          2/2     Running   0          4d13h`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS or `}{`/etc/hosts`}{` file, you should be able to access the Storage application. By navigating to the Storage domain `}{`storage.domain.com`}{` in your browser you will see the Storage login page showing up.`}

\n

\"Storage\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-41b6430427724df362773062eaa3c737.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-41b6430427724df362773062eaa3c737.json index bc62b07..d93f75f 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-41b6430427724df362773062eaa3c737.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-41b6430427724df362773062eaa3c737.json @@ -1 +1 @@ -{"expireTime":9007200861747672000,"key":"gatsby-plugin-mdx-entire-payload-23c8e084ec64b35bbb5e8cafb67072d2-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Get Started","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":14,"offset":172},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":14,"offset":172},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed Kerberos Storage, you will have the Storage web application. This web application allows you to administrate Kerberos Storage. You can add storage providers, queues, accounts, and more.","position":{"start":{"line":10,"column":1,"offset":174},"end":{"line":10,"column":208,"offset":381},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":174},"end":{"line":10,"column":208,"offset":381},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Login page","position":{"start":{"line":12,"column":4,"offset":386},"end":{"line":12,"column":14,"offset":396},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":383},"end":{"line":12,"column":14,"offset":396},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you open a browser, and navigate to the Storage web application (see installation for the url), you will land on the login page.","position":{"start":{"line":14,"column":1,"offset":398},"end":{"line":14,"column":134,"offset":531},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":398},"end":{"line":14,"column":134,"offset":531},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage-small.png","alt":"Storage","position":{"start":{"line":16,"column":1,"offset":533},"end":{"line":16,"column":77,"offset":609},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":533},"end":{"line":16,"column":77,"offset":609},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The default username password of the Storage applications is:","position":{"start":{"line":18,"column":1,"offset":611},"end":{"line":18,"column":62,"offset":672},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":611},"end":{"line":18,"column":62,"offset":672},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"username: ","position":{"start":{"line":20,"column":3,"offset":676},"end":{"line":20,"column":13,"offset":686},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":20,"column":15,"offset":688},"end":{"line":20,"column":19,"offset":692},"indent":[]}}],"position":{"start":{"line":20,"column":13,"offset":686},"end":{"line":20,"column":21,"offset":694},"indent":[]}}],"position":{"start":{"line":20,"column":3,"offset":676},"end":{"line":20,"column":21,"offset":694},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":674},"end":{"line":20,"column":21,"offset":694},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"password: ","position":{"start":{"line":21,"column":3,"offset":697},"end":{"line":21,"column":13,"offset":707},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"kerberos","position":{"start":{"line":21,"column":15,"offset":709},"end":{"line":21,"column":23,"offset":717},"indent":[]}}],"position":{"start":{"line":21,"column":13,"offset":707},"end":{"line":21,"column":25,"offset":719},"indent":[]}}],"position":{"start":{"line":21,"column":3,"offset":697},"end":{"line":21,"column":25,"offset":719},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":695},"end":{"line":21,"column":25,"offset":719},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":674},"end":{"line":21,"column":25,"offset":719},"indent":[1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"The username and password can be changed in the ","position":{"start":{"line":23,"column":3,"offset":723},"end":{"line":23,"column":51,"offset":771},"indent":[]}},{"type":"inlineCode","value":"deployment.yaml","position":{"start":{"line":23,"column":51,"offset":771},"end":{"line":23,"column":68,"offset":788},"indent":[]}},{"type":"text","value":" file.","position":{"start":{"line":23,"column":68,"offset":788},"end":{"line":23,"column":74,"offset":794},"indent":[]}}],"position":{"start":{"line":23,"column":3,"offset":723},"end":{"line":23,"column":74,"offset":794},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":721},"end":{"line":23,"column":74,"offset":794},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"License key","position":{"start":{"line":25,"column":4,"offset":799},"end":{"line":25,"column":15,"offset":810},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":796},"end":{"line":25,"column":15,"offset":810},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The first time you login you are asked for a license key, this can be obtained by sending a request to cedric@verstraeten.io. An example license key looks like this:","position":{"start":{"line":27,"column":1,"offset":812},"end":{"line":27,"column":166,"offset":977},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":812},"end":{"line":27,"column":166,"offset":977},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"-----BEGIN LICENSE KEY-----\nL/+DAwEBB2xpY2Vuc2UB/4QAAQIBB1BheWxvYWQBCgABCVNpZ25hdHVyZQEKAAAA\n/9z/hAFUPBAADG1haW4uTGljZW5zZf+BAwEBB0xpY2Vuc2UB/4IAAQIBB0NvbXBh\nbnkBDAABB0V4cFRpbWUBBAAAABb/ghMBCmtlcmJlcm9zaW8B/MC7ZzIAAf+AOaJ+\n8eU3OlZCphr4uJyH/PzfuDkMrqyfIsutc5kSz3rjsRtU4e6vETpHre8CPvFyx5w2\n0O8PKCIR4z1q28qJK2cvHQTK0/zf+KfYLilEcmNczLXgg+bnPvtA/bU/K8ZEwbnw\nRta3+8zId+xtYQApdmHwo/Ih/vCN579iDeunwVQA\n-----END LICENSE KEY-----","position":{"start":{"line":29,"column":3,"offset":981},"end":{"line":36,"column":26,"offset":1400},"indent":[1,1,1,1,1,1,1]}}],"position":{"start":{"line":29,"column":3,"offset":981},"end":{"line":36,"column":26,"offset":1400},"indent":[1,1,1,1,1,1,1]}}],"position":{"start":{"line":29,"column":1,"offset":979},"end":{"line":36,"column":26,"offset":1400},"indent":[1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-licensekey.png","alt":"Factory","position":{"start":{"line":38,"column":1,"offset":1402},"end":{"line":38,"column":72,"offset":1473},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1402},"end":{"line":38,"column":72,"offset":1473},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you received a license key, and entered it into the web app you will be redirected to the login screen. Enter your credentials again, and you will be guided into the dashboard.","position":{"start":{"line":40,"column":1,"offset":1475},"end":{"line":40,"column":182,"offset":1656},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1475},"end":{"line":40,"column":182,"offset":1656},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Providers","position":{"start":{"line":43,"column":4,"offset":1662},"end":{"line":43,"column":13,"offset":1671},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":1659},"end":{"line":43,"column":13,"offset":1671},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you signed in succesfully, you land on the providers page. Here is the place where you can add your datasources. You can choose from:","position":{"start":{"line":45,"column":1,"offset":1673},"end":{"line":45,"column":139,"offset":1811},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":1673},"end":{"line":45,"column":139,"offset":1811},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":47,"column":6,"offset":1818},"end":{"line":47,"column":35,"offset":1847},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":1817},"end":{"line":47,"column":70,"offset":1882},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":1817},"end":{"line":47,"column":70,"offset":1882},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":1813},"end":{"line":47,"column":70,"offset":1882},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":48,"column":6,"offset":1888},"end":{"line":48,"column":29,"offset":1911},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":1887},"end":{"line":48,"column":83,"offset":1965},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":1887},"end":{"line":48,"column":83,"offset":1965},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":1883},"end":{"line":48,"column":83,"offset":1965},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":49,"column":6,"offset":1971},"end":{"line":49,"column":28,"offset":1993},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":1970},"end":{"line":49,"column":57,"offset":2022},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":1970},"end":{"line":49,"column":57,"offset":2022},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":1966},"end":{"line":49,"column":57,"offset":2022},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":50,"column":6,"offset":2028},"end":{"line":50,"column":11,"offset":2033},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":2027},"end":{"line":50,"column":29,"offset":2051},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":2027},"end":{"line":50,"column":29,"offset":2051},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2023},"end":{"line":50,"column":29,"offset":2051},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":1813},"end":{"line":50,"column":29,"offset":2051},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"For each provider, the appropriate security settings has to be filled in. For example for AWS you need to define the access and secret key, for GCP you need to define the Service Account.","position":{"start":{"line":52,"column":1,"offset":2053},"end":{"line":52,"column":188,"offset":2240},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":2053},"end":{"line":52,"column":188,"offset":2240},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Additionaly a provider can be marked as temporary. This is helpful if you wish to store your recordings for a short period, and want to use it for processing purpose only. A benefit of doing this is reducing costs (if you host in the public cloud).","position":{"start":{"line":54,"column":1,"offset":2242},"end":{"line":54,"column":249,"offset":2490},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":2242},"end":{"line":54,"column":249,"offset":2490},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-providers.png","alt":"Storage","position":{"start":{"line":56,"column":1,"offset":2492},"end":{"line":56,"column":63,"offset":2554},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":2492},"end":{"line":56,"column":63,"offset":2554},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Queues","position":{"start":{"line":58,"column":4,"offset":2559},"end":{"line":58,"column":10,"offset":2565},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":2556},"end":{"line":58,"column":10,"offset":2565},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Events or messages are generated each time a recording was uploaded to Kerberos Storage. These messages can be send to one ore moore message brokers such as Apache Kafka or AWS SQS. From the interface you can setup the connection, and once configured events will flow to your predefined message brokers.","position":{"start":{"line":60,"column":1,"offset":2567},"end":{"line":60,"column":304,"offset":2870},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":2567},"end":{"line":60,"column":304,"offset":2870},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"An example or usecase what you do with Queue's is building something like our Kerberos Cloud offering. Each time a Kerberos Cloud customer is sending recordings to his/her cloud profile, it is stored through Kerberos Storage into one of our public data centers. Next to that a message is send into our private Kafka broker, which is starting a chain of processing:","position":{"start":{"line":62,"column":1,"offset":2872},"end":{"line":62,"column":365,"offset":3236},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":2872},"end":{"line":62,"column":365,"offset":3236},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Metadata storage in MongoDB,","position":{"start":{"line":64,"column":5,"offset":3242},"end":{"line":64,"column":33,"offset":3270},"indent":[]}}],"position":{"start":{"line":64,"column":5,"offset":3242},"end":{"line":64,"column":33,"offset":3270},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":3238},"end":{"line":64,"column":33,"offset":3270},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Notifications,","position":{"start":{"line":65,"column":5,"offset":3275},"end":{"line":65,"column":19,"offset":3289},"indent":[]}}],"position":{"start":{"line":65,"column":5,"offset":3275},"end":{"line":65,"column":19,"offset":3289},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":3271},"end":{"line":65,"column":19,"offset":3289},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Classification with Tensorflow,","position":{"start":{"line":66,"column":5,"offset":3294},"end":{"line":66,"column":36,"offset":3325},"indent":[]}}],"position":{"start":{"line":66,"column":5,"offset":3294},"end":{"line":66,"column":36,"offset":3325},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":3290},"end":{"line":66,"column":36,"offset":3325},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Counting algorithms,","position":{"start":{"line":67,"column":5,"offset":3330},"end":{"line":67,"column":25,"offset":3350},"indent":[]}}],"position":{"start":{"line":67,"column":5,"offset":3330},"end":{"line":67,"column":25,"offset":3350},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3326},"end":{"line":67,"column":25,"offset":3350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"and much more.","position":{"start":{"line":68,"column":5,"offset":3355},"end":{"line":68,"column":19,"offset":3369},"indent":[]}}],"position":{"start":{"line":68,"column":5,"offset":3355},"end":{"line":68,"column":19,"offset":3369},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":3351},"end":{"line":68,"column":19,"offset":3369},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":3238},"end":{"line":68,"column":19,"offset":3369},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-queues.png","alt":"Storage","position":{"start":{"line":70,"column":1,"offset":3371},"end":{"line":70,"column":60,"offset":3430},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":3371},"end":{"line":70,"column":60,"offset":3430},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Accounts","position":{"start":{"line":72,"column":4,"offset":3435},"end":{"line":72,"column":12,"offset":3443},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3432},"end":{"line":72,"column":12,"offset":3443},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Accounts is the access for end users or customers. In the account section we define configurations such as:","position":{"start":{"line":74,"column":1,"offset":3445},"end":{"line":74,"column":108,"offset":3552},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":3445},"end":{"line":74,"column":108,"offset":3552},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Allowed providers,","position":{"start":{"line":75,"column":5,"offset":3557},"end":{"line":75,"column":23,"offset":3575},"indent":[]}}],"position":{"start":{"line":75,"column":5,"offset":3557},"end":{"line":75,"column":23,"offset":3575},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3553},"end":{"line":75,"column":23,"offset":3575},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Public Key,","position":{"start":{"line":76,"column":5,"offset":3580},"end":{"line":76,"column":16,"offset":3591},"indent":[]}}],"position":{"start":{"line":76,"column":5,"offset":3580},"end":{"line":76,"column":16,"offset":3591},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":3576},"end":{"line":76,"column":16,"offset":3591},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secret Key,","position":{"start":{"line":77,"column":5,"offset":3596},"end":{"line":77,"column":16,"offset":3607},"indent":[]}}],"position":{"start":{"line":77,"column":5,"offset":3596},"end":{"line":77,"column":16,"offset":3607},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3592},"end":{"line":77,"column":16,"offset":3607},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Day limit","position":{"start":{"line":78,"column":5,"offset":3612},"end":{"line":78,"column":14,"offset":3621},"indent":[]}}],"position":{"start":{"line":78,"column":5,"offset":3612},"end":{"line":78,"column":14,"offset":3621},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":3608},"end":{"line":78,"column":14,"offset":3621},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3553},"end":{"line":78,"column":14,"offset":3621},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"An account can be generated for each individual, or a asteriks account (*) can be generated; which is more suitable if you want to seperate devices or regions of devices.\nOnce an account is created it can be used in Kerberos Enterprise (and soon Kerberos Open Source) to persist your data from your Kerberos Agent into your own datacenter, public or private cloud.","position":{"start":{"line":80,"column":1,"offset":3623},"end":{"line":81,"column":194,"offset":3987},"indent":[1]}}],"position":{"start":{"line":80,"column":1,"offset":3623},"end":{"line":81,"column":194,"offset":3987},"indent":[1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-accounts.png","alt":"Storage","position":{"start":{"line":83,"column":1,"offset":3989},"end":{"line":83,"column":62,"offset":4050},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":3989},"end":{"line":83,"column":62,"offset":4050},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Media","position":{"start":{"line":85,"column":4,"offset":4055},"end":{"line":85,"column":9,"offset":4060},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":4052},"end":{"line":85,"column":9,"offset":4060},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"All recordings send through Kerberos Storage are stored, both for auditing as for cleanup policies.","position":{"start":{"line":87,"column":1,"offset":4062},"end":{"line":87,"column":100,"offset":4161},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4062},"end":{"line":87,"column":100,"offset":4161},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-media.png","alt":"Storage","position":{"start":{"line":89,"column":1,"offset":4163},"end":{"line":89,"column":59,"offset":4221},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4163},"end":{"line":89,"column":59,"offset":4221},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cleanup","position":{"start":{"line":91,"column":4,"offset":4226},"end":{"line":91,"column":11,"offset":4233},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4223},"end":{"line":91,"column":11,"offset":4233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Storage might need to be erased after a while because of several reasons:","position":{"start":{"line":93,"column":1,"offset":4235},"end":{"line":93,"column":74,"offset":4308},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4235},"end":{"line":93,"column":74,"offset":4308},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"maybe the data is no longer relevant","position":{"start":{"line":95,"column":3,"offset":4312},"end":{"line":95,"column":39,"offset":4348},"indent":[]}}],"position":{"start":{"line":95,"column":3,"offset":4312},"end":{"line":95,"column":39,"offset":4348},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4310},"end":{"line":95,"column":39,"offset":4348},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"due to security reasions","position":{"start":{"line":96,"column":3,"offset":4351},"end":{"line":96,"column":27,"offset":4375},"indent":[]}}],"position":{"start":{"line":96,"column":3,"offset":4351},"end":{"line":96,"column":27,"offset":4375},"indent":[]}}],"position":{"start":{"line":96,"column":1,"offset":4349},"end":{"line":96,"column":27,"offset":4375},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"etc.","position":{"start":{"line":97,"column":3,"offset":4378},"end":{"line":97,"column":7,"offset":4382},"indent":[]}}],"position":{"start":{"line":97,"column":3,"offset":4378},"end":{"line":97,"column":7,"offset":4382},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4376},"end":{"line":97,"column":7,"offset":4382},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4310},"end":{"line":97,"column":7,"offset":4382},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"To make this possible Kerberos Storage comes with a configurable cleanup script, which you can run inside your Kuberneters cluster next to your Kerberos Storage deployment.","position":{"start":{"line":99,"column":1,"offset":4384},"end":{"line":99,"column":173,"offset":4556},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4384},"end":{"line":99,"column":173,"offset":4556},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":102,"column":1,"offset":4559},"end":{"line":102,"column":31,"offset":4589},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":102,"column":31,"offset":4589}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Get Started`}

\n

{`Once you've installed Kerberos Storage, you will have the Storage web application. This web application allows you to administrate Kerberos Storage. You can add storage providers, queues, accounts, and more.`}

\n

{`Login page`}

\n

{`Once you open a browser, and navigate to the Storage web application (see installation for the url), you will land on the login page.`}

\n

\"Storage\"

\n

{`The default username password of the Storage applications is:`}

\n
    \n
  • {`username: `}{`root`}
    • \n
  • {`password: `}{`kerberos`}
    • \n
\n
\n

{`The username and password can be changed in the `}{`deployment.yaml`}{` file.`}

\n
\n

{`License key`}

\n

{`The first time you login you are asked for a license key, this can be obtained by sending a request to cedric@verstraeten.io. An example license key looks like this:`}

\n
\n

{`-----BEGIN LICENSE KEY-----\nL/+DAwEBB2xpY2Vuc2UB/4QAAQIBB1BheWxvYWQBCgABCVNpZ25hdHVyZQEKAAAA\n/9z/hAFUPBAADG1haW4uTGljZW5zZf+BAwEBB0xpY2Vuc2UB/4IAAQIBB0NvbXBh\nbnkBDAABB0V4cFRpbWUBBAAAABb/ghMBCmtlcmJlcm9zaW8B/MC7ZzIAAf+AOaJ+\n8eU3OlZCphr4uJyH/PzfuDkMrqyfIsutc5kSz3rjsRtU4e6vETpHre8CPvFyx5w2\n0O8PKCIR4z1q28qJK2cvHQTK0/zf+KfYLilEcmNczLXgg+bnPvtA/bU/K8ZEwbnw\nRta3+8zId+xtYQApdmHwo/Ih/vCN579iDeunwVQA\n-----END LICENSE KEY-----`}

\n
\n

\"Factory\"

\n

{`Once you received a license key, and entered it into the web app you will be redirected to the login screen. Enter your credentials again, and you will be guided into the dashboard.`}

\n

{`Providers`}

\n

{`Once you signed in succesfully, you land on the providers page. Here is the place where you can add your datasources. You can choose from:`}

\n \n

{`For each provider, the appropriate security settings has to be filled in. For example for AWS you need to define the access and secret key, for GCP you need to define the Service Account.`}

\n

{`Additionaly a provider can be marked as temporary. This is helpful if you wish to store your recordings for a short period, and want to use it for processing purpose only. A benefit of doing this is reducing costs (if you host in the public cloud).`}

\n

\"Storage\"

\n

{`Queues`}

\n

{`Events or messages are generated each time a recording was uploaded to Kerberos Storage. These messages can be send to one ore moore message brokers such as Apache Kafka or AWS SQS. From the interface you can setup the connection, and once configured events will flow to your predefined message brokers.`}

\n

{`An example or usecase what you do with Queue's is building something like our Kerberos Cloud offering. Each time a Kerberos Cloud customer is sending recordings to his/her cloud profile, it is stored through Kerberos Storage into one of our public data centers. Next to that a message is send into our private Kafka broker, which is starting a chain of processing:`}

\n
    \n
  • {`Metadata storage in MongoDB,`}
    • \n
  • {`Notifications,`}
    • \n
  • {`Classification with Tensorflow,`}
    • \n
  • {`Counting algorithms,`}
    • \n
  • {`and much more.`}
    • \n
\n

\"Storage\"

\n

{`Accounts`}

\n

{`Accounts is the access for end users or customers. In the account section we define configurations such as:`}

\n
    \n
  • {`Allowed providers,`}
    • \n
  • {`Public Key,`}
    • \n
  • {`Secret Key,`}
    • \n
  • {`Day limit`}
    • \n
\n

{`An account can be generated for each individual, or a asteriks account (*) can be generated; which is more suitable if you want to seperate devices or regions of devices.\nOnce an account is created it can be used in Kerberos Enterprise (and soon Kerberos Open Source) to persist your data from your Kerberos Agent into your own datacenter, public or private cloud.`}

\n

\"Storage\"

\n

{`Media`}

\n

{`All recordings send through Kerberos Storage are stored, both for auditing as for cleanup policies.`}

\n

\"Storage\"

\n

{`Cleanup`}

\n

{`Storage might need to be erased after a while because of several reasons:`}

\n
    \n
  • {`maybe the data is no longer relevant`}
    • \n
  • {`due to security reasions`}
    • \n
  • {`etc.`}
    • \n
\n

{`To make this possible Kerberos Storage comes with a configurable cleanup script, which you can run inside your Kuberneters cluster next to your Kerberos Storage deployment.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750177000,"key":"gatsby-plugin-mdx-entire-payload-23c8e084ec64b35bbb5e8cafb67072d2-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Get Started","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":14,"offset":172},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":14,"offset":172},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed Kerberos Storage, you will have the Storage web application. This web application allows you to administrate Kerberos Storage. You can add storage providers, queues, accounts, and more.","position":{"start":{"line":10,"column":1,"offset":174},"end":{"line":10,"column":208,"offset":381},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":174},"end":{"line":10,"column":208,"offset":381},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Login page","position":{"start":{"line":12,"column":4,"offset":386},"end":{"line":12,"column":14,"offset":396},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":383},"end":{"line":12,"column":14,"offset":396},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you open a browser, and navigate to the Storage web application (see installation for the url), you will land on the login page.","position":{"start":{"line":14,"column":1,"offset":398},"end":{"line":14,"column":134,"offset":531},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":398},"end":{"line":14,"column":134,"offset":531},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage-small.png","alt":"Storage","position":{"start":{"line":16,"column":1,"offset":533},"end":{"line":16,"column":77,"offset":609},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":533},"end":{"line":16,"column":77,"offset":609},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The default username password of the Storage applications is:","position":{"start":{"line":18,"column":1,"offset":611},"end":{"line":18,"column":62,"offset":672},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":611},"end":{"line":18,"column":62,"offset":672},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"username: ","position":{"start":{"line":20,"column":3,"offset":676},"end":{"line":20,"column":13,"offset":686},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":20,"column":15,"offset":688},"end":{"line":20,"column":19,"offset":692},"indent":[]}}],"position":{"start":{"line":20,"column":13,"offset":686},"end":{"line":20,"column":21,"offset":694},"indent":[]}}],"position":{"start":{"line":20,"column":3,"offset":676},"end":{"line":20,"column":21,"offset":694},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":674},"end":{"line":20,"column":21,"offset":694},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"password: ","position":{"start":{"line":21,"column":3,"offset":697},"end":{"line":21,"column":13,"offset":707},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"kerberos","position":{"start":{"line":21,"column":15,"offset":709},"end":{"line":21,"column":23,"offset":717},"indent":[]}}],"position":{"start":{"line":21,"column":13,"offset":707},"end":{"line":21,"column":25,"offset":719},"indent":[]}}],"position":{"start":{"line":21,"column":3,"offset":697},"end":{"line":21,"column":25,"offset":719},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":695},"end":{"line":21,"column":25,"offset":719},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":674},"end":{"line":21,"column":25,"offset":719},"indent":[1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"The username and password can be changed in the ","position":{"start":{"line":23,"column":3,"offset":723},"end":{"line":23,"column":51,"offset":771},"indent":[]}},{"type":"inlineCode","value":"deployment.yaml","position":{"start":{"line":23,"column":51,"offset":771},"end":{"line":23,"column":68,"offset":788},"indent":[]}},{"type":"text","value":" file.","position":{"start":{"line":23,"column":68,"offset":788},"end":{"line":23,"column":74,"offset":794},"indent":[]}}],"position":{"start":{"line":23,"column":3,"offset":723},"end":{"line":23,"column":74,"offset":794},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":721},"end":{"line":23,"column":74,"offset":794},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"License key","position":{"start":{"line":25,"column":4,"offset":799},"end":{"line":25,"column":15,"offset":810},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":796},"end":{"line":25,"column":15,"offset":810},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The first time you login you are asked for a license key, this can be obtained by sending a request to cedric@verstraeten.io. An example license key looks like this:","position":{"start":{"line":27,"column":1,"offset":812},"end":{"line":27,"column":166,"offset":977},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":812},"end":{"line":27,"column":166,"offset":977},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"-----BEGIN LICENSE KEY-----\nL/+DAwEBB2xpY2Vuc2UB/4QAAQIBB1BheWxvYWQBCgABCVNpZ25hdHVyZQEKAAAA\n/9z/hAFUPBAADG1haW4uTGljZW5zZf+BAwEBB0xpY2Vuc2UB/4IAAQIBB0NvbXBh\nbnkBDAABB0V4cFRpbWUBBAAAABb/ghMBCmtlcmJlcm9zaW8B/MC7ZzIAAf+AOaJ+\n8eU3OlZCphr4uJyH/PzfuDkMrqyfIsutc5kSz3rjsRtU4e6vETpHre8CPvFyx5w2\n0O8PKCIR4z1q28qJK2cvHQTK0/zf+KfYLilEcmNczLXgg+bnPvtA/bU/K8ZEwbnw\nRta3+8zId+xtYQApdmHwo/Ih/vCN579iDeunwVQA\n-----END LICENSE KEY-----","position":{"start":{"line":29,"column":3,"offset":981},"end":{"line":36,"column":26,"offset":1400},"indent":[1,1,1,1,1,1,1]}}],"position":{"start":{"line":29,"column":3,"offset":981},"end":{"line":36,"column":26,"offset":1400},"indent":[1,1,1,1,1,1,1]}}],"position":{"start":{"line":29,"column":1,"offset":979},"end":{"line":36,"column":26,"offset":1400},"indent":[1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-licensekey.png","alt":"Factory","position":{"start":{"line":38,"column":1,"offset":1402},"end":{"line":38,"column":72,"offset":1473},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1402},"end":{"line":38,"column":72,"offset":1473},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you received a license key, and entered it into the web app you will be redirected to the login screen. Enter your credentials again, and you will be guided into the dashboard.","position":{"start":{"line":40,"column":1,"offset":1475},"end":{"line":40,"column":182,"offset":1656},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1475},"end":{"line":40,"column":182,"offset":1656},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Providers","position":{"start":{"line":43,"column":4,"offset":1662},"end":{"line":43,"column":13,"offset":1671},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":1659},"end":{"line":43,"column":13,"offset":1671},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you signed in succesfully, you land on the providers page. Here is the place where you can add your datasources. You can choose from:","position":{"start":{"line":45,"column":1,"offset":1673},"end":{"line":45,"column":139,"offset":1811},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":1673},"end":{"line":45,"column":139,"offset":1811},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":47,"column":6,"offset":1818},"end":{"line":47,"column":35,"offset":1847},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":1817},"end":{"line":47,"column":70,"offset":1882},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":1817},"end":{"line":47,"column":70,"offset":1882},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":1813},"end":{"line":47,"column":70,"offset":1882},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":48,"column":6,"offset":1888},"end":{"line":48,"column":29,"offset":1911},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":1887},"end":{"line":48,"column":83,"offset":1965},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":1887},"end":{"line":48,"column":83,"offset":1965},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":1883},"end":{"line":48,"column":83,"offset":1965},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":49,"column":6,"offset":1971},"end":{"line":49,"column":28,"offset":1993},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":1970},"end":{"line":49,"column":57,"offset":2022},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":1970},"end":{"line":49,"column":57,"offset":2022},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":1966},"end":{"line":49,"column":57,"offset":2022},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":50,"column":6,"offset":2028},"end":{"line":50,"column":11,"offset":2033},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":2027},"end":{"line":50,"column":29,"offset":2051},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":2027},"end":{"line":50,"column":29,"offset":2051},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2023},"end":{"line":50,"column":29,"offset":2051},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":1813},"end":{"line":50,"column":29,"offset":2051},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"For each provider, the appropriate security settings has to be filled in. For example for AWS you need to define the access and secret key, for GCP you need to define the Service Account.","position":{"start":{"line":52,"column":1,"offset":2053},"end":{"line":52,"column":188,"offset":2240},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":2053},"end":{"line":52,"column":188,"offset":2240},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Additionaly a provider can be marked as temporary. This is helpful if you wish to store your recordings for a short period, and want to use it for processing purpose only. A benefit of doing this is reducing costs (if you host in the public cloud).","position":{"start":{"line":54,"column":1,"offset":2242},"end":{"line":54,"column":249,"offset":2490},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":2242},"end":{"line":54,"column":249,"offset":2490},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-providers.png","alt":"Storage","position":{"start":{"line":56,"column":1,"offset":2492},"end":{"line":56,"column":63,"offset":2554},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":2492},"end":{"line":56,"column":63,"offset":2554},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Queues","position":{"start":{"line":58,"column":4,"offset":2559},"end":{"line":58,"column":10,"offset":2565},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":2556},"end":{"line":58,"column":10,"offset":2565},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Events or messages are generated each time a recording was uploaded to Kerberos Storage. These messages can be send to one ore moore message brokers such as Apache Kafka or AWS SQS. From the interface you can setup the connection, and once configured events will flow to your predefined message brokers.","position":{"start":{"line":60,"column":1,"offset":2567},"end":{"line":60,"column":304,"offset":2870},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":2567},"end":{"line":60,"column":304,"offset":2870},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"An example or usecase what you do with Queue's is building something like our Kerberos Cloud offering. Each time a Kerberos Cloud customer is sending recordings to his/her cloud profile, it is stored through Kerberos Storage into one of our public data centers. Next to that a message is send into our private Kafka broker, which is starting a chain of processing:","position":{"start":{"line":62,"column":1,"offset":2872},"end":{"line":62,"column":365,"offset":3236},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":2872},"end":{"line":62,"column":365,"offset":3236},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Metadata storage in MongoDB,","position":{"start":{"line":64,"column":5,"offset":3242},"end":{"line":64,"column":33,"offset":3270},"indent":[]}}],"position":{"start":{"line":64,"column":5,"offset":3242},"end":{"line":64,"column":33,"offset":3270},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":3238},"end":{"line":64,"column":33,"offset":3270},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Notifications,","position":{"start":{"line":65,"column":5,"offset":3275},"end":{"line":65,"column":19,"offset":3289},"indent":[]}}],"position":{"start":{"line":65,"column":5,"offset":3275},"end":{"line":65,"column":19,"offset":3289},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":3271},"end":{"line":65,"column":19,"offset":3289},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Classification with Tensorflow,","position":{"start":{"line":66,"column":5,"offset":3294},"end":{"line":66,"column":36,"offset":3325},"indent":[]}}],"position":{"start":{"line":66,"column":5,"offset":3294},"end":{"line":66,"column":36,"offset":3325},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":3290},"end":{"line":66,"column":36,"offset":3325},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Counting algorithms,","position":{"start":{"line":67,"column":5,"offset":3330},"end":{"line":67,"column":25,"offset":3350},"indent":[]}}],"position":{"start":{"line":67,"column":5,"offset":3330},"end":{"line":67,"column":25,"offset":3350},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3326},"end":{"line":67,"column":25,"offset":3350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"and much more.","position":{"start":{"line":68,"column":5,"offset":3355},"end":{"line":68,"column":19,"offset":3369},"indent":[]}}],"position":{"start":{"line":68,"column":5,"offset":3355},"end":{"line":68,"column":19,"offset":3369},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":3351},"end":{"line":68,"column":19,"offset":3369},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":3238},"end":{"line":68,"column":19,"offset":3369},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-queues.png","alt":"Storage","position":{"start":{"line":70,"column":1,"offset":3371},"end":{"line":70,"column":60,"offset":3430},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":3371},"end":{"line":70,"column":60,"offset":3430},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Accounts","position":{"start":{"line":72,"column":4,"offset":3435},"end":{"line":72,"column":12,"offset":3443},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3432},"end":{"line":72,"column":12,"offset":3443},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Accounts is the access for end users or customers. In the account section we define configurations such as:","position":{"start":{"line":74,"column":1,"offset":3445},"end":{"line":74,"column":108,"offset":3552},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":3445},"end":{"line":74,"column":108,"offset":3552},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Allowed providers,","position":{"start":{"line":75,"column":5,"offset":3557},"end":{"line":75,"column":23,"offset":3575},"indent":[]}}],"position":{"start":{"line":75,"column":5,"offset":3557},"end":{"line":75,"column":23,"offset":3575},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3553},"end":{"line":75,"column":23,"offset":3575},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Public Key,","position":{"start":{"line":76,"column":5,"offset":3580},"end":{"line":76,"column":16,"offset":3591},"indent":[]}}],"position":{"start":{"line":76,"column":5,"offset":3580},"end":{"line":76,"column":16,"offset":3591},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":3576},"end":{"line":76,"column":16,"offset":3591},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secret Key,","position":{"start":{"line":77,"column":5,"offset":3596},"end":{"line":77,"column":16,"offset":3607},"indent":[]}}],"position":{"start":{"line":77,"column":5,"offset":3596},"end":{"line":77,"column":16,"offset":3607},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3592},"end":{"line":77,"column":16,"offset":3607},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Day limit","position":{"start":{"line":78,"column":5,"offset":3612},"end":{"line":78,"column":14,"offset":3621},"indent":[]}}],"position":{"start":{"line":78,"column":5,"offset":3612},"end":{"line":78,"column":14,"offset":3621},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":3608},"end":{"line":78,"column":14,"offset":3621},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3553},"end":{"line":78,"column":14,"offset":3621},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"An account can be generated for each individual, or a asteriks account (*) can be generated; which is more suitable if you want to seperate devices or regions of devices.\nOnce an account is created it can be used in Kerberos Enterprise (and soon Kerberos Open Source) to persist your data from your Kerberos Agent into your own datacenter, public or private cloud.","position":{"start":{"line":80,"column":1,"offset":3623},"end":{"line":81,"column":194,"offset":3987},"indent":[1]}}],"position":{"start":{"line":80,"column":1,"offset":3623},"end":{"line":81,"column":194,"offset":3987},"indent":[1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-accounts.png","alt":"Storage","position":{"start":{"line":83,"column":1,"offset":3989},"end":{"line":83,"column":62,"offset":4050},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":3989},"end":{"line":83,"column":62,"offset":4050},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Media","position":{"start":{"line":85,"column":4,"offset":4055},"end":{"line":85,"column":9,"offset":4060},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":4052},"end":{"line":85,"column":9,"offset":4060},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"All recordings send through Kerberos Storage are stored, both for auditing as for cleanup policies.","position":{"start":{"line":87,"column":1,"offset":4062},"end":{"line":87,"column":100,"offset":4161},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4062},"end":{"line":87,"column":100,"offset":4161},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-media.png","alt":"Storage","position":{"start":{"line":89,"column":1,"offset":4163},"end":{"line":89,"column":59,"offset":4221},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4163},"end":{"line":89,"column":59,"offset":4221},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cleanup","position":{"start":{"line":91,"column":4,"offset":4226},"end":{"line":91,"column":11,"offset":4233},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4223},"end":{"line":91,"column":11,"offset":4233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Storage might need to be erased after a while because of several reasons:","position":{"start":{"line":93,"column":1,"offset":4235},"end":{"line":93,"column":74,"offset":4308},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4235},"end":{"line":93,"column":74,"offset":4308},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"maybe the data is no longer relevant","position":{"start":{"line":95,"column":3,"offset":4312},"end":{"line":95,"column":39,"offset":4348},"indent":[]}}],"position":{"start":{"line":95,"column":3,"offset":4312},"end":{"line":95,"column":39,"offset":4348},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4310},"end":{"line":95,"column":39,"offset":4348},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"due to security reasions","position":{"start":{"line":96,"column":3,"offset":4351},"end":{"line":96,"column":27,"offset":4375},"indent":[]}}],"position":{"start":{"line":96,"column":3,"offset":4351},"end":{"line":96,"column":27,"offset":4375},"indent":[]}}],"position":{"start":{"line":96,"column":1,"offset":4349},"end":{"line":96,"column":27,"offset":4375},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"etc.","position":{"start":{"line":97,"column":3,"offset":4378},"end":{"line":97,"column":7,"offset":4382},"indent":[]}}],"position":{"start":{"line":97,"column":3,"offset":4378},"end":{"line":97,"column":7,"offset":4382},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4376},"end":{"line":97,"column":7,"offset":4382},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4310},"end":{"line":97,"column":7,"offset":4382},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"To make this possible Kerberos Storage comes with a configurable cleanup script, which you can run inside your Kuberneters cluster next to your Kerberos Storage deployment.","position":{"start":{"line":99,"column":1,"offset":4384},"end":{"line":99,"column":173,"offset":4556},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4384},"end":{"line":99,"column":173,"offset":4556},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":102,"column":1,"offset":4559},"end":{"line":102,"column":31,"offset":4589},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":102,"column":31,"offset":4589}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Get Started`}

\n

{`Once you've installed Kerberos Storage, you will have the Storage web application. This web application allows you to administrate Kerberos Storage. You can add storage providers, queues, accounts, and more.`}

\n

{`Login page`}

\n

{`Once you open a browser, and navigate to the Storage web application (see installation for the url), you will land on the login page.`}

\n

\"Storage\"

\n

{`The default username password of the Storage applications is:`}

\n
    \n
  • {`username: `}{`root`}
    • \n
  • {`password: `}{`kerberos`}
    • \n
\n
\n

{`The username and password can be changed in the `}{`deployment.yaml`}{` file.`}

\n
\n

{`License key`}

\n

{`The first time you login you are asked for a license key, this can be obtained by sending a request to cedric@verstraeten.io. An example license key looks like this:`}

\n
\n

{`-----BEGIN LICENSE KEY-----\nL/+DAwEBB2xpY2Vuc2UB/4QAAQIBB1BheWxvYWQBCgABCVNpZ25hdHVyZQEKAAAA\n/9z/hAFUPBAADG1haW4uTGljZW5zZf+BAwEBB0xpY2Vuc2UB/4IAAQIBB0NvbXBh\nbnkBDAABB0V4cFRpbWUBBAAAABb/ghMBCmtlcmJlcm9zaW8B/MC7ZzIAAf+AOaJ+\n8eU3OlZCphr4uJyH/PzfuDkMrqyfIsutc5kSz3rjsRtU4e6vETpHre8CPvFyx5w2\n0O8PKCIR4z1q28qJK2cvHQTK0/zf+KfYLilEcmNczLXgg+bnPvtA/bU/K8ZEwbnw\nRta3+8zId+xtYQApdmHwo/Ih/vCN579iDeunwVQA\n-----END LICENSE KEY-----`}

\n
\n

\"Factory\"

\n

{`Once you received a license key, and entered it into the web app you will be redirected to the login screen. Enter your credentials again, and you will be guided into the dashboard.`}

\n

{`Providers`}

\n

{`Once you signed in succesfully, you land on the providers page. Here is the place where you can add your datasources. You can choose from:`}

\n \n

{`For each provider, the appropriate security settings has to be filled in. For example for AWS you need to define the access and secret key, for GCP you need to define the Service Account.`}

\n

{`Additionaly a provider can be marked as temporary. This is helpful if you wish to store your recordings for a short period, and want to use it for processing purpose only. A benefit of doing this is reducing costs (if you host in the public cloud).`}

\n

\"Storage\"

\n

{`Queues`}

\n

{`Events or messages are generated each time a recording was uploaded to Kerberos Storage. These messages can be send to one ore moore message brokers such as Apache Kafka or AWS SQS. From the interface you can setup the connection, and once configured events will flow to your predefined message brokers.`}

\n

{`An example or usecase what you do with Queue's is building something like our Kerberos Cloud offering. Each time a Kerberos Cloud customer is sending recordings to his/her cloud profile, it is stored through Kerberos Storage into one of our public data centers. Next to that a message is send into our private Kafka broker, which is starting a chain of processing:`}

\n
    \n
  • {`Metadata storage in MongoDB,`}
    • \n
  • {`Notifications,`}
    • \n
  • {`Classification with Tensorflow,`}
    • \n
  • {`Counting algorithms,`}
    • \n
  • {`and much more.`}
    • \n
\n

\"Storage\"

\n

{`Accounts`}

\n

{`Accounts is the access for end users or customers. In the account section we define configurations such as:`}

\n
    \n
  • {`Allowed providers,`}
    • \n
  • {`Public Key,`}
    • \n
  • {`Secret Key,`}
    • \n
  • {`Day limit`}
    • \n
\n

{`An account can be generated for each individual, or a asteriks account (*) can be generated; which is more suitable if you want to seperate devices or regions of devices.\nOnce an account is created it can be used in Kerberos Enterprise (and soon Kerberos Open Source) to persist your data from your Kerberos Agent into your own datacenter, public or private cloud.`}

\n

\"Storage\"

\n

{`Media`}

\n

{`All recordings send through Kerberos Storage are stored, both for auditing as for cleanup policies.`}

\n

\"Storage\"

\n

{`Cleanup`}

\n

{`Storage might need to be erased after a while because of several reasons:`}

\n
    \n
  • {`maybe the data is no longer relevant`}
    • \n
  • {`due to security reasions`}
    • \n
  • {`etc.`}
    • \n
\n

{`To make this possible Kerberos Storage comes with a configurable cleanup script, which you can run inside your Kuberneters cluster next to your Kerberos Storage deployment.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-47c91d43e9c583d4b2fe7c77212328c9.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-47c91d43e9c583d4b2fe7c77212328c9.json new file mode 100644 index 0000000..6e8690e --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-47c91d43e9c583d4b2fe7c77212328c9.json @@ -0,0 +1 @@ +{"expireTime":9007200861829359000,"key":"gatsby-plugin-mdx-entire-payload-600eaedf4e3c28400b226ed6d6c2c62f-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers.","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":163,"offset":518},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":163,"offset":518},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":524},"end":{"line":16,"column":21,"offset":540},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":520},"end":{"line":16,"column":21,"offset":540},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and be consumed by ","position":{"start":{"line":18,"column":1,"offset":542},"end":{"line":18,"column":191,"offset":732},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":192,"offset":733},"end":{"line":18,"column":206,"offset":747},"indent":[]}}],"position":{"start":{"line":18,"column":191,"offset":732},"end":{"line":18,"column":215,"offset":756},"indent":[]}},{"type":"text","value":" in parrallel. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":18,"column":215,"offset":756},"end":{"line":18,"column":632,"offset":1173},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":542},"end":{"line":18,"column":632,"offset":1173},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":20,"column":4,"offset":1178},"end":{"line":20,"column":18,"offset":1192},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1175},"end":{"line":20,"column":18,"offset":1192},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":22,"column":1,"offset":1194},"end":{"line":22,"column":291,"offset":1484},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":22,"column":292,"offset":1485},"end":{"line":22,"column":309,"offset":1502},"indent":[]}}],"position":{"start":{"line":22,"column":291,"offset":1484},"end":{"line":22,"column":318,"offset":1511},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":22,"column":318,"offset":1511},"end":{"line":22,"column":319,"offset":1512},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1194},"end":{"line":22,"column":319,"offset":1512},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":24,"column":1,"offset":1514},"end":{"line":24,"column":56,"offset":1569},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1514},"end":{"line":24,"column":56,"offset":1569},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":26,"column":4,"offset":1574},"end":{"line":26,"column":20,"offset":1590},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1571},"end":{"line":26,"column":20,"offset":1590},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":28,"column":1,"offset":1592},"end":{"line":28,"column":253,"offset":1844},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1592},"end":{"line":28,"column":253,"offset":1844},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":30,"column":6,"offset":1851},"end":{"line":30,"column":35,"offset":1880},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1850},"end":{"line":30,"column":70,"offset":1915},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1850},"end":{"line":30,"column":70,"offset":1915},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1846},"end":{"line":30,"column":70,"offset":1915},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":31,"column":6,"offset":1921},"end":{"line":31,"column":29,"offset":1944},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":1920},"end":{"line":31,"column":83,"offset":1998},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":1920},"end":{"line":31,"column":83,"offset":1998},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1916},"end":{"line":31,"column":83,"offset":1998},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":32,"column":6,"offset":2004},"end":{"line":32,"column":28,"offset":2026},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2003},"end":{"line":32,"column":57,"offset":2055},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2003},"end":{"line":32,"column":57,"offset":2055},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1999},"end":{"line":32,"column":57,"offset":2055},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":33,"column":6,"offset":2061},"end":{"line":33,"column":11,"offset":2066},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2060},"end":{"line":33,"column":29,"offset":2084},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2060},"end":{"line":33,"column":29,"offset":2084},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2056},"end":{"line":33,"column":29,"offset":2084},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1846},"end":{"line":33,"column":29,"offset":2084},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":35,"column":1,"offset":2086},"end":{"line":35,"column":190,"offset":2275},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2086},"end":{"line":35,"column":190,"offset":2275},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":37,"column":1,"offset":2277},"end":{"line":37,"column":99,"offset":2375},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2277},"end":{"line":37,"column":99,"offset":2375},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":39,"column":1,"offset":2377},"end":{"line":39,"column":220,"offset":2596},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2377},"end":{"line":39,"column":220,"offset":2596},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":41,"column":1,"offset":2598},"end":{"line":41,"column":98,"offset":2695},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2598},"end":{"line":41,"column":98,"offset":2695},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":43,"column":5,"offset":2701},"end":{"line":43,"column":11,"offset":2707},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2697},"end":{"line":43,"column":11,"offset":2707},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":45,"column":1,"offset":2709},"end":{"line":45,"column":303,"offset":3011},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2709},"end":{"line":45,"column":303,"offset":3011},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":47,"column":6,"offset":3018},"end":{"line":47,"column":18,"offset":3030},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3017},"end":{"line":47,"column":46,"offset":3058},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3017},"end":{"line":47,"column":46,"offset":3058},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3013},"end":{"line":47,"column":46,"offset":3058},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":48,"column":6,"offset":3064},"end":{"line":48,"column":29,"offset":3087},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3063},"end":{"line":48,"column":59,"offset":3117},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3063},"end":{"line":48,"column":59,"offset":3117},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":3059},"end":{"line":48,"column":59,"offset":3117},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3013},"end":{"line":48,"column":59,"offset":3117},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":50,"column":1,"offset":3119},"end":{"line":50,"column":368,"offset":3486},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3119},"end":{"line":50,"column":368,"offset":3486},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":52,"column":1,"offset":3488},"end":{"line":52,"column":66,"offset":3553},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3488},"end":{"line":52,"column":66,"offset":3553},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":54,"column":5,"offset":3559},"end":{"line":54,"column":21,"offset":3575},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3555},"end":{"line":54,"column":21,"offset":3575},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":56,"column":1,"offset":3577},"end":{"line":56,"column":237,"offset":3813},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3577},"end":{"line":56,"column":237,"offset":3813},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":58,"column":1,"offset":3815},"end":{"line":58,"column":105,"offset":3919},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3815},"end":{"line":58,"column":105,"offset":3919},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":60,"column":1,"offset":3921},"end":{"line":60,"column":45,"offset":3965},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":3921},"end":{"line":60,"column":45,"offset":3965},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":62,"column":3,"offset":3969},"end":{"line":62,"column":380,"offset":4346},"indent":[]}}],"position":{"start":{"line":62,"column":3,"offset":3969},"end":{"line":62,"column":380,"offset":4346},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":3967},"end":{"line":63,"column":1,"offset":4347},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":64,"column":3,"offset":4350},"end":{"line":65,"column":49,"offset":4664},"indent":[2]}}],"position":{"start":{"line":64,"column":3,"offset":4350},"end":{"line":65,"column":49,"offset":4664},"indent":[2]}}],"position":{"start":{"line":64,"column":1,"offset":4348},"end":{"line":65,"column":49,"offset":4664},"indent":[1]}}],"position":{"start":{"line":62,"column":1,"offset":3967},"end":{"line":65,"column":49,"offset":4664},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":67,"column":5,"offset":4670},"end":{"line":67,"column":13,"offset":4678},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":4666},"end":{"line":67,"column":13,"offset":4678},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":69,"column":1,"offset":4680},"end":{"line":69,"column":156,"offset":4835},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":69,"column":156,"offset":4835},"end":{"line":69,"column":177,"offset":4856},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":69,"column":177,"offset":4856},"end":{"line":69,"column":188,"offset":4867},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":69,"column":188,"offset":4867},"end":{"line":69,"column":193,"offset":4872},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":69,"column":193,"offset":4872},"end":{"line":69,"column":379,"offset":5058},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4680},"end":{"line":69,"column":379,"offset":5058},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":71,"column":1,"offset":5060},"end":{"line":71,"column":68,"offset":5127},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":5060},"end":{"line":71,"column":68,"offset":5127},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":73,"column":4,"offset":5132},"end":{"line":73,"column":13,"offset":5141},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5129},"end":{"line":73,"column":13,"offset":5141},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":75,"column":1,"offset":5143},"end":{"line":75,"column":44,"offset":5186},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":75,"column":46,"offset":5188},"end":{"line":75,"column":68,"offset":5210},"indent":[]}}],"position":{"start":{"line":75,"column":44,"offset":5186},"end":{"line":75,"column":70,"offset":5212},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":75,"column":70,"offset":5212},"end":{"line":75,"column":106,"offset":5248},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":75,"column":108,"offset":5250},"end":{"line":75,"column":129,"offset":5271},"indent":[]}}],"position":{"start":{"line":75,"column":106,"offset":5248},"end":{"line":75,"column":131,"offset":5273},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":75,"column":131,"offset":5273},"end":{"line":75,"column":159,"offset":5301},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5143},"end":{"line":75,"column":159,"offset":5301},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":78,"column":1,"offset":5304},"end":{"line":78,"column":31,"offset":5334},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":78,"column":31,"offset":5334}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers.`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and be consumed by `}{`Kerberos Cloud`}{` in parrallel. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4caca5b4ef3dce40e34bf5769d6e80f8.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4caca5b4ef3dce40e34bf5769d6e80f8.json index 3492df1..ebb2151 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4caca5b4ef3dce40e34bf5769d6e80f8.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4caca5b4ef3dce40e34bf5769d6e80f8.json @@ -1 +1 @@ -{"expireTime":9007200861747674000,"key":"gatsby-plugin-mdx-entire-payload-02357fd739a950d3710dc9d26d509652-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Upgrade","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To upgrade your Kerberos agent to a new version you should follow the approach which fits your initial installation method. If you installed KiOS follow the KiOS upgrade procedure, if installed on Raspbian follow the Raspbian upgrade procedure, etc.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":250,"offset":419},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":250,"offset":419},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Please note that it might be possible that some new files are added or existing files were updated. To make sure everything works as expected, you should clear your browser cache.","position":{"start":{"line":12,"column":1,"offset":421},"end":{"line":12,"column":180,"offset":600},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":421},"end":{"line":12,"column":180,"offset":600},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"KiOS","position":{"start":{"line":14,"column":4,"offset":605},"end":{"line":14,"column":8,"offset":609},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":602},"end":{"line":14,"column":8,"offset":609},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you installed KiOS, you can use the built-in upgrade method, ","position":{"start":{"line":16,"column":1,"offset":611},"end":{"line":16,"column":65,"offset":675},"indent":[]}},{"type":"inlineCode","value":"fwupdate","position":{"start":{"line":16,"column":65,"offset":675},"end":{"line":16,"column":75,"offset":685},"indent":[]}},{"type":"text","value":". The ","position":{"start":{"line":16,"column":75,"offset":685},"end":{"line":16,"column":81,"offset":691},"indent":[]}},{"type":"inlineCode","value":"fwupdate","position":{"start":{"line":16,"column":81,"offset":691},"end":{"line":16,"column":91,"offset":701},"indent":[]}},{"type":"text","value":" command is a shell script which contains a couple of functions. For example it allows you to download, extract and flash a new version of KiOS to your SD card. The process is pretty straight forward.","position":{"start":{"line":16,"column":91,"offset":701},"end":{"line":16,"column":291,"offset":901},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":611},"end":{"line":16,"column":291,"offset":901},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"First SSH or connect to KiOS first, and execute following command to see your current version.","position":{"start":{"line":18,"column":1,"offset":903},"end":{"line":18,"column":95,"offset":997},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":903},"end":{"line":18,"column":95,"offset":997},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"fwupdate current","position":{"start":{"line":20,"column":1,"offset":999},"end":{"line":22,"column":4,"offset":1027},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Next look for all available versions of KiOS.","position":{"start":{"line":24,"column":1,"offset":1029},"end":{"line":24,"column":46,"offset":1074},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1029},"end":{"line":24,"column":46,"offset":1074},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"fwupdate versions","position":{"start":{"line":26,"column":1,"offset":1076},"end":{"line":28,"column":4,"offset":1105},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Select the version to which you would like to upgrade, and run following command.","position":{"start":{"line":30,"column":1,"offset":1107},"end":{"line":30,"column":82,"offset":1188},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1107},"end":{"line":30,"column":82,"offset":1188},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"fwupdate upgrade ","position":{"start":{"line":32,"column":1,"offset":1190},"end":{"line":34,"column":4,"offset":1228},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"KiOS will reboot, and your new version will be available.","position":{"start":{"line":36,"column":1,"offset":1230},"end":{"line":36,"column":58,"offset":1287},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":1230},"end":{"line":36,"column":58,"offset":1287},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Raspbian","position":{"start":{"line":38,"column":4,"offset":1292},"end":{"line":38,"column":12,"offset":1300},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1289},"end":{"line":38,"column":12,"offset":1300},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to install a new version of the Kerberos agent for Raspbian, there is no automated versioning process available like KiOS. To perform an upgrade you'll need to follow the ","position":{"start":{"line":40,"column":1,"offset":1302},"end":{"line":40,"column":184,"offset":1485},"indent":[]}},{"type":"link","title":null,"url":"/opensource/installation#raspbian","children":[{"type":"text","value":"traditional installation","position":{"start":{"line":40,"column":185,"offset":1486},"end":{"line":40,"column":209,"offset":1510},"indent":[]}}],"position":{"start":{"line":40,"column":184,"offset":1485},"end":{"line":40,"column":245,"offset":1546},"indent":[]}},{"type":"text","value":" procedure of Raspbian.","position":{"start":{"line":40,"column":245,"offset":1546},"end":{"line":40,"column":268,"offset":1569},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1302},"end":{"line":40,"column":268,"offset":1569},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Docker","position":{"start":{"line":42,"column":4,"offset":1574},"end":{"line":42,"column":10,"offset":1580},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":1571},"end":{"line":42,"column":10,"offset":1580},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When a new release is available, a new Docker image will be available on the Docker hub. You can simply delete your existing container and image, and download it again.","position":{"start":{"line":44,"column":1,"offset":1582},"end":{"line":44,"column":169,"offset":1750},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":1582},"end":{"line":44,"column":169,"offset":1750},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":47,"column":1,"offset":1753},"end":{"line":47,"column":31,"offset":1783},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":47,"column":31,"offset":1783}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Upgrade`}

\n

{`To upgrade your Kerberos agent to a new version you should follow the approach which fits your initial installation method. If you installed KiOS follow the KiOS upgrade procedure, if installed on Raspbian follow the Raspbian upgrade procedure, etc.`}

\n

{`Please note that it might be possible that some new files are added or existing files were updated. To make sure everything works as expected, you should clear your browser cache.`}

\n

{`KiOS`}

\n

{`If you installed KiOS, you can use the built-in upgrade method, `}{`fwupdate`}{`. The `}{`fwupdate`}{` command is a shell script which contains a couple of functions. For example it allows you to download, extract and flash a new version of KiOS to your SD card. The process is pretty straight forward.`}

\n

{`First SSH or connect to KiOS first, and execute following command to see your current version.`}

\n 
{`fwupdate current`}
\n

{`Next look for all available versions of KiOS.`}

\n 
{`fwupdate versions`}
\n

{`Select the version to which you would like to upgrade, and run following command.`}

\n 
{`fwupdate upgrade `}
\n

{`KiOS will reboot, and your new version will be available.`}

\n

{`Raspbian`}

\n

{`If you want to install a new version of the Kerberos agent for Raspbian, there is no automated versioning process available like KiOS. To perform an upgrade you'll need to follow the `}{`traditional installation`}{` procedure of Raspbian.`}

\n

{`Docker`}

\n

{`When a new release is available, a new Docker image will be available on the Docker hub. You can simply delete your existing container and image, and download it again.`}

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750178000,"key":"gatsby-plugin-mdx-entire-payload-02357fd739a950d3710dc9d26d509652-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Upgrade","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To upgrade your Kerberos agent to a new version you should follow the approach which fits your initial installation method. If you installed KiOS follow the KiOS upgrade procedure, if installed on Raspbian follow the Raspbian upgrade procedure, etc.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":250,"offset":419},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":250,"offset":419},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Please note that it might be possible that some new files are added or existing files were updated. To make sure everything works as expected, you should clear your browser cache.","position":{"start":{"line":12,"column":1,"offset":421},"end":{"line":12,"column":180,"offset":600},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":421},"end":{"line":12,"column":180,"offset":600},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"KiOS","position":{"start":{"line":14,"column":4,"offset":605},"end":{"line":14,"column":8,"offset":609},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":602},"end":{"line":14,"column":8,"offset":609},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you installed KiOS, you can use the built-in upgrade method, ","position":{"start":{"line":16,"column":1,"offset":611},"end":{"line":16,"column":65,"offset":675},"indent":[]}},{"type":"inlineCode","value":"fwupdate","position":{"start":{"line":16,"column":65,"offset":675},"end":{"line":16,"column":75,"offset":685},"indent":[]}},{"type":"text","value":". The ","position":{"start":{"line":16,"column":75,"offset":685},"end":{"line":16,"column":81,"offset":691},"indent":[]}},{"type":"inlineCode","value":"fwupdate","position":{"start":{"line":16,"column":81,"offset":691},"end":{"line":16,"column":91,"offset":701},"indent":[]}},{"type":"text","value":" command is a shell script which contains a couple of functions. For example it allows you to download, extract and flash a new version of KiOS to your SD card. The process is pretty straight forward.","position":{"start":{"line":16,"column":91,"offset":701},"end":{"line":16,"column":291,"offset":901},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":611},"end":{"line":16,"column":291,"offset":901},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"First SSH or connect to KiOS first, and execute following command to see your current version.","position":{"start":{"line":18,"column":1,"offset":903},"end":{"line":18,"column":95,"offset":997},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":903},"end":{"line":18,"column":95,"offset":997},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"fwupdate current","position":{"start":{"line":20,"column":1,"offset":999},"end":{"line":22,"column":4,"offset":1027},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Next look for all available versions of KiOS.","position":{"start":{"line":24,"column":1,"offset":1029},"end":{"line":24,"column":46,"offset":1074},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1029},"end":{"line":24,"column":46,"offset":1074},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"fwupdate versions","position":{"start":{"line":26,"column":1,"offset":1076},"end":{"line":28,"column":4,"offset":1105},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Select the version to which you would like to upgrade, and run following command.","position":{"start":{"line":30,"column":1,"offset":1107},"end":{"line":30,"column":82,"offset":1188},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1107},"end":{"line":30,"column":82,"offset":1188},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"fwupdate upgrade ","position":{"start":{"line":32,"column":1,"offset":1190},"end":{"line":34,"column":4,"offset":1228},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"KiOS will reboot, and your new version will be available.","position":{"start":{"line":36,"column":1,"offset":1230},"end":{"line":36,"column":58,"offset":1287},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":1230},"end":{"line":36,"column":58,"offset":1287},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Raspbian","position":{"start":{"line":38,"column":4,"offset":1292},"end":{"line":38,"column":12,"offset":1300},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1289},"end":{"line":38,"column":12,"offset":1300},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to install a new version of the Kerberos agent for Raspbian, there is no automated versioning process available like KiOS. To perform an upgrade you'll need to follow the ","position":{"start":{"line":40,"column":1,"offset":1302},"end":{"line":40,"column":184,"offset":1485},"indent":[]}},{"type":"link","title":null,"url":"/opensource/installation#raspbian","children":[{"type":"text","value":"traditional installation","position":{"start":{"line":40,"column":185,"offset":1486},"end":{"line":40,"column":209,"offset":1510},"indent":[]}}],"position":{"start":{"line":40,"column":184,"offset":1485},"end":{"line":40,"column":245,"offset":1546},"indent":[]}},{"type":"text","value":" procedure of Raspbian.","position":{"start":{"line":40,"column":245,"offset":1546},"end":{"line":40,"column":268,"offset":1569},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1302},"end":{"line":40,"column":268,"offset":1569},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Docker","position":{"start":{"line":42,"column":4,"offset":1574},"end":{"line":42,"column":10,"offset":1580},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":1571},"end":{"line":42,"column":10,"offset":1580},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When a new release is available, a new Docker image will be available on the Docker hub. You can simply delete your existing container and image, and download it again.","position":{"start":{"line":44,"column":1,"offset":1582},"end":{"line":44,"column":169,"offset":1750},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":1582},"end":{"line":44,"column":169,"offset":1750},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":47,"column":1,"offset":1753},"end":{"line":47,"column":31,"offset":1783},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":47,"column":31,"offset":1783}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Upgrade`}

\n

{`To upgrade your Kerberos agent to a new version you should follow the approach which fits your initial installation method. If you installed KiOS follow the KiOS upgrade procedure, if installed on Raspbian follow the Raspbian upgrade procedure, etc.`}

\n

{`Please note that it might be possible that some new files are added or existing files were updated. To make sure everything works as expected, you should clear your browser cache.`}

\n

{`KiOS`}

\n

{`If you installed KiOS, you can use the built-in upgrade method, `}{`fwupdate`}{`. The `}{`fwupdate`}{` command is a shell script which contains a couple of functions. For example it allows you to download, extract and flash a new version of KiOS to your SD card. The process is pretty straight forward.`}

\n

{`First SSH or connect to KiOS first, and execute following command to see your current version.`}

\n 
{`fwupdate current`}
\n

{`Next look for all available versions of KiOS.`}

\n 
{`fwupdate versions`}
\n

{`Select the version to which you would like to upgrade, and run following command.`}

\n 
{`fwupdate upgrade `}
\n

{`KiOS will reboot, and your new version will be available.`}

\n

{`Raspbian`}

\n

{`If you want to install a new version of the Kerberos agent for Raspbian, there is no automated versioning process available like KiOS. To perform an upgrade you'll need to follow the `}{`traditional installation`}{` procedure of Raspbian.`}

\n

{`Docker`}

\n

{`When a new release is available, a new Docker image will be available on the Docker hub. You can simply delete your existing container and image, and download it again.`}

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4d96d56370c74240dde45798607d768f.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4d96d56370c74240dde45798607d768f.json new file mode 100644 index 0000000..5fbdde7 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4d96d56370c74240dde45798607d768f.json @@ -0,0 +1 @@ +{"expireTime":9007200861829610000,"key":"gatsby-plugin-mdx-entire-payload-86d6d1d4fc3f974eafb96ec5fe8f5b55-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":585,"offset":1238},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":585,"offset":1238},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":20,"column":4,"offset":1243},"end":{"line":20,"column":18,"offset":1257},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1240},"end":{"line":20,"column":18,"offset":1257},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":22,"column":1,"offset":1259},"end":{"line":22,"column":291,"offset":1549},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":22,"column":292,"offset":1550},"end":{"line":22,"column":309,"offset":1567},"indent":[]}}],"position":{"start":{"line":22,"column":291,"offset":1549},"end":{"line":22,"column":318,"offset":1576},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":22,"column":318,"offset":1576},"end":{"line":22,"column":319,"offset":1577},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1259},"end":{"line":22,"column":319,"offset":1577},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":24,"column":1,"offset":1579},"end":{"line":24,"column":56,"offset":1634},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1579},"end":{"line":24,"column":56,"offset":1634},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":26,"column":4,"offset":1639},"end":{"line":26,"column":20,"offset":1655},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1636},"end":{"line":26,"column":20,"offset":1655},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":28,"column":1,"offset":1657},"end":{"line":28,"column":253,"offset":1909},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1657},"end":{"line":28,"column":253,"offset":1909},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":30,"column":6,"offset":1916},"end":{"line":30,"column":35,"offset":1945},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1915},"end":{"line":30,"column":70,"offset":1980},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1915},"end":{"line":30,"column":70,"offset":1980},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1911},"end":{"line":30,"column":70,"offset":1980},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":31,"column":6,"offset":1986},"end":{"line":31,"column":29,"offset":2009},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":1985},"end":{"line":31,"column":83,"offset":2063},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":1985},"end":{"line":31,"column":83,"offset":2063},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1981},"end":{"line":31,"column":83,"offset":2063},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":32,"column":6,"offset":2069},"end":{"line":32,"column":28,"offset":2091},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2068},"end":{"line":32,"column":57,"offset":2120},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2068},"end":{"line":32,"column":57,"offset":2120},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2064},"end":{"line":32,"column":57,"offset":2120},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":33,"column":6,"offset":2126},"end":{"line":33,"column":11,"offset":2131},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2125},"end":{"line":33,"column":29,"offset":2149},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2125},"end":{"line":33,"column":29,"offset":2149},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2121},"end":{"line":33,"column":29,"offset":2149},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1911},"end":{"line":33,"column":29,"offset":2149},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":35,"column":1,"offset":2151},"end":{"line":35,"column":190,"offset":2340},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2151},"end":{"line":35,"column":190,"offset":2340},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":37,"column":1,"offset":2342},"end":{"line":37,"column":99,"offset":2440},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2342},"end":{"line":37,"column":99,"offset":2440},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":39,"column":1,"offset":2442},"end":{"line":39,"column":220,"offset":2661},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2442},"end":{"line":39,"column":220,"offset":2661},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":41,"column":1,"offset":2663},"end":{"line":41,"column":98,"offset":2760},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2663},"end":{"line":41,"column":98,"offset":2760},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":43,"column":5,"offset":2766},"end":{"line":43,"column":11,"offset":2772},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2762},"end":{"line":43,"column":11,"offset":2772},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":45,"column":1,"offset":2774},"end":{"line":45,"column":303,"offset":3076},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2774},"end":{"line":45,"column":303,"offset":3076},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":47,"column":6,"offset":3083},"end":{"line":47,"column":18,"offset":3095},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3082},"end":{"line":47,"column":46,"offset":3123},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3082},"end":{"line":47,"column":46,"offset":3123},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3078},"end":{"line":47,"column":46,"offset":3123},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":48,"column":6,"offset":3129},"end":{"line":48,"column":29,"offset":3152},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3128},"end":{"line":48,"column":59,"offset":3182},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3128},"end":{"line":48,"column":59,"offset":3182},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":3124},"end":{"line":48,"column":59,"offset":3182},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3078},"end":{"line":48,"column":59,"offset":3182},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":50,"column":1,"offset":3184},"end":{"line":50,"column":368,"offset":3551},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3184},"end":{"line":50,"column":368,"offset":3551},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":52,"column":1,"offset":3553},"end":{"line":52,"column":66,"offset":3618},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3553},"end":{"line":52,"column":66,"offset":3618},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":54,"column":5,"offset":3624},"end":{"line":54,"column":21,"offset":3640},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3620},"end":{"line":54,"column":21,"offset":3640},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":56,"column":1,"offset":3642},"end":{"line":56,"column":237,"offset":3878},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3642},"end":{"line":56,"column":237,"offset":3878},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":58,"column":1,"offset":3880},"end":{"line":58,"column":105,"offset":3984},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3880},"end":{"line":58,"column":105,"offset":3984},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":60,"column":1,"offset":3986},"end":{"line":60,"column":45,"offset":4030},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":3986},"end":{"line":60,"column":45,"offset":4030},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":62,"column":3,"offset":4034},"end":{"line":62,"column":380,"offset":4411},"indent":[]}}],"position":{"start":{"line":62,"column":3,"offset":4034},"end":{"line":62,"column":380,"offset":4411},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4032},"end":{"line":63,"column":1,"offset":4412},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":64,"column":3,"offset":4415},"end":{"line":65,"column":49,"offset":4729},"indent":[2]}}],"position":{"start":{"line":64,"column":3,"offset":4415},"end":{"line":65,"column":49,"offset":4729},"indent":[2]}}],"position":{"start":{"line":64,"column":1,"offset":4413},"end":{"line":65,"column":49,"offset":4729},"indent":[1]}}],"position":{"start":{"line":62,"column":1,"offset":4032},"end":{"line":65,"column":49,"offset":4729},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":67,"column":5,"offset":4735},"end":{"line":67,"column":13,"offset":4743},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":4731},"end":{"line":67,"column":13,"offset":4743},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":69,"column":1,"offset":4745},"end":{"line":69,"column":156,"offset":4900},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":69,"column":156,"offset":4900},"end":{"line":69,"column":177,"offset":4921},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":69,"column":177,"offset":4921},"end":{"line":69,"column":188,"offset":4932},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":69,"column":188,"offset":4932},"end":{"line":69,"column":193,"offset":4937},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":69,"column":193,"offset":4937},"end":{"line":69,"column":379,"offset":5123},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4745},"end":{"line":69,"column":379,"offset":5123},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":71,"column":1,"offset":5125},"end":{"line":71,"column":68,"offset":5192},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":5125},"end":{"line":71,"column":68,"offset":5192},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":73,"column":4,"offset":5197},"end":{"line":73,"column":13,"offset":5206},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5194},"end":{"line":73,"column":13,"offset":5206},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":75,"column":1,"offset":5208},"end":{"line":75,"column":44,"offset":5251},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":75,"column":46,"offset":5253},"end":{"line":75,"column":68,"offset":5275},"indent":[]}}],"position":{"start":{"line":75,"column":44,"offset":5251},"end":{"line":75,"column":70,"offset":5277},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":75,"column":70,"offset":5277},"end":{"line":75,"column":106,"offset":5313},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":75,"column":108,"offset":5315},"end":{"line":75,"column":129,"offset":5336},"indent":[]}}],"position":{"start":{"line":75,"column":106,"offset":5313},"end":{"line":75,"column":131,"offset":5338},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":75,"column":131,"offset":5338},"end":{"line":75,"column":159,"offset":5366},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5208},"end":{"line":75,"column":159,"offset":5366},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":78,"column":1,"offset":5369},"end":{"line":78,"column":31,"offset":5399},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":78,"column":31,"offset":5399}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4e35da993dfe4d82571e4cedbd9a3f7f.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4e35da993dfe4d82571e4cedbd9a3f7f.json new file mode 100644 index 0000000..b476fa2 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4e35da993dfe4d82571e4cedbd9a3f7f.json @@ -0,0 +1 @@ +{"expireTime":9007200861828635000,"key":"gatsby-plugin-mdx-entire-payload-57e0809a80ffaa63f7e43239dd20f716-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":77,"offset":412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":78,"offset":413},"end":{"line":12,"column":92,"offset":427},"indent":[]}}],"position":{"start":{"line":12,"column":77,"offset":412},"end":{"line":12,"column":101,"offset":436},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers.","position":{"start":{"line":12,"column":101,"offset":436},"end":{"line":12,"column":166,"offset":501},"indent":[]}}],"position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":166,"offset":501},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":166,"offset":501},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"In addtionation to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage provider you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio.","position":{"start":{"line":13,"column":4,"offset":505},"end":{"line":13,"column":391,"offset":892},"indent":[]}}],"position":{"start":{"line":13,"column":4,"offset":505},"end":{"line":13,"column":391,"offset":892},"indent":[]}}],"position":{"start":{"line":13,"column":1,"offset":502},"end":{"line":13,"column":391,"offset":892},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":13,"column":391,"offset":892},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":15,"column":4,"offset":897},"end":{"line":15,"column":18,"offset":911},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":894},"end":{"line":15,"column":18,"offset":911},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":17,"column":1,"offset":913},"end":{"line":17,"column":291,"offset":1203},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":17,"column":292,"offset":1204},"end":{"line":17,"column":309,"offset":1221},"indent":[]}}],"position":{"start":{"line":17,"column":291,"offset":1203},"end":{"line":17,"column":318,"offset":1230},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":17,"column":318,"offset":1230},"end":{"line":17,"column":319,"offset":1231},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":913},"end":{"line":17,"column":319,"offset":1231},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":19,"column":1,"offset":1233},"end":{"line":19,"column":56,"offset":1288},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":1233},"end":{"line":19,"column":56,"offset":1288},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":21,"column":4,"offset":1293},"end":{"line":21,"column":20,"offset":1309},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1290},"end":{"line":21,"column":20,"offset":1309},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":23,"column":1,"offset":1311},"end":{"line":23,"column":253,"offset":1563},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1311},"end":{"line":23,"column":253,"offset":1563},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":25,"column":6,"offset":1570},"end":{"line":25,"column":35,"offset":1599},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1569},"end":{"line":25,"column":70,"offset":1634},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1569},"end":{"line":25,"column":70,"offset":1634},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1565},"end":{"line":25,"column":70,"offset":1634},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":26,"column":6,"offset":1640},"end":{"line":26,"column":29,"offset":1663},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1639},"end":{"line":26,"column":83,"offset":1717},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1639},"end":{"line":26,"column":83,"offset":1717},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1635},"end":{"line":26,"column":83,"offset":1717},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":27,"column":6,"offset":1723},"end":{"line":27,"column":28,"offset":1745},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1722},"end":{"line":27,"column":57,"offset":1774},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1722},"end":{"line":27,"column":57,"offset":1774},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1718},"end":{"line":27,"column":57,"offset":1774},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":28,"column":6,"offset":1780},"end":{"line":28,"column":11,"offset":1785},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":1779},"end":{"line":28,"column":29,"offset":1803},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":1779},"end":{"line":28,"column":29,"offset":1803},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1775},"end":{"line":28,"column":29,"offset":1803},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1565},"end":{"line":28,"column":29,"offset":1803},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":30,"column":1,"offset":1805},"end":{"line":30,"column":190,"offset":1994},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1805},"end":{"line":30,"column":190,"offset":1994},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":32,"column":1,"offset":1996},"end":{"line":32,"column":99,"offset":2094},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1996},"end":{"line":32,"column":99,"offset":2094},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":34,"column":1,"offset":2096},"end":{"line":34,"column":220,"offset":2315},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2096},"end":{"line":34,"column":220,"offset":2315},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":36,"column":1,"offset":2317},"end":{"line":36,"column":98,"offset":2414},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2317},"end":{"line":36,"column":98,"offset":2414},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":38,"column":5,"offset":2420},"end":{"line":38,"column":11,"offset":2426},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2416},"end":{"line":38,"column":11,"offset":2426},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":40,"column":1,"offset":2428},"end":{"line":40,"column":303,"offset":2730},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2428},"end":{"line":40,"column":303,"offset":2730},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":42,"column":6,"offset":2737},"end":{"line":42,"column":18,"offset":2749},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2736},"end":{"line":42,"column":46,"offset":2777},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2736},"end":{"line":42,"column":46,"offset":2777},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2732},"end":{"line":42,"column":46,"offset":2777},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":43,"column":6,"offset":2783},"end":{"line":43,"column":29,"offset":2806},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":2782},"end":{"line":43,"column":59,"offset":2836},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":2782},"end":{"line":43,"column":59,"offset":2836},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2778},"end":{"line":43,"column":59,"offset":2836},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2732},"end":{"line":43,"column":59,"offset":2836},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":45,"column":1,"offset":2838},"end":{"line":45,"column":368,"offset":3205},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2838},"end":{"line":45,"column":368,"offset":3205},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":47,"column":1,"offset":3207},"end":{"line":47,"column":66,"offset":3272},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3207},"end":{"line":47,"column":66,"offset":3272},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":49,"column":5,"offset":3278},"end":{"line":49,"column":21,"offset":3294},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3274},"end":{"line":49,"column":21,"offset":3294},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":51,"column":1,"offset":3296},"end":{"line":51,"column":237,"offset":3532},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":3296},"end":{"line":51,"column":237,"offset":3532},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":53,"column":1,"offset":3534},"end":{"line":53,"column":105,"offset":3638},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":3534},"end":{"line":53,"column":105,"offset":3638},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":55,"column":1,"offset":3640},"end":{"line":55,"column":45,"offset":3684},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":3640},"end":{"line":55,"column":45,"offset":3684},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":57,"column":3,"offset":3688},"end":{"line":57,"column":380,"offset":4065},"indent":[]}}],"position":{"start":{"line":57,"column":3,"offset":3688},"end":{"line":57,"column":380,"offset":4065},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":3686},"end":{"line":58,"column":1,"offset":4066},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":59,"column":3,"offset":4069},"end":{"line":60,"column":49,"offset":4383},"indent":[2]}}],"position":{"start":{"line":59,"column":3,"offset":4069},"end":{"line":60,"column":49,"offset":4383},"indent":[2]}}],"position":{"start":{"line":59,"column":1,"offset":4067},"end":{"line":60,"column":49,"offset":4383},"indent":[1]}}],"position":{"start":{"line":57,"column":1,"offset":3686},"end":{"line":60,"column":49,"offset":4383},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":62,"column":5,"offset":4389},"end":{"line":62,"column":13,"offset":4397},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4385},"end":{"line":62,"column":13,"offset":4397},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":64,"column":1,"offset":4399},"end":{"line":64,"column":156,"offset":4554},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":64,"column":156,"offset":4554},"end":{"line":64,"column":177,"offset":4575},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":64,"column":177,"offset":4575},"end":{"line":64,"column":188,"offset":4586},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":64,"column":188,"offset":4586},"end":{"line":64,"column":193,"offset":4591},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":64,"column":193,"offset":4591},"end":{"line":64,"column":379,"offset":4777},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4399},"end":{"line":64,"column":379,"offset":4777},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":66,"column":1,"offset":4779},"end":{"line":66,"column":68,"offset":4846},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":4779},"end":{"line":66,"column":68,"offset":4846},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":68,"column":4,"offset":4851},"end":{"line":68,"column":13,"offset":4860},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":4848},"end":{"line":68,"column":13,"offset":4860},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":70,"column":1,"offset":4862},"end":{"line":70,"column":44,"offset":4905},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":70,"column":46,"offset":4907},"end":{"line":70,"column":68,"offset":4929},"indent":[]}}],"position":{"start":{"line":70,"column":44,"offset":4905},"end":{"line":70,"column":70,"offset":4931},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":70,"column":70,"offset":4931},"end":{"line":70,"column":106,"offset":4967},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":70,"column":108,"offset":4969},"end":{"line":70,"column":129,"offset":4990},"indent":[]}}],"position":{"start":{"line":70,"column":106,"offset":4967},"end":{"line":70,"column":131,"offset":4992},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":70,"column":131,"offset":4992},"end":{"line":70,"column":159,"offset":5020},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":4862},"end":{"line":70,"column":159,"offset":5020},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":73,"column":1,"offset":5023},"end":{"line":73,"column":31,"offset":5053},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":73,"column":31,"offset":5053}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n
    \n
  1. {`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers.`}
    2. \n
  2. {`In addtionation to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage provider you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio.`}
    3. \n
\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4f78bd8f3be0ad1a1efe3d9849410fd4.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4f78bd8f3be0ad1a1efe3d9849410fd4.json index 46eef05..2794ed9 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4f78bd8f3be0ad1a1efe3d9849410fd4.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-4f78bd8f3be0ad1a1efe3d9849410fd4.json @@ -1 +1 @@ -{"expireTime":9007200861747672000,"key":"gatsby-plugin-mdx-entire-payload-a8cdd0dece4d8192cd59829ab77a4ff1-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":77,"offset":412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":78,"offset":413},"end":{"line":12,"column":92,"offset":427},"indent":[]}}],"position":{"start":{"line":12,"column":77,"offset":412},"end":{"line":12,"column":101,"offset":436},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":12,"column":101,"offset":436},"end":{"line":12,"column":102,"offset":437},"indent":[]}}],"position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":102,"offset":437},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":102,"offset":437},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"You have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage provider you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio.","position":{"start":{"line":13,"column":4,"offset":441},"end":{"line":13,"column":367,"offset":804},"indent":[]}}],"position":{"start":{"line":13,"column":4,"offset":441},"end":{"line":13,"column":367,"offset":804},"indent":[]}}],"position":{"start":{"line":13,"column":1,"offset":438},"end":{"line":13,"column":367,"offset":804},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":13,"column":367,"offset":804},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":15,"column":4,"offset":809},"end":{"line":15,"column":18,"offset":823},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":806},"end":{"line":15,"column":18,"offset":823},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":17,"column":1,"offset":825},"end":{"line":17,"column":291,"offset":1115},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":17,"column":292,"offset":1116},"end":{"line":17,"column":309,"offset":1133},"indent":[]}}],"position":{"start":{"line":17,"column":291,"offset":1115},"end":{"line":17,"column":318,"offset":1142},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":17,"column":318,"offset":1142},"end":{"line":17,"column":319,"offset":1143},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":825},"end":{"line":17,"column":319,"offset":1143},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":19,"column":1,"offset":1145},"end":{"line":19,"column":56,"offset":1200},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":1145},"end":{"line":19,"column":56,"offset":1200},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":21,"column":4,"offset":1205},"end":{"line":21,"column":20,"offset":1221},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1202},"end":{"line":21,"column":20,"offset":1221},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":23,"column":1,"offset":1223},"end":{"line":23,"column":253,"offset":1475},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1223},"end":{"line":23,"column":253,"offset":1475},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":25,"column":6,"offset":1482},"end":{"line":25,"column":35,"offset":1511},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1481},"end":{"line":25,"column":70,"offset":1546},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1481},"end":{"line":25,"column":70,"offset":1546},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1477},"end":{"line":25,"column":70,"offset":1546},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":26,"column":6,"offset":1552},"end":{"line":26,"column":29,"offset":1575},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1551},"end":{"line":26,"column":83,"offset":1629},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1551},"end":{"line":26,"column":83,"offset":1629},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1547},"end":{"line":26,"column":83,"offset":1629},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":27,"column":6,"offset":1635},"end":{"line":27,"column":28,"offset":1657},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1634},"end":{"line":27,"column":57,"offset":1686},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1634},"end":{"line":27,"column":57,"offset":1686},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1630},"end":{"line":27,"column":57,"offset":1686},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":28,"column":6,"offset":1692},"end":{"line":28,"column":11,"offset":1697},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":1691},"end":{"line":28,"column":29,"offset":1715},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":1691},"end":{"line":28,"column":29,"offset":1715},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1687},"end":{"line":28,"column":29,"offset":1715},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1477},"end":{"line":28,"column":29,"offset":1715},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":30,"column":1,"offset":1717},"end":{"line":30,"column":190,"offset":1906},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1717},"end":{"line":30,"column":190,"offset":1906},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":32,"column":1,"offset":1908},"end":{"line":32,"column":99,"offset":2006},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1908},"end":{"line":32,"column":99,"offset":2006},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":34,"column":1,"offset":2008},"end":{"line":34,"column":220,"offset":2227},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2008},"end":{"line":34,"column":220,"offset":2227},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":36,"column":1,"offset":2229},"end":{"line":36,"column":98,"offset":2326},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2229},"end":{"line":36,"column":98,"offset":2326},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":38,"column":5,"offset":2332},"end":{"line":38,"column":11,"offset":2338},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2328},"end":{"line":38,"column":11,"offset":2338},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":40,"column":1,"offset":2340},"end":{"line":40,"column":303,"offset":2642},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2340},"end":{"line":40,"column":303,"offset":2642},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":42,"column":6,"offset":2649},"end":{"line":42,"column":18,"offset":2661},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2648},"end":{"line":42,"column":46,"offset":2689},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2648},"end":{"line":42,"column":46,"offset":2689},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2644},"end":{"line":42,"column":46,"offset":2689},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":43,"column":6,"offset":2695},"end":{"line":43,"column":29,"offset":2718},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":2694},"end":{"line":43,"column":59,"offset":2748},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":2694},"end":{"line":43,"column":59,"offset":2748},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2690},"end":{"line":43,"column":59,"offset":2748},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2644},"end":{"line":43,"column":59,"offset":2748},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":45,"column":1,"offset":2750},"end":{"line":45,"column":368,"offset":3117},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2750},"end":{"line":45,"column":368,"offset":3117},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":47,"column":1,"offset":3119},"end":{"line":47,"column":66,"offset":3184},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3119},"end":{"line":47,"column":66,"offset":3184},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":49,"column":5,"offset":3190},"end":{"line":49,"column":21,"offset":3206},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3186},"end":{"line":49,"column":21,"offset":3206},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":51,"column":1,"offset":3208},"end":{"line":51,"column":237,"offset":3444},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":3208},"end":{"line":51,"column":237,"offset":3444},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":53,"column":1,"offset":3446},"end":{"line":53,"column":105,"offset":3550},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":3446},"end":{"line":53,"column":105,"offset":3550},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":55,"column":1,"offset":3552},"end":{"line":55,"column":45,"offset":3596},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":3552},"end":{"line":55,"column":45,"offset":3596},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":57,"column":3,"offset":3600},"end":{"line":57,"column":380,"offset":3977},"indent":[]}}],"position":{"start":{"line":57,"column":3,"offset":3600},"end":{"line":57,"column":380,"offset":3977},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":3598},"end":{"line":58,"column":1,"offset":3978},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":59,"column":3,"offset":3981},"end":{"line":60,"column":49,"offset":4295},"indent":[2]}}],"position":{"start":{"line":59,"column":3,"offset":3981},"end":{"line":60,"column":49,"offset":4295},"indent":[2]}}],"position":{"start":{"line":59,"column":1,"offset":3979},"end":{"line":60,"column":49,"offset":4295},"indent":[1]}}],"position":{"start":{"line":57,"column":1,"offset":3598},"end":{"line":60,"column":49,"offset":4295},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":62,"column":5,"offset":4301},"end":{"line":62,"column":13,"offset":4309},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4297},"end":{"line":62,"column":13,"offset":4309},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":64,"column":1,"offset":4311},"end":{"line":64,"column":156,"offset":4466},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":64,"column":156,"offset":4466},"end":{"line":64,"column":177,"offset":4487},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":64,"column":177,"offset":4487},"end":{"line":64,"column":188,"offset":4498},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":64,"column":188,"offset":4498},"end":{"line":64,"column":193,"offset":4503},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":64,"column":193,"offset":4503},"end":{"line":64,"column":379,"offset":4689},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4311},"end":{"line":64,"column":379,"offset":4689},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":66,"column":1,"offset":4691},"end":{"line":66,"column":68,"offset":4758},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":4691},"end":{"line":66,"column":68,"offset":4758},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":68,"column":4,"offset":4763},"end":{"line":68,"column":13,"offset":4772},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":4760},"end":{"line":68,"column":13,"offset":4772},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":70,"column":1,"offset":4774},"end":{"line":70,"column":44,"offset":4817},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":70,"column":46,"offset":4819},"end":{"line":70,"column":68,"offset":4841},"indent":[]}}],"position":{"start":{"line":70,"column":44,"offset":4817},"end":{"line":70,"column":70,"offset":4843},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":70,"column":70,"offset":4843},"end":{"line":70,"column":106,"offset":4879},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":70,"column":108,"offset":4881},"end":{"line":70,"column":129,"offset":4902},"indent":[]}}],"position":{"start":{"line":70,"column":106,"offset":4879},"end":{"line":70,"column":131,"offset":4904},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":70,"column":131,"offset":4904},"end":{"line":70,"column":159,"offset":4932},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":4774},"end":{"line":70,"column":159,"offset":4932},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":73,"column":1,"offset":4935},"end":{"line":73,"column":31,"offset":4965},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":73,"column":31,"offset":4965}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n
    \n
  1. {`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`.`}
    2. \n
  2. {`You have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage provider you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio.`}
    3. \n
\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750177000,"key":"gatsby-plugin-mdx-entire-payload-a8cdd0dece4d8192cd59829ab77a4ff1-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":77,"offset":412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":78,"offset":413},"end":{"line":12,"column":92,"offset":427},"indent":[]}}],"position":{"start":{"line":12,"column":77,"offset":412},"end":{"line":12,"column":101,"offset":436},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":12,"column":101,"offset":436},"end":{"line":12,"column":102,"offset":437},"indent":[]}}],"position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":102,"offset":437},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":102,"offset":437},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"You have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage provider you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio.","position":{"start":{"line":13,"column":4,"offset":441},"end":{"line":13,"column":367,"offset":804},"indent":[]}}],"position":{"start":{"line":13,"column":4,"offset":441},"end":{"line":13,"column":367,"offset":804},"indent":[]}}],"position":{"start":{"line":13,"column":1,"offset":438},"end":{"line":13,"column":367,"offset":804},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":13,"column":367,"offset":804},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":15,"column":4,"offset":809},"end":{"line":15,"column":18,"offset":823},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":806},"end":{"line":15,"column":18,"offset":823},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":17,"column":1,"offset":825},"end":{"line":17,"column":291,"offset":1115},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":17,"column":292,"offset":1116},"end":{"line":17,"column":309,"offset":1133},"indent":[]}}],"position":{"start":{"line":17,"column":291,"offset":1115},"end":{"line":17,"column":318,"offset":1142},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":17,"column":318,"offset":1142},"end":{"line":17,"column":319,"offset":1143},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":825},"end":{"line":17,"column":319,"offset":1143},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":19,"column":1,"offset":1145},"end":{"line":19,"column":56,"offset":1200},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":1145},"end":{"line":19,"column":56,"offset":1200},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":21,"column":4,"offset":1205},"end":{"line":21,"column":20,"offset":1221},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1202},"end":{"line":21,"column":20,"offset":1221},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":23,"column":1,"offset":1223},"end":{"line":23,"column":253,"offset":1475},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1223},"end":{"line":23,"column":253,"offset":1475},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":25,"column":6,"offset":1482},"end":{"line":25,"column":35,"offset":1511},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1481},"end":{"line":25,"column":70,"offset":1546},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1481},"end":{"line":25,"column":70,"offset":1546},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1477},"end":{"line":25,"column":70,"offset":1546},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":26,"column":6,"offset":1552},"end":{"line":26,"column":29,"offset":1575},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1551},"end":{"line":26,"column":83,"offset":1629},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1551},"end":{"line":26,"column":83,"offset":1629},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1547},"end":{"line":26,"column":83,"offset":1629},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":27,"column":6,"offset":1635},"end":{"line":27,"column":28,"offset":1657},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1634},"end":{"line":27,"column":57,"offset":1686},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1634},"end":{"line":27,"column":57,"offset":1686},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1630},"end":{"line":27,"column":57,"offset":1686},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":28,"column":6,"offset":1692},"end":{"line":28,"column":11,"offset":1697},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":1691},"end":{"line":28,"column":29,"offset":1715},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":1691},"end":{"line":28,"column":29,"offset":1715},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1687},"end":{"line":28,"column":29,"offset":1715},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1477},"end":{"line":28,"column":29,"offset":1715},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":30,"column":1,"offset":1717},"end":{"line":30,"column":190,"offset":1906},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1717},"end":{"line":30,"column":190,"offset":1906},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":32,"column":1,"offset":1908},"end":{"line":32,"column":99,"offset":2006},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1908},"end":{"line":32,"column":99,"offset":2006},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":34,"column":1,"offset":2008},"end":{"line":34,"column":220,"offset":2227},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2008},"end":{"line":34,"column":220,"offset":2227},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":36,"column":1,"offset":2229},"end":{"line":36,"column":98,"offset":2326},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2229},"end":{"line":36,"column":98,"offset":2326},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":38,"column":5,"offset":2332},"end":{"line":38,"column":11,"offset":2338},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2328},"end":{"line":38,"column":11,"offset":2338},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":40,"column":1,"offset":2340},"end":{"line":40,"column":303,"offset":2642},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2340},"end":{"line":40,"column":303,"offset":2642},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":42,"column":6,"offset":2649},"end":{"line":42,"column":18,"offset":2661},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2648},"end":{"line":42,"column":46,"offset":2689},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2648},"end":{"line":42,"column":46,"offset":2689},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2644},"end":{"line":42,"column":46,"offset":2689},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":43,"column":6,"offset":2695},"end":{"line":43,"column":29,"offset":2718},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":2694},"end":{"line":43,"column":59,"offset":2748},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":2694},"end":{"line":43,"column":59,"offset":2748},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2690},"end":{"line":43,"column":59,"offset":2748},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2644},"end":{"line":43,"column":59,"offset":2748},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":45,"column":1,"offset":2750},"end":{"line":45,"column":368,"offset":3117},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2750},"end":{"line":45,"column":368,"offset":3117},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":47,"column":1,"offset":3119},"end":{"line":47,"column":66,"offset":3184},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3119},"end":{"line":47,"column":66,"offset":3184},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":49,"column":5,"offset":3190},"end":{"line":49,"column":21,"offset":3206},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3186},"end":{"line":49,"column":21,"offset":3206},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":51,"column":1,"offset":3208},"end":{"line":51,"column":237,"offset":3444},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":3208},"end":{"line":51,"column":237,"offset":3444},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":53,"column":1,"offset":3446},"end":{"line":53,"column":105,"offset":3550},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":3446},"end":{"line":53,"column":105,"offset":3550},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":55,"column":1,"offset":3552},"end":{"line":55,"column":45,"offset":3596},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":3552},"end":{"line":55,"column":45,"offset":3596},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":57,"column":3,"offset":3600},"end":{"line":57,"column":380,"offset":3977},"indent":[]}}],"position":{"start":{"line":57,"column":3,"offset":3600},"end":{"line":57,"column":380,"offset":3977},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":3598},"end":{"line":58,"column":1,"offset":3978},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":59,"column":3,"offset":3981},"end":{"line":60,"column":49,"offset":4295},"indent":[2]}}],"position":{"start":{"line":59,"column":3,"offset":3981},"end":{"line":60,"column":49,"offset":4295},"indent":[2]}}],"position":{"start":{"line":59,"column":1,"offset":3979},"end":{"line":60,"column":49,"offset":4295},"indent":[1]}}],"position":{"start":{"line":57,"column":1,"offset":3598},"end":{"line":60,"column":49,"offset":4295},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":62,"column":5,"offset":4301},"end":{"line":62,"column":13,"offset":4309},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4297},"end":{"line":62,"column":13,"offset":4309},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":64,"column":1,"offset":4311},"end":{"line":64,"column":156,"offset":4466},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":64,"column":156,"offset":4466},"end":{"line":64,"column":177,"offset":4487},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":64,"column":177,"offset":4487},"end":{"line":64,"column":188,"offset":4498},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":64,"column":188,"offset":4498},"end":{"line":64,"column":193,"offset":4503},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":64,"column":193,"offset":4503},"end":{"line":64,"column":379,"offset":4689},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4311},"end":{"line":64,"column":379,"offset":4689},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":66,"column":1,"offset":4691},"end":{"line":66,"column":68,"offset":4758},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":4691},"end":{"line":66,"column":68,"offset":4758},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":68,"column":4,"offset":4763},"end":{"line":68,"column":13,"offset":4772},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":4760},"end":{"line":68,"column":13,"offset":4772},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":70,"column":1,"offset":4774},"end":{"line":70,"column":44,"offset":4817},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":70,"column":46,"offset":4819},"end":{"line":70,"column":68,"offset":4841},"indent":[]}}],"position":{"start":{"line":70,"column":44,"offset":4817},"end":{"line":70,"column":70,"offset":4843},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":70,"column":70,"offset":4843},"end":{"line":70,"column":106,"offset":4879},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":70,"column":108,"offset":4881},"end":{"line":70,"column":129,"offset":4902},"indent":[]}}],"position":{"start":{"line":70,"column":106,"offset":4879},"end":{"line":70,"column":131,"offset":4904},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":70,"column":131,"offset":4904},"end":{"line":70,"column":159,"offset":4932},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":4774},"end":{"line":70,"column":159,"offset":4932},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":73,"column":1,"offset":4935},"end":{"line":73,"column":31,"offset":4965},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":73,"column":31,"offset":4965}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n
    \n
  1. {`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`.`}
    2. \n
  2. {`You have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage provider you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio.`}
    3. \n
\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-512388045808244c258958dd03b23364.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-512388045808244c258958dd03b23364.json new file mode 100644 index 0000000..dbd5bbf --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-512388045808244c258958dd03b23364.json @@ -0,0 +1 @@ +{"expireTime":9007200861828607000,"key":"gatsby-plugin-mdx-entire-payload-1ba5985458e7ca613d889c8a5d27bc97-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":77,"offset":412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":78,"offset":413},"end":{"line":12,"column":92,"offset":427},"indent":[]}}],"position":{"start":{"line":12,"column":77,"offset":412},"end":{"line":12,"column":101,"offset":436},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":12,"column":101,"offset":436},"end":{"line":12,"column":102,"offset":437},"indent":[]}}],"position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":102,"offset":437},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":102,"offset":437},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"In addtionation to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage provider you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio.","position":{"start":{"line":13,"column":4,"offset":441},"end":{"line":13,"column":391,"offset":828},"indent":[]}}],"position":{"start":{"line":13,"column":4,"offset":441},"end":{"line":13,"column":391,"offset":828},"indent":[]}}],"position":{"start":{"line":13,"column":1,"offset":438},"end":{"line":13,"column":391,"offset":828},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":13,"column":391,"offset":828},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":15,"column":4,"offset":833},"end":{"line":15,"column":18,"offset":847},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":830},"end":{"line":15,"column":18,"offset":847},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":17,"column":1,"offset":849},"end":{"line":17,"column":291,"offset":1139},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":17,"column":292,"offset":1140},"end":{"line":17,"column":309,"offset":1157},"indent":[]}}],"position":{"start":{"line":17,"column":291,"offset":1139},"end":{"line":17,"column":318,"offset":1166},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":17,"column":318,"offset":1166},"end":{"line":17,"column":319,"offset":1167},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":849},"end":{"line":17,"column":319,"offset":1167},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":19,"column":1,"offset":1169},"end":{"line":19,"column":56,"offset":1224},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":1169},"end":{"line":19,"column":56,"offset":1224},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":21,"column":4,"offset":1229},"end":{"line":21,"column":20,"offset":1245},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1226},"end":{"line":21,"column":20,"offset":1245},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":23,"column":1,"offset":1247},"end":{"line":23,"column":253,"offset":1499},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1247},"end":{"line":23,"column":253,"offset":1499},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":25,"column":6,"offset":1506},"end":{"line":25,"column":35,"offset":1535},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1505},"end":{"line":25,"column":70,"offset":1570},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1505},"end":{"line":25,"column":70,"offset":1570},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1501},"end":{"line":25,"column":70,"offset":1570},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":26,"column":6,"offset":1576},"end":{"line":26,"column":29,"offset":1599},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1575},"end":{"line":26,"column":83,"offset":1653},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1575},"end":{"line":26,"column":83,"offset":1653},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1571},"end":{"line":26,"column":83,"offset":1653},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":27,"column":6,"offset":1659},"end":{"line":27,"column":28,"offset":1681},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1658},"end":{"line":27,"column":57,"offset":1710},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1658},"end":{"line":27,"column":57,"offset":1710},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1654},"end":{"line":27,"column":57,"offset":1710},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":28,"column":6,"offset":1716},"end":{"line":28,"column":11,"offset":1721},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":1715},"end":{"line":28,"column":29,"offset":1739},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":1715},"end":{"line":28,"column":29,"offset":1739},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1711},"end":{"line":28,"column":29,"offset":1739},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1501},"end":{"line":28,"column":29,"offset":1739},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":30,"column":1,"offset":1741},"end":{"line":30,"column":190,"offset":1930},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1741},"end":{"line":30,"column":190,"offset":1930},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":32,"column":1,"offset":1932},"end":{"line":32,"column":99,"offset":2030},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1932},"end":{"line":32,"column":99,"offset":2030},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":34,"column":1,"offset":2032},"end":{"line":34,"column":220,"offset":2251},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2032},"end":{"line":34,"column":220,"offset":2251},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":36,"column":1,"offset":2253},"end":{"line":36,"column":98,"offset":2350},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2253},"end":{"line":36,"column":98,"offset":2350},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":38,"column":5,"offset":2356},"end":{"line":38,"column":11,"offset":2362},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2352},"end":{"line":38,"column":11,"offset":2362},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":40,"column":1,"offset":2364},"end":{"line":40,"column":303,"offset":2666},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2364},"end":{"line":40,"column":303,"offset":2666},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":42,"column":6,"offset":2673},"end":{"line":42,"column":18,"offset":2685},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2672},"end":{"line":42,"column":46,"offset":2713},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2672},"end":{"line":42,"column":46,"offset":2713},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2668},"end":{"line":42,"column":46,"offset":2713},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":43,"column":6,"offset":2719},"end":{"line":43,"column":29,"offset":2742},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":2718},"end":{"line":43,"column":59,"offset":2772},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":2718},"end":{"line":43,"column":59,"offset":2772},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2714},"end":{"line":43,"column":59,"offset":2772},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2668},"end":{"line":43,"column":59,"offset":2772},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":45,"column":1,"offset":2774},"end":{"line":45,"column":368,"offset":3141},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2774},"end":{"line":45,"column":368,"offset":3141},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":47,"column":1,"offset":3143},"end":{"line":47,"column":66,"offset":3208},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3143},"end":{"line":47,"column":66,"offset":3208},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":49,"column":5,"offset":3214},"end":{"line":49,"column":21,"offset":3230},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3210},"end":{"line":49,"column":21,"offset":3230},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":51,"column":1,"offset":3232},"end":{"line":51,"column":237,"offset":3468},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":3232},"end":{"line":51,"column":237,"offset":3468},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":53,"column":1,"offset":3470},"end":{"line":53,"column":105,"offset":3574},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":3470},"end":{"line":53,"column":105,"offset":3574},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":55,"column":1,"offset":3576},"end":{"line":55,"column":45,"offset":3620},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":3576},"end":{"line":55,"column":45,"offset":3620},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":57,"column":3,"offset":3624},"end":{"line":57,"column":380,"offset":4001},"indent":[]}}],"position":{"start":{"line":57,"column":3,"offset":3624},"end":{"line":57,"column":380,"offset":4001},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":3622},"end":{"line":58,"column":1,"offset":4002},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":59,"column":3,"offset":4005},"end":{"line":60,"column":49,"offset":4319},"indent":[2]}}],"position":{"start":{"line":59,"column":3,"offset":4005},"end":{"line":60,"column":49,"offset":4319},"indent":[2]}}],"position":{"start":{"line":59,"column":1,"offset":4003},"end":{"line":60,"column":49,"offset":4319},"indent":[1]}}],"position":{"start":{"line":57,"column":1,"offset":3622},"end":{"line":60,"column":49,"offset":4319},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":62,"column":5,"offset":4325},"end":{"line":62,"column":13,"offset":4333},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4321},"end":{"line":62,"column":13,"offset":4333},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":64,"column":1,"offset":4335},"end":{"line":64,"column":156,"offset":4490},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":64,"column":156,"offset":4490},"end":{"line":64,"column":177,"offset":4511},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":64,"column":177,"offset":4511},"end":{"line":64,"column":188,"offset":4522},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":64,"column":188,"offset":4522},"end":{"line":64,"column":193,"offset":4527},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":64,"column":193,"offset":4527},"end":{"line":64,"column":379,"offset":4713},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4335},"end":{"line":64,"column":379,"offset":4713},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":66,"column":1,"offset":4715},"end":{"line":66,"column":68,"offset":4782},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":4715},"end":{"line":66,"column":68,"offset":4782},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":68,"column":4,"offset":4787},"end":{"line":68,"column":13,"offset":4796},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":4784},"end":{"line":68,"column":13,"offset":4796},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":70,"column":1,"offset":4798},"end":{"line":70,"column":44,"offset":4841},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":70,"column":46,"offset":4843},"end":{"line":70,"column":68,"offset":4865},"indent":[]}}],"position":{"start":{"line":70,"column":44,"offset":4841},"end":{"line":70,"column":70,"offset":4867},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":70,"column":70,"offset":4867},"end":{"line":70,"column":106,"offset":4903},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":70,"column":108,"offset":4905},"end":{"line":70,"column":129,"offset":4926},"indent":[]}}],"position":{"start":{"line":70,"column":106,"offset":4903},"end":{"line":70,"column":131,"offset":4928},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":70,"column":131,"offset":4928},"end":{"line":70,"column":159,"offset":4956},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":4798},"end":{"line":70,"column":159,"offset":4956},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":73,"column":1,"offset":4959},"end":{"line":73,"column":31,"offset":4989},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":73,"column":31,"offset":4989}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n
    \n
  1. {`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`.`}
    2. \n
  2. {`In addtionation to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage provider you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio.`}
    3. \n
\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-594c74fa5edd2639028f93b858c4affe.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-594c74fa5edd2639028f93b858c4affe.json new file mode 100644 index 0000000..c40f577 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-594c74fa5edd2639028f93b858c4affe.json @@ -0,0 +1 @@ +{"expireTime":9007200861824351000,"key":"gatsby-plugin-mdx-entire-payload-5059c73d3aa6f69e38b6ccb17a1b9989-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import SettingsIcon from '@material-ui/icons/Settings';","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":56,"offset":214},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Get Started","position":{"start":{"line":10,"column":3,"offset":218},"end":{"line":10,"column":14,"offset":229},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":216},"end":{"line":10,"column":14,"offset":229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.","position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known ","position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":169,"offset":679},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":14,"column":169,"offset":679},"end":{"line":14,"column":178,"offset":688},"indent":[]}},{"type":"text","value":" command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.","position":{"start":{"line":14,"column":178,"offset":688},"end":{"line":14,"column":314,"offset":824},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":314,"offset":824},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":16,"column":1,"offset":826},"end":{"line":18,"column":11,"offset":1028},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Login page","position":{"start":{"line":20,"column":4,"offset":1033},"end":{"line":20,"column":14,"offset":1043},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1030},"end":{"line":20,"column":14,"offset":1043},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.","position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/login.gif","alt":"Factory","position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The default username password of the Factory web applications is:","position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"username: ","position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":13,"offset":1310},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":28,"column":15,"offset":1312},"end":{"line":28,"column":19,"offset":1316},"indent":[]}}],"position":{"start":{"line":28,"column":13,"offset":1310},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":28,"column":21,"offset":1318},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"password: ","position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":13,"offset":1331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"kerberos","position":{"start":{"line":29,"column":15,"offset":1333},"end":{"line":29,"column":23,"offset":1341},"indent":[]}}],"position":{"start":{"line":29,"column":13,"offset":1331},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1319},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":29,"column":25,"offset":1343},"indent":[1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"The username and password ","position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":29,"offset":1373},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/enterprise/blob/master/yaml/factory/deployment.yaml#L54","children":[{"type":"text","value":"can be changed in the ","position":{"start":{"line":31,"column":30,"offset":1374},"end":{"line":31,"column":52,"offset":1396},"indent":[]}},{"type":"inlineCode","value":"deploment.yaml","position":{"start":{"line":31,"column":52,"offset":1396},"end":{"line":31,"column":68,"offset":1412},"indent":[]}},{"type":"text","value":" file","position":{"start":{"line":31,"column":68,"offset":1412},"end":{"line":31,"column":73,"offset":1417},"indent":[]}}],"position":{"start":{"line":31,"column":29,"offset":1373},"end":{"line":31,"column":162,"offset":1506},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":162,"offset":1506},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1345},"end":{"line":31,"column":163,"offset":1507},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Overview","position":{"start":{"line":33,"column":4,"offset":1512},"end":{"line":33,"column":12,"offset":1520},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1509},"end":{"line":33,"column":12,"offset":1520},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: ","position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":146,"offset":1667},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Docker","position":{"start":{"line":35,"column":148,"offset":1669},"end":{"line":35,"column":154,"offset":1675},"indent":[]}}],"position":{"start":{"line":35,"column":146,"offset":1667},"end":{"line":35,"column":156,"offset":1677},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":35,"column":156,"offset":1677},"end":{"line":35,"column":161,"offset":1682},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":35,"column":163,"offset":1684},"end":{"line":35,"column":173,"offset":1694},"indent":[]}}],"position":{"start":{"line":35,"column":161,"offset":1682},"end":{"line":35,"column":175,"offset":1696},"indent":[]}},{"type":"text","value":". Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.","position":{"start":{"line":35,"column":175,"offset":1696},"end":{"line":35,"column":317,"offset":1838},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":317,"offset":1838},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.","position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/docker-Kubernetes.gif","alt":"Factory","position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":41,"column":4,"offset":2094},"end":{"line":41,"column":14,"offset":2104},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2091},"end":{"line":41,"column":14,"offset":2104},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:","position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Nodes: a list of all the nodes in your cluster.","position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":45,"column":50,"offset":2255},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Deployments: a list of all the Kerberos Enterprise agents running in your cluster.","position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":2256},"end":{"line":46,"column":85,"offset":2340},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pods: all the pods running in your cluster.","position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2341},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":47,"column":46,"offset":2386},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Nodes","position":{"start":{"line":49,"column":4,"offset":2391},"end":{"line":49,"column":9,"offset":2396},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":2388},"end":{"line":49,"column":9,"offset":2396},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.","position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-nodes.png","alt":"Factory","position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Deployments","position":{"start":{"line":55,"column":4,"offset":2700},"end":{"line":55,"column":15,"offset":2711},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2697},"end":{"line":55,"column":15,"offset":2711},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.","position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-deployments.png","alt":"Factory","position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Adding a new deployment","position":{"start":{"line":61,"column":5,"offset":3201},"end":{"line":61,"column":28,"offset":3224},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3197},"end":{"line":61,"column":28,"offset":3224},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"There are two options to add a new deployment, single deployments and bulk deployment.","position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/single-bulk-deployment.gif","alt":"Factory","position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"single deployment","position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.","position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"in bulk deployment.","position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By importing an Excel file, deployments can be created in bulk.","position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.","position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-add-bulk-deployment-excel.png","alt":"Factory","position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Configuring a deployment","position":{"start":{"line":79,"column":5,"offset":3855},"end":{"line":79,"column":29,"offset":3879},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3851},"end":{"line":79,"column":29,"offset":3879},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the ","position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":200,"offset":4080},"indent":[]}},{"type":"jsx","value":"","position":{"start":{"line":81,"column":200,"offset":4080},"end":{"line":81,"column":235,"offset":4115},"indent":[]}},{"type":"text","value":" icon. This will open a popup, allowing you to change some settings.","position":{"start":{"line":81,"column":235,"offset":4115},"end":{"line":81,"column":303,"offset":4183},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":303,"offset":4183},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/deployment-configuration.gif","alt":"Factory","position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Following settings can be changed:","position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more regions of interest,","position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":87,"column":35,"offset":4325},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Time based conditions,","position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":4326},"end":{"line":88,"column":25,"offset":4350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pre- and postrecording","position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4351},"end":{"line":89,"column":25,"offset":4375},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording","position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4376},"end":{"line":90,"column":23,"offset":4398},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Linking to ","position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":14,"offset":4412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":91,"column":15,"offset":4413},"end":{"line":91,"column":29,"offset":4427},"indent":[]}}],"position":{"start":{"line":91,"column":14,"offset":4412},"end":{"line":91,"column":38,"offset":4436},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":91,"column":38,"offset":4436},"end":{"line":91,"column":42,"offset":4440},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":91,"column":43,"offset":4441},"end":{"line":91,"column":59,"offset":4457},"indent":[]}}],"position":{"start":{"line":91,"column":42,"offset":4440},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4399},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":91,"column":83,"offset":4481},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Global configuration","position":{"start":{"line":93,"column":5,"offset":4487},"end":{"line":93,"column":25,"offset":4507},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4483},"end":{"line":93,"column":25,"offset":4507},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.","position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.","position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/global-configuration.gif","alt":"Factory Global Config","position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Upgrade or reboot a Kerberos Enterprise agent","position":{"start":{"line":101,"column":5,"offset":5046},"end":{"line":101,"column":50,"offset":5091},"indent":[]}}],"position":{"start":{"line":101,"column":1,"offset":5042},"end":{"line":101,"column":50,"offset":5091},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, ","position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":373,"offset":5465},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"a zero downtime upgrade will take place","position":{"start":{"line":103,"column":375,"offset":5467},"end":{"line":103,"column":414,"offset":5506},"indent":[]}}],"position":{"start":{"line":103,"column":373,"offset":5465},"end":{"line":103,"column":416,"offset":5508},"indent":[]}},{"type":"text","value":". Kubernetes will download the new release, create a new pod, and destroy the old one.","position":{"start":{"line":103,"column":416,"offset":5508},"end":{"line":103,"column":502,"offset":5594},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":502,"offset":5594},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.","position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}}],"position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/upgrade-reboot.gif","alt":"Upgrade and reboot","position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}}],"position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Pods","position":{"start":{"line":110,"column":4,"offset":5965},"end":{"line":110,"column":8,"offset":5969},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":5962},"end":{"line":110,"column":8,"offset":5969},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.","position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-pods.png","alt":"Factory","position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage and video management","position":{"start":{"line":117,"column":4,"offset":6482},"end":{"line":117,"column":32,"offset":6510},"indent":[]}}],"position":{"start":{"line":117,"column":1,"offset":6479},"end":{"line":117,"column":32,"offset":6510},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).","position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also ","position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":169,"offset":7035},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":121,"column":171,"offset":7037},"end":{"line":121,"column":179,"offset":7045},"indent":[]}}],"position":{"start":{"line":121,"column":169,"offset":7035},"end":{"line":121,"column":181,"offset":7047},"indent":[]}},{"type":"text","value":" have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed ","position":{"start":{"line":121,"column":181,"offset":7047},"end":{"line":121,"column":419,"offset":7285},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":121,"column":420,"offset":7286},"end":{"line":121,"column":436,"offset":7302},"indent":[]}}],"position":{"start":{"line":121,"column":419,"offset":7285},"end":{"line":121,"column":460,"offset":7326},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":121,"column":460,"offset":7326},"end":{"line":121,"column":465,"offset":7331},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":121,"column":466,"offset":7332},"end":{"line":121,"column":480,"offset":7346},"indent":[]}}],"position":{"start":{"line":121,"column":465,"offset":7331},"end":{"line":121,"column":489,"offset":7355},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":121,"column":489,"offset":7355},"end":{"line":121,"column":490,"offset":7356},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":490,"offset":7356},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":123,"column":5,"offset":7362},"end":{"line":123,"column":21,"offset":7378},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":7358},"end":{"line":123,"column":21,"offset":7378},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":125,"column":2,"offset":7381},"end":{"line":125,"column":18,"offset":7397},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":42,"offset":7421},"indent":[]}},{"type":"text","value":" is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).","position":{"start":{"line":125,"column":42,"offset":7421},"end":{"line":125,"column":328,"offset":7707},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":328,"offset":7707},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).","position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}}],"position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the ","position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":147,"offset":8189},"indent":[]}},{"type":"inlineCode","value":"cloud","position":{"start":{"line":131,"column":147,"offset":8189},"end":{"line":131,"column":154,"offset":8196},"indent":[]}},{"type":"text","value":" tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.","position":{"start":{"line":131,"column":154,"offset":8196},"end":{"line":131,"column":245,"offset":8287},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":245,"offset":8287},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-enterprise-storage-setup.gif","alt":"kerberos storage configuration","position":{"start":{"line":134,"column":1,"offset":8290},"end":{"line":134,"column":101,"offset":8390},"indent":[]}}],"position":{"start":{"line":134,"column":1,"offset":8290},"end":{"line":134,"column":101,"offset":8390},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":136,"column":5,"offset":8396},"end":{"line":136,"column":19,"offset":8410},"indent":[]}}],"position":{"start":{"line":136,"column":1,"offset":8392},"end":{"line":136,"column":19,"offset":8410},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more ","position":{"start":{"line":138,"column":1,"offset":8412},"end":{"line":138,"column":219,"offset":8630},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"about the features and functions here","position":{"start":{"line":138,"column":220,"offset":8631},"end":{"line":138,"column":257,"offset":8668},"indent":[]}}],"position":{"start":{"line":138,"column":219,"offset":8630},"end":{"line":138,"column":266,"offset":8677},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":138,"column":266,"offset":8677},"end":{"line":138,"column":267,"offset":8678},"indent":[]}}],"position":{"start":{"line":138,"column":1,"offset":8412},"end":{"line":138,"column":267,"offset":8678},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the ","position":{"start":{"line":140,"column":1,"offset":8680},"end":{"line":140,"column":285,"offset":8964},"indent":[]}},{"type":"link","title":null,"url":"/storage/get-started","children":[{"type":"text","value":"Kerberos Storage page","position":{"start":{"line":140,"column":286,"offset":8965},"end":{"line":140,"column":307,"offset":8986},"indent":[]}}],"position":{"start":{"line":140,"column":285,"offset":8964},"end":{"line":140,"column":330,"offset":9009},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":140,"column":330,"offset":9009},"end":{"line":140,"column":331,"offset":9010},"indent":[]}}],"position":{"start":{"line":140,"column":1,"offset":8680},"end":{"line":140,"column":331,"offset":9010},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.","position":{"start":{"line":142,"column":1,"offset":9012},"end":{"line":142,"column":104,"offset":9115},"indent":[]}}],"position":{"start":{"line":142,"column":1,"offset":9012},"end":{"line":142,"column":104,"offset":9115},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-enterprise-to-cloud.gif","alt":"kerberos storage configuration","position":{"start":{"line":144,"column":1,"offset":9117},"end":{"line":144,"column":96,"offset":9212},"indent":[]}}],"position":{"start":{"line":144,"column":1,"offset":9117},"end":{"line":144,"column":96,"offset":9212},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":147,"column":1,"offset":9215},"end":{"line":147,"column":31,"offset":9245},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":147,"column":31,"offset":9245}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport SettingsIcon from '@material-ui/icons/Settings';\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Get Started`}

\n

{`Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.`}

\n

{`Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known `}{`kubectl`}{` command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.`}

\n
\n
\n

\n

{`Login page`}

\n

{`Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.`}

\n

\"Factory\"

\n

{`The default username password of the Factory web applications is:`}

\n
    \n
  • {`username: `}{`root`}
    • \n
  • {`password: `}{`kerberos`}
    • \n
\n
\n

{`The username and password `}{`can be changed in the `}{`deploment.yaml`}{` file`}{`.`}

\n
\n

{`Overview`}

\n

{`On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: `}{`Docker`}{` and `}{`Kubernetes`}{`. Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.`}

\n

{`When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.`}

\n

\"Factory\"

\n

{`Kubernetes`}

\n

{`On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:`}

\n
    \n
  • {`Nodes: a list of all the nodes in your cluster.`}
    • \n
  • {`Deployments: a list of all the Kerberos Enterprise agents running in your cluster.`}
    • \n
  • {`Pods: all the pods running in your cluster.`}
    • \n
\n

{`Nodes`}

\n

{`The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.`}

\n

\"Factory\"

\n

{`Deployments`}

\n

{`The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.`}

\n

\"Factory\"

\n

{`Adding a new deployment`}

\n

{`There are two options to add a new deployment, single deployments and bulk deployment.`}

\n

\"Factory\"

\n
    \n
  • {`single deployment`}
    • \n
\n

{`By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.`}

\n
    \n
  • {`in bulk deployment.`}
    • \n
\n

{`By importing an Excel file, deployments can be created in bulk.`}

\n

{`By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.`}

\n

\"Factory\"

\n

{`Configuring a deployment`}

\n

{`Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the `}{` icon. This will open a popup, allowing you to change some settings.`}

\n

\"Factory\"

\n

{`Following settings can be changed:`}

\n
    \n
  • {`One or more regions of interest,`}
    • \n
  • {`Time based conditions,`}
    • \n
  • {`Pre- and postrecording`}
    • \n
  • {`Continious recording`}
    • \n
  • {`Linking to `}{`Kerberos Cloud`}{` or `}{`Kerberos Storage`}
    • \n
\n

{`Global configuration`}

\n

{`Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.`}

\n

{`By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.`}

\n

\"Factory

\n

{`Upgrade or reboot a Kerberos Enterprise agent`}

\n

{`At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, `}{`a zero downtime upgrade will take place`}{`. Kubernetes will download the new release, create a new pod, and destroy the old one.`}

\n

{`At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.`}

\n

\"Upgrade

\n

{`Pods`}

\n

{`When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.`}

\n

\"Factory\"

\n

{`Storage and video management`}

\n

{`Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).`}

\n

{`Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also `}{`does not`}{` have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed `}{`Kerberos Storage`}{` and `}{`Kerberos Cloud`}{`.`}

\n

{`Kerberos Storage`}

\n

{`Kerberos Storage`}{` is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).`}

\n

{`On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).`}

\n

\"architecture

\n

{`To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the `}{`cloud`}{` tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.`}

\n

\"kerberos

\n

{`Kerberos Cloud`}

\n

{`For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more `}{`about the features and functions here`}{`.`}

\n

{`You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the `}{`Kerberos Storage page`}{`.`}

\n

{`Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.`}

\n

\"kerberos

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-5a57eb4101c9007e9387ba00ab867772.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-5a57eb4101c9007e9387ba00ab867772.json index 0f62cb1..55e31a5 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-5a57eb4101c9007e9387ba00ab867772.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-5a57eb4101c9007e9387ba00ab867772.json @@ -1 +1 @@ -{"expireTime":9007200861747672000,"key":"gatsby-plugin-mdx-entire-payload-5cf498afa1501fdf3aa6aefe82058b8b-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Just like Kerberos Enterprise, Kerberos Storage can be installed where Kubernetes can be installed. This means that it can run at the Edge - Baremetal -, in the cloud - VMs - or at Kubernetes service providers - SAAS - such as GCP, Azure, AWS, DigitalOcean, and the list goes on.","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":280,"offset":514},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":280,"offset":514},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Although you might except Kubernetes at the Edge or Kubernetes in the cloud, there are no differences, well sorry to say there are. As Kubernetes service providers implemented features such as LoadBalancers, Persistent Volumes, and others, they have automated and integrated a huge portion of the Kubernetes stack with their related PAAS services. To be more concrete if you are running a Kubernetes Cluster on GCP, you will use the LoadBalancing and Storage services from GCP.","position":{"start":{"line":14,"column":1,"offset":516},"end":{"line":14,"column":478,"offset":993},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":516},"end":{"line":14,"column":478,"offset":993},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-enterprise-kubernetes.png","alt":"enterprise kubernetes","position":{"start":{"line":16,"column":1,"offset":995},"end":{"line":16,"column":81,"offset":1075},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":995},"end":{"line":16,"column":81,"offset":1075},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Compared to Kubernetes at the Edge, there are no predefined LoadBalancers, Storage capabilities, and more. This means more administration work for you, but - with great power comes great responsibility - so no worries. In the end there are alternative functionalties available, for features which you find out-of-the-box at the Kubernetes service providers, you just have to spend more time on configuring and installing those services/pods/deployments yourself.","position":{"start":{"line":18,"column":1,"offset":1077},"end":{"line":18,"column":463,"offset":1539},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1077},"end":{"line":18,"column":463,"offset":1539},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Installation on a Kubernetes Service Provider","position":{"start":{"line":20,"column":4,"offset":1544},"end":{"line":20,"column":49,"offset":1589},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1541},"end":{"line":20,"column":49,"offset":1589},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Installing Kerberos Storage, just like Kerberos Enterprise, on a Kubernetes Service Provider (Azure, GCP, AWS) is straight forward, as you can create a Kubernetes cluster in a few clicks, get access to public Load Balancers, storage and more. Running Kerberos Storage in such a cluster is just a matter of copy-pasting some configuration (yaml) files, and executing some ","position":{"start":{"line":22,"column":1,"offset":1591},"end":{"line":22,"column":372,"offset":1962},"indent":[]}},{"type":"inlineCode","value":"kubectl apply","position":{"start":{"line":22,"column":372,"offset":1962},"end":{"line":22,"column":387,"offset":1977},"indent":[]}},{"type":"text","value":" commands.","position":{"start":{"line":22,"column":387,"offset":1977},"end":{"line":22,"column":397,"offset":1987},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1591},"end":{"line":22,"column":397,"offset":1987},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":24,"column":1,"offset":1989},"end":{"line":24,"column":99,"offset":2087},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1989},"end":{"line":24,"column":99,"offset":2087},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Install Kerberos Storage on a Kubernetes Service Provider by ","position":{"start":{"line":26,"column":1,"offset":2089},"end":{"line":26,"column":62,"offset":2150},"indent":[]}},{"type":"link","title":null,"url":"/storage/installation-cloud","children":[{"type":"text","value":"following this step-by-step installation guide","position":{"start":{"line":26,"column":63,"offset":2151},"end":{"line":26,"column":109,"offset":2197},"indent":[]}}],"position":{"start":{"line":26,"column":62,"offset":2150},"end":{"line":26,"column":139,"offset":2227},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":26,"column":139,"offset":2227},"end":{"line":26,"column":140,"offset":2228},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":2089},"end":{"line":26,"column":140,"offset":2228},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Installation in Private Cloud or Baremetal","position":{"start":{"line":28,"column":4,"offset":2233},"end":{"line":28,"column":46,"offset":2275},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":2230},"end":{"line":28,"column":46,"offset":2275},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"No need to install Kerberos Storage on a Kubernetes Service Provider, you could install it on your own Kubernetes cluster in your private cloud, or even better inside your own premise. The closer you bring Kerberos Storage to your surveillance infrastructure, and Kerberos Enterprise, the more benefits you will experience (low latency, low bandwidth, etc).","position":{"start":{"line":30,"column":1,"offset":2277},"end":{"line":30,"column":358,"offset":2634},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2277},"end":{"line":30,"column":358,"offset":2634},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":32,"column":1,"offset":2636},"end":{"line":32,"column":98,"offset":2733},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2636},"end":{"line":32,"column":98,"offset":2733},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In contradiction to the Kubernetes Service Provider, you will have some work todo. Setting up Kubernetes Cluster, play with MetalLB, Persistent Volumes and claims. Don't be scared, it's pretty ssttraight forward as well. You can't simple expect a: click, click, 💥 approach.","position":{"start":{"line":34,"column":1,"offset":2735},"end":{"line":34,"column":275,"offset":3009},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2735},"end":{"line":34,"column":275,"offset":3009},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Install Kerberos Storage on a Private cloud or Baremetal by ","position":{"start":{"line":36,"column":1,"offset":3011},"end":{"line":36,"column":61,"offset":3071},"indent":[]}},{"type":"link","title":null,"url":"/storage/installation-edge","children":[{"type":"text","value":"following this step-by-step installation guide","position":{"start":{"line":36,"column":62,"offset":3072},"end":{"line":36,"column":108,"offset":3118},"indent":[]}}],"position":{"start":{"line":36,"column":61,"offset":3071},"end":{"line":36,"column":137,"offset":3147},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":36,"column":137,"offset":3147},"end":{"line":36,"column":138,"offset":3148},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":3011},"end":{"line":36,"column":138,"offset":3148},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":39,"column":1,"offset":3151},"end":{"line":39,"column":31,"offset":3181},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":39,"column":31,"offset":3181}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Installation`}

\n

{`Just like Kerberos Enterprise, Kerberos Storage can be installed where Kubernetes can be installed. This means that it can run at the Edge - Baremetal -, in the cloud - VMs - or at Kubernetes service providers - SAAS - such as GCP, Azure, AWS, DigitalOcean, and the list goes on.`}

\n

{`Although you might except Kubernetes at the Edge or Kubernetes in the cloud, there are no differences, well sorry to say there are. As Kubernetes service providers implemented features such as LoadBalancers, Persistent Volumes, and others, they have automated and integrated a huge portion of the Kubernetes stack with their related PAAS services. To be more concrete if you are running a Kubernetes Cluster on GCP, you will use the LoadBalancing and Storage services from GCP.`}

\n

\"enterprise

\n

{`Compared to Kubernetes at the Edge, there are no predefined LoadBalancers, Storage capabilities, and more. This means more administration work for you, but - with great power comes great responsibility - so no worries. In the end there are alternative functionalties available, for features which you find out-of-the-box at the Kubernetes service providers, you just have to spend more time on configuring and installing those services/pods/deployments yourself.`}

\n

{`Installation on a Kubernetes Service Provider`}

\n

{`Installing Kerberos Storage, just like Kerberos Enterprise, on a Kubernetes Service Provider (Azure, GCP, AWS) is straight forward, as you can create a Kubernetes cluster in a few clicks, get access to public Load Balancers, storage and more. Running Kerberos Storage in such a cluster is just a matter of copy-pasting some configuration (yaml) files, and executing some `}{`kubectl apply`}{` commands.`}

\n

\"architecture

\n

{`Install Kerberos Storage on a Kubernetes Service Provider by `}{`following this step-by-step installation guide`}{`.`}

\n

{`Installation in Private Cloud or Baremetal`}

\n

{`No need to install Kerberos Storage on a Kubernetes Service Provider, you could install it on your own Kubernetes cluster in your private cloud, or even better inside your own premise. The closer you bring Kerberos Storage to your surveillance infrastructure, and Kerberos Enterprise, the more benefits you will experience (low latency, low bandwidth, etc).`}

\n

\"architecture

\n

{`In contradiction to the Kubernetes Service Provider, you will have some work todo. Setting up Kubernetes Cluster, play with MetalLB, Persistent Volumes and claims. Don't be scared, it's pretty ssttraight forward as well. You can't simple expect a: click, click, 💥 approach.`}

\n

{`Install Kerberos Storage on a Private cloud or Baremetal by `}{`following this step-by-step installation guide`}{`.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750177000,"key":"gatsby-plugin-mdx-entire-payload-5cf498afa1501fdf3aa6aefe82058b8b-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Just like Kerberos Enterprise, Kerberos Storage can be installed where Kubernetes can be installed. This means that it can run at the Edge - Baremetal -, in the cloud - VMs - or at Kubernetes service providers - SAAS - such as GCP, Azure, AWS, DigitalOcean, and the list goes on.","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":280,"offset":514},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":280,"offset":514},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Although you might except Kubernetes at the Edge or Kubernetes in the cloud, there are no differences, well sorry to say there are. As Kubernetes service providers implemented features such as LoadBalancers, Persistent Volumes, and others, they have automated and integrated a huge portion of the Kubernetes stack with their related PAAS services. To be more concrete if you are running a Kubernetes Cluster on GCP, you will use the LoadBalancing and Storage services from GCP.","position":{"start":{"line":14,"column":1,"offset":516},"end":{"line":14,"column":478,"offset":993},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":516},"end":{"line":14,"column":478,"offset":993},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-enterprise-kubernetes.png","alt":"enterprise kubernetes","position":{"start":{"line":16,"column":1,"offset":995},"end":{"line":16,"column":81,"offset":1075},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":995},"end":{"line":16,"column":81,"offset":1075},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Compared to Kubernetes at the Edge, there are no predefined LoadBalancers, Storage capabilities, and more. This means more administration work for you, but - with great power comes great responsibility - so no worries. In the end there are alternative functionalties available, for features which you find out-of-the-box at the Kubernetes service providers, you just have to spend more time on configuring and installing those services/pods/deployments yourself.","position":{"start":{"line":18,"column":1,"offset":1077},"end":{"line":18,"column":463,"offset":1539},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1077},"end":{"line":18,"column":463,"offset":1539},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Installation on a Kubernetes Service Provider","position":{"start":{"line":20,"column":4,"offset":1544},"end":{"line":20,"column":49,"offset":1589},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1541},"end":{"line":20,"column":49,"offset":1589},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Installing Kerberos Storage, just like Kerberos Enterprise, on a Kubernetes Service Provider (Azure, GCP, AWS) is straight forward, as you can create a Kubernetes cluster in a few clicks, get access to public Load Balancers, storage and more. Running Kerberos Storage in such a cluster is just a matter of copy-pasting some configuration (yaml) files, and executing some ","position":{"start":{"line":22,"column":1,"offset":1591},"end":{"line":22,"column":372,"offset":1962},"indent":[]}},{"type":"inlineCode","value":"kubectl apply","position":{"start":{"line":22,"column":372,"offset":1962},"end":{"line":22,"column":387,"offset":1977},"indent":[]}},{"type":"text","value":" commands.","position":{"start":{"line":22,"column":387,"offset":1977},"end":{"line":22,"column":397,"offset":1987},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1591},"end":{"line":22,"column":397,"offset":1987},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":24,"column":1,"offset":1989},"end":{"line":24,"column":99,"offset":2087},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1989},"end":{"line":24,"column":99,"offset":2087},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Install Kerberos Storage on a Kubernetes Service Provider by ","position":{"start":{"line":26,"column":1,"offset":2089},"end":{"line":26,"column":62,"offset":2150},"indent":[]}},{"type":"link","title":null,"url":"/storage/installation-cloud","children":[{"type":"text","value":"following this step-by-step installation guide","position":{"start":{"line":26,"column":63,"offset":2151},"end":{"line":26,"column":109,"offset":2197},"indent":[]}}],"position":{"start":{"line":26,"column":62,"offset":2150},"end":{"line":26,"column":139,"offset":2227},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":26,"column":139,"offset":2227},"end":{"line":26,"column":140,"offset":2228},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":2089},"end":{"line":26,"column":140,"offset":2228},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Installation in Private Cloud or Baremetal","position":{"start":{"line":28,"column":4,"offset":2233},"end":{"line":28,"column":46,"offset":2275},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":2230},"end":{"line":28,"column":46,"offset":2275},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"No need to install Kerberos Storage on a Kubernetes Service Provider, you could install it on your own Kubernetes cluster in your private cloud, or even better inside your own premise. The closer you bring Kerberos Storage to your surveillance infrastructure, and Kerberos Enterprise, the more benefits you will experience (low latency, low bandwidth, etc).","position":{"start":{"line":30,"column":1,"offset":2277},"end":{"line":30,"column":358,"offset":2634},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2277},"end":{"line":30,"column":358,"offset":2634},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":32,"column":1,"offset":2636},"end":{"line":32,"column":98,"offset":2733},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2636},"end":{"line":32,"column":98,"offset":2733},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In contradiction to the Kubernetes Service Provider, you will have some work todo. Setting up Kubernetes Cluster, play with MetalLB, Persistent Volumes and claims. Don't be scared, it's pretty ssttraight forward as well. You can't simple expect a: click, click, 💥 approach.","position":{"start":{"line":34,"column":1,"offset":2735},"end":{"line":34,"column":275,"offset":3009},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2735},"end":{"line":34,"column":275,"offset":3009},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Install Kerberos Storage on a Private cloud or Baremetal by ","position":{"start":{"line":36,"column":1,"offset":3011},"end":{"line":36,"column":61,"offset":3071},"indent":[]}},{"type":"link","title":null,"url":"/storage/installation-edge","children":[{"type":"text","value":"following this step-by-step installation guide","position":{"start":{"line":36,"column":62,"offset":3072},"end":{"line":36,"column":108,"offset":3118},"indent":[]}}],"position":{"start":{"line":36,"column":61,"offset":3071},"end":{"line":36,"column":137,"offset":3147},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":36,"column":137,"offset":3147},"end":{"line":36,"column":138,"offset":3148},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":3011},"end":{"line":36,"column":138,"offset":3148},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":39,"column":1,"offset":3151},"end":{"line":39,"column":31,"offset":3181},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":39,"column":31,"offset":3181}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Installation`}

\n

{`Just like Kerberos Enterprise, Kerberos Storage can be installed where Kubernetes can be installed. This means that it can run at the Edge - Baremetal -, in the cloud - VMs - or at Kubernetes service providers - SAAS - such as GCP, Azure, AWS, DigitalOcean, and the list goes on.`}

\n

{`Although you might except Kubernetes at the Edge or Kubernetes in the cloud, there are no differences, well sorry to say there are. As Kubernetes service providers implemented features such as LoadBalancers, Persistent Volumes, and others, they have automated and integrated a huge portion of the Kubernetes stack with their related PAAS services. To be more concrete if you are running a Kubernetes Cluster on GCP, you will use the LoadBalancing and Storage services from GCP.`}

\n

\"enterprise

\n

{`Compared to Kubernetes at the Edge, there are no predefined LoadBalancers, Storage capabilities, and more. This means more administration work for you, but - with great power comes great responsibility - so no worries. In the end there are alternative functionalties available, for features which you find out-of-the-box at the Kubernetes service providers, you just have to spend more time on configuring and installing those services/pods/deployments yourself.`}

\n

{`Installation on a Kubernetes Service Provider`}

\n

{`Installing Kerberos Storage, just like Kerberos Enterprise, on a Kubernetes Service Provider (Azure, GCP, AWS) is straight forward, as you can create a Kubernetes cluster in a few clicks, get access to public Load Balancers, storage and more. Running Kerberos Storage in such a cluster is just a matter of copy-pasting some configuration (yaml) files, and executing some `}{`kubectl apply`}{` commands.`}

\n

\"architecture

\n

{`Install Kerberos Storage on a Kubernetes Service Provider by `}{`following this step-by-step installation guide`}{`.`}

\n

{`Installation in Private Cloud or Baremetal`}

\n

{`No need to install Kerberos Storage on a Kubernetes Service Provider, you could install it on your own Kubernetes cluster in your private cloud, or even better inside your own premise. The closer you bring Kerberos Storage to your surveillance infrastructure, and Kerberos Enterprise, the more benefits you will experience (low latency, low bandwidth, etc).`}

\n

\"architecture

\n

{`In contradiction to the Kubernetes Service Provider, you will have some work todo. Setting up Kubernetes Cluster, play with MetalLB, Persistent Volumes and claims. Don't be scared, it's pretty ssttraight forward as well. You can't simple expect a: click, click, 💥 approach.`}

\n

{`Install Kerberos Storage on a Private cloud or Baremetal by `}{`following this step-by-step installation guide`}{`.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-5d8c322d7bf54b1c5757c6e72ac0fd80.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-5d8c322d7bf54b1c5757c6e72ac0fd80.json index 10be7d2..403314b 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-5d8c322d7bf54b1c5757c6e72ac0fd80.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-5d8c322d7bf54b1c5757c6e72ac0fd80.json @@ -1 +1 @@ -{"expireTime":9007200861747673000,"key":"gatsby-plugin-mdx-entire-payload-41ab13200d57aacdade68a8ba920746f-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"License server","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":17,"offset":175},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":17,"offset":175},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A license can be obtained by requesting a contract offert a cedric@verstraeten.io. Once agreed, a license will be generated on the Kerberos License server.","position":{"start":{"line":10,"column":1,"offset":177},"end":{"line":10,"column":156,"offset":332},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":177},"end":{"line":10,"column":156,"offset":332},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"EULA","position":{"start":{"line":12,"column":3,"offset":336},"end":{"line":12,"column":7,"offset":340},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":334},"end":{"line":12,"column":7,"offset":340},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This agreement (or “EULA”) is a legal agreement between the person, company or organization (“You”) that has licensed a software product (Kerberos Storage) and Verstraeten.io (“Licensor” or “Application Provider”). The Product is to be obtained only through Docker Hub (","position":{"start":{"line":14,"column":1,"offset":342},"end":{"line":14,"column":271,"offset":612},"indent":[]}},{"type":"link","title":null,"url":"https://hub.docker.com","children":[{"type":"text","value":"https://hub.docker.com","position":{"start":{"line":14,"column":271,"offset":612},"end":{"line":14,"column":293,"offset":634},"indent":[]}}],"position":{"start":{"line":14,"column":271,"offset":612},"end":{"line":14,"column":293,"offset":634},"indent":[]}},{"type":"text","value":"), and by obtaining a purchased license. By installing and/or using any Product provided by the Licensor, You are confirming your acceptance of this agreement and you are agreeing to become bound by the terms of this agreement.","position":{"start":{"line":14,"column":293,"offset":634},"end":{"line":14,"column":520,"offset":861},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":342},"end":{"line":14,"column":520,"offset":861},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This EULA shall apply only to a Product supplied by the Licensor herewith regardless of whether other software or platform is referred to or described herein.","position":{"start":{"line":16,"column":1,"offset":863},"end":{"line":16,"column":159,"offset":1021},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":863},"end":{"line":16,"column":159,"offset":1021},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Products transacted through the Services are licensed, not sold, to You for use only under the terms of this license. The Application Provider reserves all rights not expressly granted to You. The Product that is subject to this license is referred to in this license as the “Licensed Application.” The Licensed Application is to be used on any operating system or machine (on-premise/cloud) and the aforementioned devices are referenced in this license as “Devices”.","position":{"start":{"line":18,"column":1,"offset":1023},"end":{"line":18,"column":472,"offset":1494},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1023},"end":{"line":18,"column":472,"offset":1494},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"a. Scope of License: This license granted to You for the Licensed Application by Application Provider is limited to a non-transferable license to use the Licensed Application on any Devices that You own or control and as permitted by the Usage Rules. This license does not allow You to use the Licensed Application on any Devices that You do not own or control, and You may not distribute or make the Licensed Application available over a network where it could be used by multiple devices at the same time. You may not rent, lease, lend, sell, redistribute or sublicense the Licensed Application. You may not copy (except as expressly permitted by this license and the Usage Rules), decompile, reverse engineer, disassemble, attempt to derive the source code of, modify, or create derivative works of the Licensed Application, any updates, or any part thereof (except as and only to the extent any foregoing restriction is prohibited by applicable law or to the extent as may be permitted by the licensing terms governing use of any open sourced components included with the Licensed Application). Any attempt to do so is a violation of the rights of the Application Provider and its licensors. If You breach this restriction, You may be subject to prosecution and damages. The terms of the license will govern any upgrades provided by Application Provider that replace and/or supplement the original Product, unless such upgrade is accompanied by a separate license in which case the terms of that license will govern.","position":{"start":{"line":20,"column":1,"offset":1496},"end":{"line":20,"column":1521,"offset":3016},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1496},"end":{"line":20,"column":1521,"offset":3016},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"b. Consent to Use of Data: You agree that Application Provider may collect and use technical data and related information, including but not limited to technical information about Your device, system and application software, and peripherals, that is gathered periodically to facilitate the provision of software updates, product support and other services to You (if any) related to the Licensed Application. Application Provider may use this information, as long as it is in a form that does not personally identify You, to improve its products or to provide services or technologies to You.","position":{"start":{"line":22,"column":1,"offset":3018},"end":{"line":22,"column":594,"offset":3611},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":3018},"end":{"line":22,"column":594,"offset":3611},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"c. Termination. The license is effective until terminated by You or Application Provider. Your rights under this license will terminate automatically without notice from the Application Provider if You fail to comply with any term(s) of this license. Upon termination of the license, You shall cease all use of the Licensed Application, and destroy all copies, full or partial, of the Licensed Application.","position":{"start":{"line":24,"column":1,"offset":3613},"end":{"line":24,"column":407,"offset":4019},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":3613},"end":{"line":24,"column":407,"offset":4019},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"d. Services; Third Party Materials. The Licensed Application may enable access to Application Provider’s and third party services and web sites (collectively and individually, “Services”). Use of the Services may require Internet access and that You accept additional terms of service.","position":{"start":{"line":26,"column":1,"offset":4021},"end":{"line":26,"column":286,"offset":4306},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":4021},"end":{"line":26,"column":286,"offset":4306},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You understand that by using any of the Services, You may encounter content that may be deemed offensive, indecent, or objectionable, which content may or may not be identified as having explicit language, and that the results of any search or entering of a particular URL may automatically and unintentionally generate links or references to objectionable material. Nevertheless, You agree to use the Services at Your sole risk and that the Application Provider shall not have any liability to You for content that may be found to be offensive, indecent, or objectionable.","position":{"start":{"line":28,"column":1,"offset":4308},"end":{"line":28,"column":574,"offset":4881},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":4308},"end":{"line":28,"column":574,"offset":4881},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Certain Services may display, include or make available content, data, information, applications or materials from third parties (“Third Party Materials”) or provide links to certain third party web sites. By using the Services, You acknowledge and agree that the Application Provider is not responsible for examining or evaluating the content, accuracy, completeness, timeliness, validity, copyright compliance, legality, decency, quality or any other aspect of such Third Party Materials or web sites. The Application Provider does not warrant or endorse and does not assume and will not have any liability or responsibility to You or any other person for any third-party Services, Third Party Materials or web sites, or for any other materials, products, or services of third parties. Third Party Materials and links to other web sites are provided solely as a convenience to You. Financial information displayed by any Services is for general informational purposes only and is not intended to be relied upon as investment advice. Before executing any securities transaction based upon information obtained through the Services, You should consult with a financial professional. Location data provided by any Services is for basic navigational purposes only and is not intended to be relied upon in situations where precise location information is needed or where erroneous, inaccurate or incomplete location data may lead to death, personal injury, property or environmental damage. Neither the Application Provider, nor any of its content providers, guarantees the availability, accuracy, completeness, reliability, or timeliness of stock information or location data displayed by any Services.","position":{"start":{"line":30,"column":1,"offset":4883},"end":{"line":30,"column":1701,"offset":6583},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":4883},"end":{"line":30,"column":1701,"offset":6583},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You agree that any Services contain proprietary content, information and material that is protected by applicable intellectual property and other laws, including but not limited to copyright, and that You will not use such proprietary content, information or materials in any way whatsoever except for permitted use of the Services. No portion of the Services may be reproduced in any form or by any means. You agree not to modify, rent, lease, loan, sell, distribute, or create derivative works based on the Services, in any manner, and You shall not exploit the Services in any unauthorized way whatsoever, including but not limited to, by trespass or burdening network capacity. You further agree not to use the Services in any manner to harass, abuse, stalk, threaten, defame or otherwise infringe or violate the rights of any other party, and that the Application Provider is not in any way responsible for any such use by You, nor for any harassing, threatening, defamatory, offensive or illegal messages or transmissions that You may receive as a result of using any of the Services.","position":{"start":{"line":32,"column":1,"offset":6585},"end":{"line":32,"column":1091,"offset":7675},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":6585},"end":{"line":32,"column":1091,"offset":7675},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition, third party Services and Third Party Materials that may be accessed from, displayed on or linked to from the Devices are not available in all languages or in all countries. The Application Provider makes no representation that such Services and Materials are appropriate or available for use in any particular location. To the extent You choose to access such Services or Materials, You do so at Your own initiative and are responsible for compliance with any applicable laws, including but not limited to applicable local laws. The Application Provider, and its licensors, reserve the right to change, suspend, remove, or disable access to any Services at any time without notice. In no event will the Application Provider be liable for the removal of or disabling of access to any such Services. The Application Provider may also impose limits on the use of or access to certain Services, in any case and without notice or liability.","position":{"start":{"line":34,"column":1,"offset":7677},"end":{"line":34,"column":949,"offset":8625},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":7677},"end":{"line":34,"column":949,"offset":8625},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"e. No Warranty: You expressly acknowledge and agree that use of the licensed application is at your sole risk and that the entire risk as to satisfactory quality, performance, accuracy and effort is with you. To the maximum extent permitted by applicable law, the license application and any services performed or provided by the licensed application (“services”) are provided “as is” and “as available,” with all faults and without warranty of any kind, and application provider hereby disclaims all warranties and conditions with respect to the licensed application and any services, either express, implied or statutory, including, but not limited to, the implied warranties and/or conditions of merchantability, of satisfactory quality, of fitness for a particular purpose, of accuracy, of quiet enjoyment, and non-infringement of third party rights. Application provider does not warrant against interference with your enjoyment of the licensed application, that the functions contained in, or services performed or provided by, the licensed application will meet your requirements, that the operation of the licensed application or services will be uninterrupted or error-free, or that effects in the licensed application or services will be corrected. No oral or written information or advice given by application provider or its authorized representative shall create a warranty. Should the licensed application or services prove defective, you assume the entire cost of all necessary servicing, repair or correction. Some jurisdictions do not allow the exclusion of implied warranties or limitations on applicable statutory rights of a consumer, so the above exclusion and limitations may not apply to you.","position":{"start":{"line":36,"column":1,"offset":8627},"end":{"line":36,"column":1716,"offset":10342},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":8627},"end":{"line":36,"column":1716,"offset":10342},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"f. Limitation of Liability. To the extent not prohibited by law, in no event shall application provider be liable for personal injury, or any incidental, special, indirect or consequential damages whatsoever, including, without limitation, damages for loss of profits, loss of data, business interruption or any other commercial damages or losses, arising out of or related to your use or inability to use the licensed application, however caused, regardless of the theory of liability (contract, tort or otherwise) and even if application provider has been advised of the possibility of such damages. Some jurisdictions do not allow the limitation of liability for personal injury, or of incidental or consequential damages, so this limitation may not apply to you.","position":{"start":{"line":38,"column":1,"offset":10344},"end":{"line":38,"column":767,"offset":11110},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":10344},"end":{"line":38,"column":767,"offset":11110},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In no event shall Application Provider’s total liability to you for all damages (other than as may be required by applicable law in cases involving personal injury) exceed the amount of fifty dollars ($50.00). The foregoing limitations will apply even if the above stated remedy fails of its essential purpose.","position":{"start":{"line":40,"column":1,"offset":11112},"end":{"line":40,"column":311,"offset":11422},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":11112},"end":{"line":40,"column":311,"offset":11422},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"g. You may not use or otherwise export or re-export the Licensed Application except as authorized by United States law and the laws of the jurisdiction in which the Licensed Application was obtained. In particular, but without limitation, the Licensed Application may not be exported or re-exported (a) into any U.S. embargoed countries or (b) to anyone on the U.S. Treasury Department’s list of Specially Designated Nationals or the U.S. Department of Commerce Denied Person’s List or Entity List. By using the Licensed Application, you represent and warrant that you are not located in any such country or on any such list. You also agree that you will not use these products for any purposes prohibited by United States law, including, without limitation, the development, design, manufacture or production of nuclear, missiles, or chemical or biological weapons.","position":{"start":{"line":42,"column":1,"offset":11424},"end":{"line":42,"column":867,"offset":12290},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":11424},"end":{"line":42,"column":867,"offset":12290},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"h. The Licensed Application and related documentation are “Commercial Items”, as that term is defined at 48 C.F.R. §2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation”, as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States.","position":{"start":{"line":44,"column":1,"offset":12292},"end":{"line":44,"column":741,"offset":13032},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":12292},"end":{"line":44,"column":741,"offset":13032},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"i. The laws of the State of Belgium, excluding its conflicts of law rules, govern this license and your use of the Licensed Application. Your use of the Licensed Application may also be subject to other local, state, national, or international laws.","position":{"start":{"line":46,"column":1,"offset":13034},"end":{"line":46,"column":250,"offset":13283},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":13034},"end":{"line":46,"column":250,"offset":13283},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":49,"column":1,"offset":13286},"end":{"line":49,"column":31,"offset":13316},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":49,"column":31,"offset":13316}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`License server`}

\n

{`A license can be obtained by requesting a contract offert a cedric@verstraeten.io. Once agreed, a license will be generated on the Kerberos License server.`}

\n

{`EULA`}

\n

{`This agreement (or “EULA”) is a legal agreement between the person, company or organization (“You”) that has licensed a software product (Kerberos Storage) and Verstraeten.io (“Licensor” or “Application Provider”). The Product is to be obtained only through Docker Hub (`}{`https://hub.docker.com`}{`), and by obtaining a purchased license. By installing and/or using any Product provided by the Licensor, You are confirming your acceptance of this agreement and you are agreeing to become bound by the terms of this agreement.`}

\n

{`This EULA shall apply only to a Product supplied by the Licensor herewith regardless of whether other software or platform is referred to or described herein.`}

\n

{`The Products transacted through the Services are licensed, not sold, to You for use only under the terms of this license. The Application Provider reserves all rights not expressly granted to You. The Product that is subject to this license is referred to in this license as the “Licensed Application.” The Licensed Application is to be used on any operating system or machine (on-premise/cloud) and the aforementioned devices are referenced in this license as “Devices”.`}

\n

{`a. Scope of License: This license granted to You for the Licensed Application by Application Provider is limited to a non-transferable license to use the Licensed Application on any Devices that You own or control and as permitted by the Usage Rules. This license does not allow You to use the Licensed Application on any Devices that You do not own or control, and You may not distribute or make the Licensed Application available over a network where it could be used by multiple devices at the same time. You may not rent, lease, lend, sell, redistribute or sublicense the Licensed Application. You may not copy (except as expressly permitted by this license and the Usage Rules), decompile, reverse engineer, disassemble, attempt to derive the source code of, modify, or create derivative works of the Licensed Application, any updates, or any part thereof (except as and only to the extent any foregoing restriction is prohibited by applicable law or to the extent as may be permitted by the licensing terms governing use of any open sourced components included with the Licensed Application). Any attempt to do so is a violation of the rights of the Application Provider and its licensors. If You breach this restriction, You may be subject to prosecution and damages. The terms of the license will govern any upgrades provided by Application Provider that replace and/or supplement the original Product, unless such upgrade is accompanied by a separate license in which case the terms of that license will govern.`}

\n

{`b. Consent to Use of Data: You agree that Application Provider may collect and use technical data and related information, including but not limited to technical information about Your device, system and application software, and peripherals, that is gathered periodically to facilitate the provision of software updates, product support and other services to You (if any) related to the Licensed Application. Application Provider may use this information, as long as it is in a form that does not personally identify You, to improve its products or to provide services or technologies to You.`}

\n

{`c. Termination. The license is effective until terminated by You or Application Provider. Your rights under this license will terminate automatically without notice from the Application Provider if You fail to comply with any term(s) of this license. Upon termination of the license, You shall cease all use of the Licensed Application, and destroy all copies, full or partial, of the Licensed Application.`}

\n

{`d. Services; Third Party Materials. The Licensed Application may enable access to Application Provider’s and third party services and web sites (collectively and individually, “Services”). Use of the Services may require Internet access and that You accept additional terms of service.`}

\n

{`You understand that by using any of the Services, You may encounter content that may be deemed offensive, indecent, or objectionable, which content may or may not be identified as having explicit language, and that the results of any search or entering of a particular URL may automatically and unintentionally generate links or references to objectionable material. Nevertheless, You agree to use the Services at Your sole risk and that the Application Provider shall not have any liability to You for content that may be found to be offensive, indecent, or objectionable.`}

\n

{`Certain Services may display, include or make available content, data, information, applications or materials from third parties (“Third Party Materials”) or provide links to certain third party web sites. By using the Services, You acknowledge and agree that the Application Provider is not responsible for examining or evaluating the content, accuracy, completeness, timeliness, validity, copyright compliance, legality, decency, quality or any other aspect of such Third Party Materials or web sites. The Application Provider does not warrant or endorse and does not assume and will not have any liability or responsibility to You or any other person for any third-party Services, Third Party Materials or web sites, or for any other materials, products, or services of third parties. Third Party Materials and links to other web sites are provided solely as a convenience to You. Financial information displayed by any Services is for general informational purposes only and is not intended to be relied upon as investment advice. Before executing any securities transaction based upon information obtained through the Services, You should consult with a financial professional. Location data provided by any Services is for basic navigational purposes only and is not intended to be relied upon in situations where precise location information is needed or where erroneous, inaccurate or incomplete location data may lead to death, personal injury, property or environmental damage. Neither the Application Provider, nor any of its content providers, guarantees the availability, accuracy, completeness, reliability, or timeliness of stock information or location data displayed by any Services.`}

\n

{`You agree that any Services contain proprietary content, information and material that is protected by applicable intellectual property and other laws, including but not limited to copyright, and that You will not use such proprietary content, information or materials in any way whatsoever except for permitted use of the Services. No portion of the Services may be reproduced in any form or by any means. You agree not to modify, rent, lease, loan, sell, distribute, or create derivative works based on the Services, in any manner, and You shall not exploit the Services in any unauthorized way whatsoever, including but not limited to, by trespass or burdening network capacity. You further agree not to use the Services in any manner to harass, abuse, stalk, threaten, defame or otherwise infringe or violate the rights of any other party, and that the Application Provider is not in any way responsible for any such use by You, nor for any harassing, threatening, defamatory, offensive or illegal messages or transmissions that You may receive as a result of using any of the Services.`}

\n

{`In addition, third party Services and Third Party Materials that may be accessed from, displayed on or linked to from the Devices are not available in all languages or in all countries. The Application Provider makes no representation that such Services and Materials are appropriate or available for use in any particular location. To the extent You choose to access such Services or Materials, You do so at Your own initiative and are responsible for compliance with any applicable laws, including but not limited to applicable local laws. The Application Provider, and its licensors, reserve the right to change, suspend, remove, or disable access to any Services at any time without notice. In no event will the Application Provider be liable for the removal of or disabling of access to any such Services. The Application Provider may also impose limits on the use of or access to certain Services, in any case and without notice or liability.`}

\n

{`e. No Warranty: You expressly acknowledge and agree that use of the licensed application is at your sole risk and that the entire risk as to satisfactory quality, performance, accuracy and effort is with you. To the maximum extent permitted by applicable law, the license application and any services performed or provided by the licensed application (“services”) are provided “as is” and “as available,” with all faults and without warranty of any kind, and application provider hereby disclaims all warranties and conditions with respect to the licensed application and any services, either express, implied or statutory, including, but not limited to, the implied warranties and/or conditions of merchantability, of satisfactory quality, of fitness for a particular purpose, of accuracy, of quiet enjoyment, and non-infringement of third party rights. Application provider does not warrant against interference with your enjoyment of the licensed application, that the functions contained in, or services performed or provided by, the licensed application will meet your requirements, that the operation of the licensed application or services will be uninterrupted or error-free, or that effects in the licensed application or services will be corrected. No oral or written information or advice given by application provider or its authorized representative shall create a warranty. Should the licensed application or services prove defective, you assume the entire cost of all necessary servicing, repair or correction. Some jurisdictions do not allow the exclusion of implied warranties or limitations on applicable statutory rights of a consumer, so the above exclusion and limitations may not apply to you.`}

\n

{`f. Limitation of Liability. To the extent not prohibited by law, in no event shall application provider be liable for personal injury, or any incidental, special, indirect or consequential damages whatsoever, including, without limitation, damages for loss of profits, loss of data, business interruption or any other commercial damages or losses, arising out of or related to your use or inability to use the licensed application, however caused, regardless of the theory of liability (contract, tort or otherwise) and even if application provider has been advised of the possibility of such damages. Some jurisdictions do not allow the limitation of liability for personal injury, or of incidental or consequential damages, so this limitation may not apply to you.`}

\n

{`In no event shall Application Provider’s total liability to you for all damages (other than as may be required by applicable law in cases involving personal injury) exceed the amount of fifty dollars ($50.00). The foregoing limitations will apply even if the above stated remedy fails of its essential purpose.`}

\n

{`g. You may not use or otherwise export or re-export the Licensed Application except as authorized by United States law and the laws of the jurisdiction in which the Licensed Application was obtained. In particular, but without limitation, the Licensed Application may not be exported or re-exported (a) into any U.S. embargoed countries or (b) to anyone on the U.S. Treasury Department’s list of Specially Designated Nationals or the U.S. Department of Commerce Denied Person’s List or Entity List. By using the Licensed Application, you represent and warrant that you are not located in any such country or on any such list. You also agree that you will not use these products for any purposes prohibited by United States law, including, without limitation, the development, design, manufacture or production of nuclear, missiles, or chemical or biological weapons.`}

\n

{`h. The Licensed Application and related documentation are “Commercial Items”, as that term is defined at 48 C.F.R. §2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation”, as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States.`}

\n

{`i. The laws of the State of Belgium, excluding its conflicts of law rules, govern this license and your use of the Licensed Application. Your use of the Licensed Application may also be subject to other local, state, national, or international laws.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750177000,"key":"gatsby-plugin-mdx-entire-payload-41ab13200d57aacdade68a8ba920746f-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"License server","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":17,"offset":175},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":17,"offset":175},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A license can be obtained by requesting a contract offert a cedric@verstraeten.io. Once agreed, a license will be generated on the Kerberos License server.","position":{"start":{"line":10,"column":1,"offset":177},"end":{"line":10,"column":156,"offset":332},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":177},"end":{"line":10,"column":156,"offset":332},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"EULA","position":{"start":{"line":12,"column":3,"offset":336},"end":{"line":12,"column":7,"offset":340},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":334},"end":{"line":12,"column":7,"offset":340},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This agreement (or “EULA”) is a legal agreement between the person, company or organization (“You”) that has licensed a software product (Kerberos Storage) and Verstraeten.io (“Licensor” or “Application Provider”). The Product is to be obtained only through Docker Hub (","position":{"start":{"line":14,"column":1,"offset":342},"end":{"line":14,"column":271,"offset":612},"indent":[]}},{"type":"link","title":null,"url":"https://hub.docker.com","children":[{"type":"text","value":"https://hub.docker.com","position":{"start":{"line":14,"column":271,"offset":612},"end":{"line":14,"column":293,"offset":634},"indent":[]}}],"position":{"start":{"line":14,"column":271,"offset":612},"end":{"line":14,"column":293,"offset":634},"indent":[]}},{"type":"text","value":"), and by obtaining a purchased license. By installing and/or using any Product provided by the Licensor, You are confirming your acceptance of this agreement and you are agreeing to become bound by the terms of this agreement.","position":{"start":{"line":14,"column":293,"offset":634},"end":{"line":14,"column":520,"offset":861},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":342},"end":{"line":14,"column":520,"offset":861},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This EULA shall apply only to a Product supplied by the Licensor herewith regardless of whether other software or platform is referred to or described herein.","position":{"start":{"line":16,"column":1,"offset":863},"end":{"line":16,"column":159,"offset":1021},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":863},"end":{"line":16,"column":159,"offset":1021},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Products transacted through the Services are licensed, not sold, to You for use only under the terms of this license. The Application Provider reserves all rights not expressly granted to You. The Product that is subject to this license is referred to in this license as the “Licensed Application.” The Licensed Application is to be used on any operating system or machine (on-premise/cloud) and the aforementioned devices are referenced in this license as “Devices”.","position":{"start":{"line":18,"column":1,"offset":1023},"end":{"line":18,"column":472,"offset":1494},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1023},"end":{"line":18,"column":472,"offset":1494},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"a. Scope of License: This license granted to You for the Licensed Application by Application Provider is limited to a non-transferable license to use the Licensed Application on any Devices that You own or control and as permitted by the Usage Rules. This license does not allow You to use the Licensed Application on any Devices that You do not own or control, and You may not distribute or make the Licensed Application available over a network where it could be used by multiple devices at the same time. You may not rent, lease, lend, sell, redistribute or sublicense the Licensed Application. You may not copy (except as expressly permitted by this license and the Usage Rules), decompile, reverse engineer, disassemble, attempt to derive the source code of, modify, or create derivative works of the Licensed Application, any updates, or any part thereof (except as and only to the extent any foregoing restriction is prohibited by applicable law or to the extent as may be permitted by the licensing terms governing use of any open sourced components included with the Licensed Application). Any attempt to do so is a violation of the rights of the Application Provider and its licensors. If You breach this restriction, You may be subject to prosecution and damages. The terms of the license will govern any upgrades provided by Application Provider that replace and/or supplement the original Product, unless such upgrade is accompanied by a separate license in which case the terms of that license will govern.","position":{"start":{"line":20,"column":1,"offset":1496},"end":{"line":20,"column":1521,"offset":3016},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1496},"end":{"line":20,"column":1521,"offset":3016},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"b. Consent to Use of Data: You agree that Application Provider may collect and use technical data and related information, including but not limited to technical information about Your device, system and application software, and peripherals, that is gathered periodically to facilitate the provision of software updates, product support and other services to You (if any) related to the Licensed Application. Application Provider may use this information, as long as it is in a form that does not personally identify You, to improve its products or to provide services or technologies to You.","position":{"start":{"line":22,"column":1,"offset":3018},"end":{"line":22,"column":594,"offset":3611},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":3018},"end":{"line":22,"column":594,"offset":3611},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"c. Termination. The license is effective until terminated by You or Application Provider. Your rights under this license will terminate automatically without notice from the Application Provider if You fail to comply with any term(s) of this license. Upon termination of the license, You shall cease all use of the Licensed Application, and destroy all copies, full or partial, of the Licensed Application.","position":{"start":{"line":24,"column":1,"offset":3613},"end":{"line":24,"column":407,"offset":4019},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":3613},"end":{"line":24,"column":407,"offset":4019},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"d. Services; Third Party Materials. The Licensed Application may enable access to Application Provider’s and third party services and web sites (collectively and individually, “Services”). Use of the Services may require Internet access and that You accept additional terms of service.","position":{"start":{"line":26,"column":1,"offset":4021},"end":{"line":26,"column":286,"offset":4306},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":4021},"end":{"line":26,"column":286,"offset":4306},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You understand that by using any of the Services, You may encounter content that may be deemed offensive, indecent, or objectionable, which content may or may not be identified as having explicit language, and that the results of any search or entering of a particular URL may automatically and unintentionally generate links or references to objectionable material. Nevertheless, You agree to use the Services at Your sole risk and that the Application Provider shall not have any liability to You for content that may be found to be offensive, indecent, or objectionable.","position":{"start":{"line":28,"column":1,"offset":4308},"end":{"line":28,"column":574,"offset":4881},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":4308},"end":{"line":28,"column":574,"offset":4881},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Certain Services may display, include or make available content, data, information, applications or materials from third parties (“Third Party Materials”) or provide links to certain third party web sites. By using the Services, You acknowledge and agree that the Application Provider is not responsible for examining or evaluating the content, accuracy, completeness, timeliness, validity, copyright compliance, legality, decency, quality or any other aspect of such Third Party Materials or web sites. The Application Provider does not warrant or endorse and does not assume and will not have any liability or responsibility to You or any other person for any third-party Services, Third Party Materials or web sites, or for any other materials, products, or services of third parties. Third Party Materials and links to other web sites are provided solely as a convenience to You. Financial information displayed by any Services is for general informational purposes only and is not intended to be relied upon as investment advice. Before executing any securities transaction based upon information obtained through the Services, You should consult with a financial professional. Location data provided by any Services is for basic navigational purposes only and is not intended to be relied upon in situations where precise location information is needed or where erroneous, inaccurate or incomplete location data may lead to death, personal injury, property or environmental damage. Neither the Application Provider, nor any of its content providers, guarantees the availability, accuracy, completeness, reliability, or timeliness of stock information or location data displayed by any Services.","position":{"start":{"line":30,"column":1,"offset":4883},"end":{"line":30,"column":1701,"offset":6583},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":4883},"end":{"line":30,"column":1701,"offset":6583},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You agree that any Services contain proprietary content, information and material that is protected by applicable intellectual property and other laws, including but not limited to copyright, and that You will not use such proprietary content, information or materials in any way whatsoever except for permitted use of the Services. No portion of the Services may be reproduced in any form or by any means. You agree not to modify, rent, lease, loan, sell, distribute, or create derivative works based on the Services, in any manner, and You shall not exploit the Services in any unauthorized way whatsoever, including but not limited to, by trespass or burdening network capacity. You further agree not to use the Services in any manner to harass, abuse, stalk, threaten, defame or otherwise infringe or violate the rights of any other party, and that the Application Provider is not in any way responsible for any such use by You, nor for any harassing, threatening, defamatory, offensive or illegal messages or transmissions that You may receive as a result of using any of the Services.","position":{"start":{"line":32,"column":1,"offset":6585},"end":{"line":32,"column":1091,"offset":7675},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":6585},"end":{"line":32,"column":1091,"offset":7675},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition, third party Services and Third Party Materials that may be accessed from, displayed on or linked to from the Devices are not available in all languages or in all countries. The Application Provider makes no representation that such Services and Materials are appropriate or available for use in any particular location. To the extent You choose to access such Services or Materials, You do so at Your own initiative and are responsible for compliance with any applicable laws, including but not limited to applicable local laws. The Application Provider, and its licensors, reserve the right to change, suspend, remove, or disable access to any Services at any time without notice. In no event will the Application Provider be liable for the removal of or disabling of access to any such Services. The Application Provider may also impose limits on the use of or access to certain Services, in any case and without notice or liability.","position":{"start":{"line":34,"column":1,"offset":7677},"end":{"line":34,"column":949,"offset":8625},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":7677},"end":{"line":34,"column":949,"offset":8625},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"e. No Warranty: You expressly acknowledge and agree that use of the licensed application is at your sole risk and that the entire risk as to satisfactory quality, performance, accuracy and effort is with you. To the maximum extent permitted by applicable law, the license application and any services performed or provided by the licensed application (“services”) are provided “as is” and “as available,” with all faults and without warranty of any kind, and application provider hereby disclaims all warranties and conditions with respect to the licensed application and any services, either express, implied or statutory, including, but not limited to, the implied warranties and/or conditions of merchantability, of satisfactory quality, of fitness for a particular purpose, of accuracy, of quiet enjoyment, and non-infringement of third party rights. Application provider does not warrant against interference with your enjoyment of the licensed application, that the functions contained in, or services performed or provided by, the licensed application will meet your requirements, that the operation of the licensed application or services will be uninterrupted or error-free, or that effects in the licensed application or services will be corrected. No oral or written information or advice given by application provider or its authorized representative shall create a warranty. Should the licensed application or services prove defective, you assume the entire cost of all necessary servicing, repair or correction. Some jurisdictions do not allow the exclusion of implied warranties or limitations on applicable statutory rights of a consumer, so the above exclusion and limitations may not apply to you.","position":{"start":{"line":36,"column":1,"offset":8627},"end":{"line":36,"column":1716,"offset":10342},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":8627},"end":{"line":36,"column":1716,"offset":10342},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"f. Limitation of Liability. To the extent not prohibited by law, in no event shall application provider be liable for personal injury, or any incidental, special, indirect or consequential damages whatsoever, including, without limitation, damages for loss of profits, loss of data, business interruption or any other commercial damages or losses, arising out of or related to your use or inability to use the licensed application, however caused, regardless of the theory of liability (contract, tort or otherwise) and even if application provider has been advised of the possibility of such damages. Some jurisdictions do not allow the limitation of liability for personal injury, or of incidental or consequential damages, so this limitation may not apply to you.","position":{"start":{"line":38,"column":1,"offset":10344},"end":{"line":38,"column":767,"offset":11110},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":10344},"end":{"line":38,"column":767,"offset":11110},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In no event shall Application Provider’s total liability to you for all damages (other than as may be required by applicable law in cases involving personal injury) exceed the amount of fifty dollars ($50.00). The foregoing limitations will apply even if the above stated remedy fails of its essential purpose.","position":{"start":{"line":40,"column":1,"offset":11112},"end":{"line":40,"column":311,"offset":11422},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":11112},"end":{"line":40,"column":311,"offset":11422},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"g. You may not use or otherwise export or re-export the Licensed Application except as authorized by United States law and the laws of the jurisdiction in which the Licensed Application was obtained. In particular, but without limitation, the Licensed Application may not be exported or re-exported (a) into any U.S. embargoed countries or (b) to anyone on the U.S. Treasury Department’s list of Specially Designated Nationals or the U.S. Department of Commerce Denied Person’s List or Entity List. By using the Licensed Application, you represent and warrant that you are not located in any such country or on any such list. You also agree that you will not use these products for any purposes prohibited by United States law, including, without limitation, the development, design, manufacture or production of nuclear, missiles, or chemical or biological weapons.","position":{"start":{"line":42,"column":1,"offset":11424},"end":{"line":42,"column":867,"offset":12290},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":11424},"end":{"line":42,"column":867,"offset":12290},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"h. The Licensed Application and related documentation are “Commercial Items”, as that term is defined at 48 C.F.R. §2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation”, as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States.","position":{"start":{"line":44,"column":1,"offset":12292},"end":{"line":44,"column":741,"offset":13032},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":12292},"end":{"line":44,"column":741,"offset":13032},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"i. The laws of the State of Belgium, excluding its conflicts of law rules, govern this license and your use of the Licensed Application. Your use of the Licensed Application may also be subject to other local, state, national, or international laws.","position":{"start":{"line":46,"column":1,"offset":13034},"end":{"line":46,"column":250,"offset":13283},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":13034},"end":{"line":46,"column":250,"offset":13283},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":49,"column":1,"offset":13286},"end":{"line":49,"column":31,"offset":13316},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":49,"column":31,"offset":13316}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`License server`}

\n

{`A license can be obtained by requesting a contract offert a cedric@verstraeten.io. Once agreed, a license will be generated on the Kerberos License server.`}

\n

{`EULA`}

\n

{`This agreement (or “EULA”) is a legal agreement between the person, company or organization (“You”) that has licensed a software product (Kerberos Storage) and Verstraeten.io (“Licensor” or “Application Provider”). The Product is to be obtained only through Docker Hub (`}{`https://hub.docker.com`}{`), and by obtaining a purchased license. By installing and/or using any Product provided by the Licensor, You are confirming your acceptance of this agreement and you are agreeing to become bound by the terms of this agreement.`}

\n

{`This EULA shall apply only to a Product supplied by the Licensor herewith regardless of whether other software or platform is referred to or described herein.`}

\n

{`The Products transacted through the Services are licensed, not sold, to You for use only under the terms of this license. The Application Provider reserves all rights not expressly granted to You. The Product that is subject to this license is referred to in this license as the “Licensed Application.” The Licensed Application is to be used on any operating system or machine (on-premise/cloud) and the aforementioned devices are referenced in this license as “Devices”.`}

\n

{`a. Scope of License: This license granted to You for the Licensed Application by Application Provider is limited to a non-transferable license to use the Licensed Application on any Devices that You own or control and as permitted by the Usage Rules. This license does not allow You to use the Licensed Application on any Devices that You do not own or control, and You may not distribute or make the Licensed Application available over a network where it could be used by multiple devices at the same time. You may not rent, lease, lend, sell, redistribute or sublicense the Licensed Application. You may not copy (except as expressly permitted by this license and the Usage Rules), decompile, reverse engineer, disassemble, attempt to derive the source code of, modify, or create derivative works of the Licensed Application, any updates, or any part thereof (except as and only to the extent any foregoing restriction is prohibited by applicable law or to the extent as may be permitted by the licensing terms governing use of any open sourced components included with the Licensed Application). Any attempt to do so is a violation of the rights of the Application Provider and its licensors. If You breach this restriction, You may be subject to prosecution and damages. The terms of the license will govern any upgrades provided by Application Provider that replace and/or supplement the original Product, unless such upgrade is accompanied by a separate license in which case the terms of that license will govern.`}

\n

{`b. Consent to Use of Data: You agree that Application Provider may collect and use technical data and related information, including but not limited to technical information about Your device, system and application software, and peripherals, that is gathered periodically to facilitate the provision of software updates, product support and other services to You (if any) related to the Licensed Application. Application Provider may use this information, as long as it is in a form that does not personally identify You, to improve its products or to provide services or technologies to You.`}

\n

{`c. Termination. The license is effective until terminated by You or Application Provider. Your rights under this license will terminate automatically without notice from the Application Provider if You fail to comply with any term(s) of this license. Upon termination of the license, You shall cease all use of the Licensed Application, and destroy all copies, full or partial, of the Licensed Application.`}

\n

{`d. Services; Third Party Materials. The Licensed Application may enable access to Application Provider’s and third party services and web sites (collectively and individually, “Services”). Use of the Services may require Internet access and that You accept additional terms of service.`}

\n

{`You understand that by using any of the Services, You may encounter content that may be deemed offensive, indecent, or objectionable, which content may or may not be identified as having explicit language, and that the results of any search or entering of a particular URL may automatically and unintentionally generate links or references to objectionable material. Nevertheless, You agree to use the Services at Your sole risk and that the Application Provider shall not have any liability to You for content that may be found to be offensive, indecent, or objectionable.`}

\n

{`Certain Services may display, include or make available content, data, information, applications or materials from third parties (“Third Party Materials”) or provide links to certain third party web sites. By using the Services, You acknowledge and agree that the Application Provider is not responsible for examining or evaluating the content, accuracy, completeness, timeliness, validity, copyright compliance, legality, decency, quality or any other aspect of such Third Party Materials or web sites. The Application Provider does not warrant or endorse and does not assume and will not have any liability or responsibility to You or any other person for any third-party Services, Third Party Materials or web sites, or for any other materials, products, or services of third parties. Third Party Materials and links to other web sites are provided solely as a convenience to You. Financial information displayed by any Services is for general informational purposes only and is not intended to be relied upon as investment advice. Before executing any securities transaction based upon information obtained through the Services, You should consult with a financial professional. Location data provided by any Services is for basic navigational purposes only and is not intended to be relied upon in situations where precise location information is needed or where erroneous, inaccurate or incomplete location data may lead to death, personal injury, property or environmental damage. Neither the Application Provider, nor any of its content providers, guarantees the availability, accuracy, completeness, reliability, or timeliness of stock information or location data displayed by any Services.`}

\n

{`You agree that any Services contain proprietary content, information and material that is protected by applicable intellectual property and other laws, including but not limited to copyright, and that You will not use such proprietary content, information or materials in any way whatsoever except for permitted use of the Services. No portion of the Services may be reproduced in any form or by any means. You agree not to modify, rent, lease, loan, sell, distribute, or create derivative works based on the Services, in any manner, and You shall not exploit the Services in any unauthorized way whatsoever, including but not limited to, by trespass or burdening network capacity. You further agree not to use the Services in any manner to harass, abuse, stalk, threaten, defame or otherwise infringe or violate the rights of any other party, and that the Application Provider is not in any way responsible for any such use by You, nor for any harassing, threatening, defamatory, offensive or illegal messages or transmissions that You may receive as a result of using any of the Services.`}

\n

{`In addition, third party Services and Third Party Materials that may be accessed from, displayed on or linked to from the Devices are not available in all languages or in all countries. The Application Provider makes no representation that such Services and Materials are appropriate or available for use in any particular location. To the extent You choose to access such Services or Materials, You do so at Your own initiative and are responsible for compliance with any applicable laws, including but not limited to applicable local laws. The Application Provider, and its licensors, reserve the right to change, suspend, remove, or disable access to any Services at any time without notice. In no event will the Application Provider be liable for the removal of or disabling of access to any such Services. The Application Provider may also impose limits on the use of or access to certain Services, in any case and without notice or liability.`}

\n

{`e. No Warranty: You expressly acknowledge and agree that use of the licensed application is at your sole risk and that the entire risk as to satisfactory quality, performance, accuracy and effort is with you. To the maximum extent permitted by applicable law, the license application and any services performed or provided by the licensed application (“services”) are provided “as is” and “as available,” with all faults and without warranty of any kind, and application provider hereby disclaims all warranties and conditions with respect to the licensed application and any services, either express, implied or statutory, including, but not limited to, the implied warranties and/or conditions of merchantability, of satisfactory quality, of fitness for a particular purpose, of accuracy, of quiet enjoyment, and non-infringement of third party rights. Application provider does not warrant against interference with your enjoyment of the licensed application, that the functions contained in, or services performed or provided by, the licensed application will meet your requirements, that the operation of the licensed application or services will be uninterrupted or error-free, or that effects in the licensed application or services will be corrected. No oral or written information or advice given by application provider or its authorized representative shall create a warranty. Should the licensed application or services prove defective, you assume the entire cost of all necessary servicing, repair or correction. Some jurisdictions do not allow the exclusion of implied warranties or limitations on applicable statutory rights of a consumer, so the above exclusion and limitations may not apply to you.`}

\n

{`f. Limitation of Liability. To the extent not prohibited by law, in no event shall application provider be liable for personal injury, or any incidental, special, indirect or consequential damages whatsoever, including, without limitation, damages for loss of profits, loss of data, business interruption or any other commercial damages or losses, arising out of or related to your use or inability to use the licensed application, however caused, regardless of the theory of liability (contract, tort or otherwise) and even if application provider has been advised of the possibility of such damages. Some jurisdictions do not allow the limitation of liability for personal injury, or of incidental or consequential damages, so this limitation may not apply to you.`}

\n

{`In no event shall Application Provider’s total liability to you for all damages (other than as may be required by applicable law in cases involving personal injury) exceed the amount of fifty dollars ($50.00). The foregoing limitations will apply even if the above stated remedy fails of its essential purpose.`}

\n

{`g. You may not use or otherwise export or re-export the Licensed Application except as authorized by United States law and the laws of the jurisdiction in which the Licensed Application was obtained. In particular, but without limitation, the Licensed Application may not be exported or re-exported (a) into any U.S. embargoed countries or (b) to anyone on the U.S. Treasury Department’s list of Specially Designated Nationals or the U.S. Department of Commerce Denied Person’s List or Entity List. By using the Licensed Application, you represent and warrant that you are not located in any such country or on any such list. You also agree that you will not use these products for any purposes prohibited by United States law, including, without limitation, the development, design, manufacture or production of nuclear, missiles, or chemical or biological weapons.`}

\n

{`h. The Licensed Application and related documentation are “Commercial Items”, as that term is defined at 48 C.F.R. §2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation”, as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States.`}

\n

{`i. The laws of the State of Belgium, excluding its conflicts of law rules, govern this license and your use of the Licensed Application. Your use of the Licensed Application may also be subject to other local, state, national, or international laws.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-5e78dedce734061c15b75015963d174f.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-5e78dedce734061c15b75015963d174f.json new file mode 100644 index 0000000..377263b --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-5e78dedce734061c15b75015963d174f.json @@ -0,0 +1 @@ +{"expireTime":9007200861829698000,"key":"gatsby-plugin-mdx-entire-payload-c8c44f873086768486a17be8f463b806-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":396,"offset":1049},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":396,"offset":1049},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Despite the flexible storage capabilities, Kerberos Storage is also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations. It allows you to leverage a scalable and stable system as a strong backbone for your video analytics solutions, machine learning algorithms, and more.","position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":349,"offset":1399},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":349,"offset":1399},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":22,"column":4,"offset":1404},"end":{"line":22,"column":18,"offset":1418},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1401},"end":{"line":22,"column":18,"offset":1418},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":24,"column":1,"offset":1420},"end":{"line":24,"column":291,"offset":1710},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":24,"column":292,"offset":1711},"end":{"line":24,"column":309,"offset":1728},"indent":[]}}],"position":{"start":{"line":24,"column":291,"offset":1710},"end":{"line":24,"column":318,"offset":1737},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":24,"column":318,"offset":1737},"end":{"line":24,"column":319,"offset":1738},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1420},"end":{"line":24,"column":319,"offset":1738},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":26,"column":1,"offset":1740},"end":{"line":26,"column":56,"offset":1795},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1740},"end":{"line":26,"column":56,"offset":1795},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":28,"column":4,"offset":1800},"end":{"line":28,"column":20,"offset":1816},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1797},"end":{"line":28,"column":20,"offset":1816},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":30,"column":1,"offset":1818},"end":{"line":30,"column":253,"offset":2070},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1818},"end":{"line":30,"column":253,"offset":2070},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":32,"column":6,"offset":2077},"end":{"line":32,"column":35,"offset":2106},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2076},"end":{"line":32,"column":70,"offset":2141},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2076},"end":{"line":32,"column":70,"offset":2141},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2072},"end":{"line":32,"column":70,"offset":2141},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":33,"column":6,"offset":2147},"end":{"line":33,"column":29,"offset":2170},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2146},"end":{"line":33,"column":83,"offset":2224},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2146},"end":{"line":33,"column":83,"offset":2224},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2142},"end":{"line":33,"column":83,"offset":2224},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":34,"column":6,"offset":2230},"end":{"line":34,"column":28,"offset":2252},"indent":[]}}],"position":{"start":{"line":34,"column":5,"offset":2229},"end":{"line":34,"column":57,"offset":2281},"indent":[]}}],"position":{"start":{"line":34,"column":5,"offset":2229},"end":{"line":34,"column":57,"offset":2281},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2225},"end":{"line":34,"column":57,"offset":2281},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":35,"column":6,"offset":2287},"end":{"line":35,"column":11,"offset":2292},"indent":[]}}],"position":{"start":{"line":35,"column":5,"offset":2286},"end":{"line":35,"column":29,"offset":2310},"indent":[]}}],"position":{"start":{"line":35,"column":5,"offset":2286},"end":{"line":35,"column":29,"offset":2310},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2282},"end":{"line":35,"column":29,"offset":2310},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2072},"end":{"line":35,"column":29,"offset":2310},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":37,"column":1,"offset":2312},"end":{"line":37,"column":190,"offset":2501},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2312},"end":{"line":37,"column":190,"offset":2501},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":39,"column":1,"offset":2503},"end":{"line":39,"column":99,"offset":2601},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2503},"end":{"line":39,"column":99,"offset":2601},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":41,"column":1,"offset":2603},"end":{"line":41,"column":220,"offset":2822},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2603},"end":{"line":41,"column":220,"offset":2822},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":43,"column":1,"offset":2824},"end":{"line":43,"column":98,"offset":2921},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2824},"end":{"line":43,"column":98,"offset":2921},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":45,"column":5,"offset":2927},"end":{"line":45,"column":11,"offset":2933},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2923},"end":{"line":45,"column":11,"offset":2933},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":47,"column":1,"offset":2935},"end":{"line":47,"column":303,"offset":3237},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2935},"end":{"line":47,"column":303,"offset":3237},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":49,"column":6,"offset":3244},"end":{"line":49,"column":18,"offset":3256},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":3243},"end":{"line":49,"column":46,"offset":3284},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":3243},"end":{"line":49,"column":46,"offset":3284},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3239},"end":{"line":49,"column":46,"offset":3284},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":50,"column":6,"offset":3290},"end":{"line":50,"column":29,"offset":3313},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":3289},"end":{"line":50,"column":59,"offset":3343},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":3289},"end":{"line":50,"column":59,"offset":3343},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3285},"end":{"line":50,"column":59,"offset":3343},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3239},"end":{"line":50,"column":59,"offset":3343},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":52,"column":1,"offset":3345},"end":{"line":52,"column":368,"offset":3712},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3345},"end":{"line":52,"column":368,"offset":3712},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":54,"column":1,"offset":3714},"end":{"line":54,"column":66,"offset":3779},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3714},"end":{"line":54,"column":66,"offset":3779},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":56,"column":5,"offset":3785},"end":{"line":56,"column":21,"offset":3801},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3781},"end":{"line":56,"column":21,"offset":3801},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":58,"column":1,"offset":3803},"end":{"line":58,"column":237,"offset":4039},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3803},"end":{"line":58,"column":237,"offset":4039},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":60,"column":1,"offset":4041},"end":{"line":60,"column":105,"offset":4145},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4041},"end":{"line":60,"column":105,"offset":4145},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":62,"column":1,"offset":4147},"end":{"line":62,"column":45,"offset":4191},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4147},"end":{"line":62,"column":45,"offset":4191},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":64,"column":3,"offset":4195},"end":{"line":64,"column":380,"offset":4572},"indent":[]}}],"position":{"start":{"line":64,"column":3,"offset":4195},"end":{"line":64,"column":380,"offset":4572},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4193},"end":{"line":65,"column":1,"offset":4573},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":66,"column":3,"offset":4576},"end":{"line":67,"column":49,"offset":4890},"indent":[2]}}],"position":{"start":{"line":66,"column":3,"offset":4576},"end":{"line":67,"column":49,"offset":4890},"indent":[2]}}],"position":{"start":{"line":66,"column":1,"offset":4574},"end":{"line":67,"column":49,"offset":4890},"indent":[1]}}],"position":{"start":{"line":64,"column":1,"offset":4193},"end":{"line":67,"column":49,"offset":4890},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":69,"column":5,"offset":4896},"end":{"line":69,"column":13,"offset":4904},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4892},"end":{"line":69,"column":13,"offset":4904},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":71,"column":1,"offset":4906},"end":{"line":71,"column":156,"offset":5061},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":71,"column":156,"offset":5061},"end":{"line":71,"column":177,"offset":5082},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":71,"column":177,"offset":5082},"end":{"line":71,"column":188,"offset":5093},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":71,"column":188,"offset":5093},"end":{"line":71,"column":193,"offset":5098},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":71,"column":193,"offset":5098},"end":{"line":71,"column":379,"offset":5284},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":4906},"end":{"line":71,"column":379,"offset":5284},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":73,"column":1,"offset":5286},"end":{"line":73,"column":68,"offset":5353},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5286},"end":{"line":73,"column":68,"offset":5353},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":75,"column":4,"offset":5358},"end":{"line":75,"column":13,"offset":5367},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5355},"end":{"line":75,"column":13,"offset":5367},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":77,"column":1,"offset":5369},"end":{"line":77,"column":44,"offset":5412},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":77,"column":46,"offset":5414},"end":{"line":77,"column":68,"offset":5436},"indent":[]}}],"position":{"start":{"line":77,"column":44,"offset":5412},"end":{"line":77,"column":70,"offset":5438},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":77,"column":70,"offset":5438},"end":{"line":77,"column":106,"offset":5474},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":77,"column":108,"offset":5476},"end":{"line":77,"column":129,"offset":5497},"indent":[]}}],"position":{"start":{"line":77,"column":106,"offset":5474},"end":{"line":77,"column":131,"offset":5499},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":77,"column":131,"offset":5499},"end":{"line":77,"column":159,"offset":5527},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":5369},"end":{"line":77,"column":159,"offset":5527},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":80,"column":1,"offset":5530},"end":{"line":80,"column":31,"offset":5560},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":80,"column":31,"offset":5560}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio.`}

\n

{`Despite the flexible storage capabilities, Kerberos Storage is also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations. It allows you to leverage a scalable and stable system as a strong backbone for your video analytics solutions, machine learning algorithms, and more.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-6a5f556b24198448892a97ab0e0122a3.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-6a5f556b24198448892a97ab0e0122a3.json new file mode 100644 index 0000000..a2f66b1 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-6a5f556b24198448892a97ab0e0122a3.json @@ -0,0 +1 @@ +{"expireTime":9007200861750534000,"key":"gatsby-plugin-mdx-entire-payload-143e1b9b0327216d3b87f5fa0c1e8894-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Enterprise","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.","position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}}],"position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Independent from that we've seen many vendors developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solutions with limited API's and/or messaging capabilities.","position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":280,"offset":1057},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":280,"offset":1057},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the start.","position":{"start":{"line":18,"column":1,"offset":1059},"end":{"line":18,"column":266,"offset":1324},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1059},"end":{"line":18,"column":266,"offset":1324},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":20,"column":1,"offset":1326},"end":{"line":22,"column":11,"offset":1528},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":24,"column":4,"offset":1533},"end":{"line":24,"column":14,"offset":1543},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1530},"end":{"line":24,"column":14,"offset":1543},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.","position":{"start":{"line":26,"column":1,"offset":1545},"end":{"line":26,"column":306,"offset":1850},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1545},"end":{"line":26,"column":306,"offset":1850},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":28,"column":1,"offset":1852},"end":{"line":28,"column":91,"offset":1942},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1852},"end":{"line":28,"column":91,"offset":1942},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).","position":{"start":{"line":30,"column":1,"offset":1944},"end":{"line":30,"column":239,"offset":2182},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1944},"end":{"line":30,"column":239,"offset":2182},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.","position":{"start":{"line":32,"column":1,"offset":2184},"end":{"line":32,"column":242,"offset":2425},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2184},"end":{"line":32,"column":242,"offset":2425},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.","position":{"start":{"line":34,"column":1,"offset":2427},"end":{"line":34,"column":205,"offset":2631},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2427},"end":{"line":34,"column":205,"offset":2631},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud or on premise","position":{"start":{"line":36,"column":4,"offset":2636},"end":{"line":36,"column":23,"offset":2655},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2633},"end":{"line":36,"column":23,"offset":2655},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.","position":{"start":{"line":38,"column":1,"offset":2657},"end":{"line":38,"column":283,"offset":2939},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2657},"end":{"line":38,"column":283,"offset":2939},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":40,"column":1,"offset":2941},"end":{"line":40,"column":97,"offset":3037},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2941},"end":{"line":40,"column":97,"offset":3037},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":42,"column":4,"offset":3042},"end":{"line":42,"column":13,"offset":3051},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":3039},"end":{"line":42,"column":13,"offset":3051},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is publicly available and ","position":{"start":{"line":44,"column":1,"offset":3053},"end":{"line":44,"column":47,"offset":3099},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":44,"column":49,"offset":3101},"end":{"line":44,"column":57,"offset":3109},"indent":[]}}],"position":{"start":{"line":44,"column":47,"offset":3099},"end":{"line":44,"column":59,"offset":3111},"indent":[]}},{"type":"text","value":" require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.","position":{"start":{"line":44,"column":59,"offset":3111},"end":{"line":44,"column":174,"offset":3226},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":3053},"end":{"line":44,"column":174,"offset":3226},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":47,"column":1,"offset":3229},"end":{"line":47,"column":31,"offset":3259},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":47,"column":31,"offset":3259}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Enterprise`}

\n

{`Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.`}

\n

{`That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.`}

\n

{`Independent from that we've seen many vendors developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solutions with limited API's and/or messaging capabilities.`}

\n

{`Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the start.`}

\n
\n
\n

\n

{`Kubernetes`}

\n

{`To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.`}

\n

\"architecture

\n

{`Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).`}

\n

{`Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.`}

\n

{`By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.`}

\n

{`Cloud or on premise`}

\n

{`You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.`}

\n

\"architecture

\n

{`Licensing`}

\n

{`Kerberos Enterprise is publicly available and `}{`does not`}{` require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-6bc340efc47266c728fc1d95f1e6b4f0.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-6bc340efc47266c728fc1d95f1e6b4f0.json new file mode 100644 index 0000000..7c05290 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-6bc340efc47266c728fc1d95f1e6b4f0.json @@ -0,0 +1 @@ +{"expireTime":9007200861750452000,"key":"gatsby-plugin-mdx-entire-payload-beab0e6634c8e4fb8622f184972eace0-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Enterprise","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.","position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}}],"position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Independent from that we've seen many vendors started developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solution with limited API's and/or messaging capabilities.","position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":287,"offset":1064},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":287,"offset":1064},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the start.","position":{"start":{"line":18,"column":1,"offset":1066},"end":{"line":18,"column":266,"offset":1331},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1066},"end":{"line":18,"column":266,"offset":1331},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":20,"column":1,"offset":1333},"end":{"line":22,"column":11,"offset":1535},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":24,"column":4,"offset":1540},"end":{"line":24,"column":14,"offset":1550},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1537},"end":{"line":24,"column":14,"offset":1550},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.","position":{"start":{"line":26,"column":1,"offset":1552},"end":{"line":26,"column":306,"offset":1857},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1552},"end":{"line":26,"column":306,"offset":1857},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":28,"column":1,"offset":1859},"end":{"line":28,"column":91,"offset":1949},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1859},"end":{"line":28,"column":91,"offset":1949},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).","position":{"start":{"line":30,"column":1,"offset":1951},"end":{"line":30,"column":239,"offset":2189},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1951},"end":{"line":30,"column":239,"offset":2189},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.","position":{"start":{"line":32,"column":1,"offset":2191},"end":{"line":32,"column":242,"offset":2432},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2191},"end":{"line":32,"column":242,"offset":2432},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.","position":{"start":{"line":34,"column":1,"offset":2434},"end":{"line":34,"column":205,"offset":2638},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2434},"end":{"line":34,"column":205,"offset":2638},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud or on premise","position":{"start":{"line":36,"column":4,"offset":2643},"end":{"line":36,"column":23,"offset":2662},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2640},"end":{"line":36,"column":23,"offset":2662},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.","position":{"start":{"line":38,"column":1,"offset":2664},"end":{"line":38,"column":283,"offset":2946},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2664},"end":{"line":38,"column":283,"offset":2946},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":40,"column":1,"offset":2948},"end":{"line":40,"column":97,"offset":3044},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2948},"end":{"line":40,"column":97,"offset":3044},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":42,"column":4,"offset":3049},"end":{"line":42,"column":13,"offset":3058},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":3046},"end":{"line":42,"column":13,"offset":3058},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is publicly available and ","position":{"start":{"line":44,"column":1,"offset":3060},"end":{"line":44,"column":47,"offset":3106},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":44,"column":49,"offset":3108},"end":{"line":44,"column":57,"offset":3116},"indent":[]}}],"position":{"start":{"line":44,"column":47,"offset":3106},"end":{"line":44,"column":59,"offset":3118},"indent":[]}},{"type":"text","value":" require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.","position":{"start":{"line":44,"column":59,"offset":3118},"end":{"line":44,"column":174,"offset":3233},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":3060},"end":{"line":44,"column":174,"offset":3233},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":47,"column":1,"offset":3236},"end":{"line":47,"column":31,"offset":3266},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":47,"column":31,"offset":3266}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Enterprise`}

\n

{`Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.`}

\n

{`That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.`}

\n

{`Independent from that we've seen many vendors started developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solution with limited API's and/or messaging capabilities.`}

\n

{`Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the start.`}

\n
\n
\n

\n

{`Kubernetes`}

\n

{`To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.`}

\n

\"architecture

\n

{`Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).`}

\n

{`Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.`}

\n

{`By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.`}

\n

{`Cloud or on premise`}

\n

{`You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.`}

\n

\"architecture

\n

{`Licensing`}

\n

{`Kerberos Enterprise is publicly available and `}{`does not`}{` require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-713e5d08807a4ab966d052fc8403ca47.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-713e5d08807a4ab966d052fc8403ca47.json new file mode 100644 index 0000000..810d0ea --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-713e5d08807a4ab966d052fc8403ca47.json @@ -0,0 +1 @@ +{"expireTime":9007200861829100000,"key":"gatsby-plugin-mdx-entire-payload-9c66736faa6150348c65f4b103f1fe97-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":77,"offset":412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":78,"offset":413},"end":{"line":12,"column":92,"offset":427},"indent":[]}}],"position":{"start":{"line":12,"column":77,"offset":412},"end":{"line":12,"column":101,"offset":436},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers.","position":{"start":{"line":12,"column":101,"offset":436},"end":{"line":12,"column":166,"offset":501},"indent":[]}}],"position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":166,"offset":501},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":166,"offset":501},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":13,"column":4,"offset":505},"end":{"line":13,"column":577,"offset":1078},"indent":[]}}],"position":{"start":{"line":13,"column":4,"offset":505},"end":{"line":13,"column":577,"offset":1078},"indent":[]}}],"position":{"start":{"line":13,"column":1,"offset":502},"end":{"line":13,"column":577,"offset":1078},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":13,"column":577,"offset":1078},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":15,"column":4,"offset":1083},"end":{"line":15,"column":18,"offset":1097},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":1080},"end":{"line":15,"column":18,"offset":1097},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":17,"column":1,"offset":1099},"end":{"line":17,"column":291,"offset":1389},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":17,"column":292,"offset":1390},"end":{"line":17,"column":309,"offset":1407},"indent":[]}}],"position":{"start":{"line":17,"column":291,"offset":1389},"end":{"line":17,"column":318,"offset":1416},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":17,"column":318,"offset":1416},"end":{"line":17,"column":319,"offset":1417},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":1099},"end":{"line":17,"column":319,"offset":1417},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":19,"column":1,"offset":1419},"end":{"line":19,"column":56,"offset":1474},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":1419},"end":{"line":19,"column":56,"offset":1474},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":21,"column":4,"offset":1479},"end":{"line":21,"column":20,"offset":1495},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1476},"end":{"line":21,"column":20,"offset":1495},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":23,"column":1,"offset":1497},"end":{"line":23,"column":253,"offset":1749},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1497},"end":{"line":23,"column":253,"offset":1749},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":25,"column":6,"offset":1756},"end":{"line":25,"column":35,"offset":1785},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1755},"end":{"line":25,"column":70,"offset":1820},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1755},"end":{"line":25,"column":70,"offset":1820},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1751},"end":{"line":25,"column":70,"offset":1820},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":26,"column":6,"offset":1826},"end":{"line":26,"column":29,"offset":1849},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1825},"end":{"line":26,"column":83,"offset":1903},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1825},"end":{"line":26,"column":83,"offset":1903},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1821},"end":{"line":26,"column":83,"offset":1903},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":27,"column":6,"offset":1909},"end":{"line":27,"column":28,"offset":1931},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1908},"end":{"line":27,"column":57,"offset":1960},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1908},"end":{"line":27,"column":57,"offset":1960},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1904},"end":{"line":27,"column":57,"offset":1960},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":28,"column":6,"offset":1966},"end":{"line":28,"column":11,"offset":1971},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":1965},"end":{"line":28,"column":29,"offset":1989},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":1965},"end":{"line":28,"column":29,"offset":1989},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1961},"end":{"line":28,"column":29,"offset":1989},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1751},"end":{"line":28,"column":29,"offset":1989},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":30,"column":1,"offset":1991},"end":{"line":30,"column":190,"offset":2180},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1991},"end":{"line":30,"column":190,"offset":2180},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":32,"column":1,"offset":2182},"end":{"line":32,"column":99,"offset":2280},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2182},"end":{"line":32,"column":99,"offset":2280},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":34,"column":1,"offset":2282},"end":{"line":34,"column":220,"offset":2501},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2282},"end":{"line":34,"column":220,"offset":2501},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":36,"column":1,"offset":2503},"end":{"line":36,"column":98,"offset":2600},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2503},"end":{"line":36,"column":98,"offset":2600},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":38,"column":5,"offset":2606},"end":{"line":38,"column":11,"offset":2612},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2602},"end":{"line":38,"column":11,"offset":2612},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":40,"column":1,"offset":2614},"end":{"line":40,"column":303,"offset":2916},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2614},"end":{"line":40,"column":303,"offset":2916},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":42,"column":6,"offset":2923},"end":{"line":42,"column":18,"offset":2935},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2922},"end":{"line":42,"column":46,"offset":2963},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2922},"end":{"line":42,"column":46,"offset":2963},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2918},"end":{"line":42,"column":46,"offset":2963},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":43,"column":6,"offset":2969},"end":{"line":43,"column":29,"offset":2992},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":2968},"end":{"line":43,"column":59,"offset":3022},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":2968},"end":{"line":43,"column":59,"offset":3022},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2964},"end":{"line":43,"column":59,"offset":3022},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2918},"end":{"line":43,"column":59,"offset":3022},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":45,"column":1,"offset":3024},"end":{"line":45,"column":368,"offset":3391},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":3024},"end":{"line":45,"column":368,"offset":3391},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":47,"column":1,"offset":3393},"end":{"line":47,"column":66,"offset":3458},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3393},"end":{"line":47,"column":66,"offset":3458},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":49,"column":5,"offset":3464},"end":{"line":49,"column":21,"offset":3480},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3460},"end":{"line":49,"column":21,"offset":3480},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":51,"column":1,"offset":3482},"end":{"line":51,"column":237,"offset":3718},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":3482},"end":{"line":51,"column":237,"offset":3718},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":53,"column":1,"offset":3720},"end":{"line":53,"column":105,"offset":3824},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":3720},"end":{"line":53,"column":105,"offset":3824},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":55,"column":1,"offset":3826},"end":{"line":55,"column":45,"offset":3870},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":3826},"end":{"line":55,"column":45,"offset":3870},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":57,"column":3,"offset":3874},"end":{"line":57,"column":380,"offset":4251},"indent":[]}}],"position":{"start":{"line":57,"column":3,"offset":3874},"end":{"line":57,"column":380,"offset":4251},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":3872},"end":{"line":58,"column":1,"offset":4252},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":59,"column":3,"offset":4255},"end":{"line":60,"column":49,"offset":4569},"indent":[2]}}],"position":{"start":{"line":59,"column":3,"offset":4255},"end":{"line":60,"column":49,"offset":4569},"indent":[2]}}],"position":{"start":{"line":59,"column":1,"offset":4253},"end":{"line":60,"column":49,"offset":4569},"indent":[1]}}],"position":{"start":{"line":57,"column":1,"offset":3872},"end":{"line":60,"column":49,"offset":4569},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":62,"column":5,"offset":4575},"end":{"line":62,"column":13,"offset":4583},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4571},"end":{"line":62,"column":13,"offset":4583},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":64,"column":1,"offset":4585},"end":{"line":64,"column":156,"offset":4740},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":64,"column":156,"offset":4740},"end":{"line":64,"column":177,"offset":4761},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":64,"column":177,"offset":4761},"end":{"line":64,"column":188,"offset":4772},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":64,"column":188,"offset":4772},"end":{"line":64,"column":193,"offset":4777},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":64,"column":193,"offset":4777},"end":{"line":64,"column":379,"offset":4963},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4585},"end":{"line":64,"column":379,"offset":4963},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":66,"column":1,"offset":4965},"end":{"line":66,"column":68,"offset":5032},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":4965},"end":{"line":66,"column":68,"offset":5032},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":68,"column":4,"offset":5037},"end":{"line":68,"column":13,"offset":5046},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":5034},"end":{"line":68,"column":13,"offset":5046},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":70,"column":1,"offset":5048},"end":{"line":70,"column":44,"offset":5091},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":70,"column":46,"offset":5093},"end":{"line":70,"column":68,"offset":5115},"indent":[]}}],"position":{"start":{"line":70,"column":44,"offset":5091},"end":{"line":70,"column":70,"offset":5117},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":70,"column":70,"offset":5117},"end":{"line":70,"column":106,"offset":5153},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":70,"column":108,"offset":5155},"end":{"line":70,"column":129,"offset":5176},"indent":[]}}],"position":{"start":{"line":70,"column":106,"offset":5153},"end":{"line":70,"column":131,"offset":5178},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":70,"column":131,"offset":5178},"end":{"line":70,"column":159,"offset":5206},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":5048},"end":{"line":70,"column":159,"offset":5206},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":73,"column":1,"offset":5209},"end":{"line":73,"column":31,"offset":5239},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":73,"column":31,"offset":5239}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n
    \n
  1. {`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers.`}
    2. \n
  2. {`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}
    3. \n
\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-786c8510ff4cb2aa146f2fa0c41b45a3.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-786c8510ff4cb2aa146f2fa0c41b45a3.json new file mode 100644 index 0000000..0cc8c93 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-786c8510ff4cb2aa146f2fa0c41b45a3.json @@ -0,0 +1 @@ +{"expireTime":9007200861829447000,"key":"gatsby-plugin-mdx-entire-payload-95545010a3f3bd84e221069e9a9004b8-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and makes it possible to be attached to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":212,"offset":865},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":213,"offset":866},"end":{"line":18,"column":227,"offset":880},"indent":[]}}],"position":{"start":{"line":18,"column":212,"offset":865},"end":{"line":18,"column":236,"offset":889},"indent":[]}},{"type":"text","value":" in parrallel. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":18,"column":236,"offset":889},"end":{"line":18,"column":653,"offset":1306},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":653,"offset":1306},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":20,"column":4,"offset":1311},"end":{"line":20,"column":18,"offset":1325},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1308},"end":{"line":20,"column":18,"offset":1325},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":22,"column":1,"offset":1327},"end":{"line":22,"column":291,"offset":1617},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":22,"column":292,"offset":1618},"end":{"line":22,"column":309,"offset":1635},"indent":[]}}],"position":{"start":{"line":22,"column":291,"offset":1617},"end":{"line":22,"column":318,"offset":1644},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":22,"column":318,"offset":1644},"end":{"line":22,"column":319,"offset":1645},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1327},"end":{"line":22,"column":319,"offset":1645},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":24,"column":1,"offset":1647},"end":{"line":24,"column":56,"offset":1702},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1647},"end":{"line":24,"column":56,"offset":1702},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":26,"column":4,"offset":1707},"end":{"line":26,"column":20,"offset":1723},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1704},"end":{"line":26,"column":20,"offset":1723},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":28,"column":1,"offset":1725},"end":{"line":28,"column":253,"offset":1977},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1725},"end":{"line":28,"column":253,"offset":1977},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":30,"column":6,"offset":1984},"end":{"line":30,"column":35,"offset":2013},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1983},"end":{"line":30,"column":70,"offset":2048},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1983},"end":{"line":30,"column":70,"offset":2048},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1979},"end":{"line":30,"column":70,"offset":2048},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":31,"column":6,"offset":2054},"end":{"line":31,"column":29,"offset":2077},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2053},"end":{"line":31,"column":83,"offset":2131},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2053},"end":{"line":31,"column":83,"offset":2131},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":2049},"end":{"line":31,"column":83,"offset":2131},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":32,"column":6,"offset":2137},"end":{"line":32,"column":28,"offset":2159},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2136},"end":{"line":32,"column":57,"offset":2188},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2136},"end":{"line":32,"column":57,"offset":2188},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2132},"end":{"line":32,"column":57,"offset":2188},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":33,"column":6,"offset":2194},"end":{"line":33,"column":11,"offset":2199},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2193},"end":{"line":33,"column":29,"offset":2217},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2193},"end":{"line":33,"column":29,"offset":2217},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2189},"end":{"line":33,"column":29,"offset":2217},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1979},"end":{"line":33,"column":29,"offset":2217},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":35,"column":1,"offset":2219},"end":{"line":35,"column":190,"offset":2408},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2219},"end":{"line":35,"column":190,"offset":2408},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":37,"column":1,"offset":2410},"end":{"line":37,"column":99,"offset":2508},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2410},"end":{"line":37,"column":99,"offset":2508},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":39,"column":1,"offset":2510},"end":{"line":39,"column":220,"offset":2729},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2510},"end":{"line":39,"column":220,"offset":2729},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":41,"column":1,"offset":2731},"end":{"line":41,"column":98,"offset":2828},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2731},"end":{"line":41,"column":98,"offset":2828},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":43,"column":5,"offset":2834},"end":{"line":43,"column":11,"offset":2840},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2830},"end":{"line":43,"column":11,"offset":2840},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":45,"column":1,"offset":2842},"end":{"line":45,"column":303,"offset":3144},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2842},"end":{"line":45,"column":303,"offset":3144},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":47,"column":6,"offset":3151},"end":{"line":47,"column":18,"offset":3163},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3150},"end":{"line":47,"column":46,"offset":3191},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3150},"end":{"line":47,"column":46,"offset":3191},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3146},"end":{"line":47,"column":46,"offset":3191},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":48,"column":6,"offset":3197},"end":{"line":48,"column":29,"offset":3220},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3196},"end":{"line":48,"column":59,"offset":3250},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3196},"end":{"line":48,"column":59,"offset":3250},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":3192},"end":{"line":48,"column":59,"offset":3250},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3146},"end":{"line":48,"column":59,"offset":3250},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":50,"column":1,"offset":3252},"end":{"line":50,"column":368,"offset":3619},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3252},"end":{"line":50,"column":368,"offset":3619},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":52,"column":1,"offset":3621},"end":{"line":52,"column":66,"offset":3686},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3621},"end":{"line":52,"column":66,"offset":3686},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":54,"column":5,"offset":3692},"end":{"line":54,"column":21,"offset":3708},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3688},"end":{"line":54,"column":21,"offset":3708},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":56,"column":1,"offset":3710},"end":{"line":56,"column":237,"offset":3946},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3710},"end":{"line":56,"column":237,"offset":3946},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":58,"column":1,"offset":3948},"end":{"line":58,"column":105,"offset":4052},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3948},"end":{"line":58,"column":105,"offset":4052},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":60,"column":1,"offset":4054},"end":{"line":60,"column":45,"offset":4098},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4054},"end":{"line":60,"column":45,"offset":4098},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":62,"column":3,"offset":4102},"end":{"line":62,"column":380,"offset":4479},"indent":[]}}],"position":{"start":{"line":62,"column":3,"offset":4102},"end":{"line":62,"column":380,"offset":4479},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4100},"end":{"line":63,"column":1,"offset":4480},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":64,"column":3,"offset":4483},"end":{"line":65,"column":49,"offset":4797},"indent":[2]}}],"position":{"start":{"line":64,"column":3,"offset":4483},"end":{"line":65,"column":49,"offset":4797},"indent":[2]}}],"position":{"start":{"line":64,"column":1,"offset":4481},"end":{"line":65,"column":49,"offset":4797},"indent":[1]}}],"position":{"start":{"line":62,"column":1,"offset":4100},"end":{"line":65,"column":49,"offset":4797},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":67,"column":5,"offset":4803},"end":{"line":67,"column":13,"offset":4811},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":4799},"end":{"line":67,"column":13,"offset":4811},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":69,"column":1,"offset":4813},"end":{"line":69,"column":156,"offset":4968},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":69,"column":156,"offset":4968},"end":{"line":69,"column":177,"offset":4989},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":69,"column":177,"offset":4989},"end":{"line":69,"column":188,"offset":5000},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":69,"column":188,"offset":5000},"end":{"line":69,"column":193,"offset":5005},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":69,"column":193,"offset":5005},"end":{"line":69,"column":379,"offset":5191},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4813},"end":{"line":69,"column":379,"offset":5191},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":71,"column":1,"offset":5193},"end":{"line":71,"column":68,"offset":5260},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":5193},"end":{"line":71,"column":68,"offset":5260},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":73,"column":4,"offset":5265},"end":{"line":73,"column":13,"offset":5274},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5262},"end":{"line":73,"column":13,"offset":5274},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":75,"column":1,"offset":5276},"end":{"line":75,"column":44,"offset":5319},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":75,"column":46,"offset":5321},"end":{"line":75,"column":68,"offset":5343},"indent":[]}}],"position":{"start":{"line":75,"column":44,"offset":5319},"end":{"line":75,"column":70,"offset":5345},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":75,"column":70,"offset":5345},"end":{"line":75,"column":106,"offset":5381},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":75,"column":108,"offset":5383},"end":{"line":75,"column":129,"offset":5404},"indent":[]}}],"position":{"start":{"line":75,"column":106,"offset":5381},"end":{"line":75,"column":131,"offset":5406},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":75,"column":131,"offset":5406},"end":{"line":75,"column":159,"offset":5434},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5276},"end":{"line":75,"column":159,"offset":5434},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":78,"column":1,"offset":5437},"end":{"line":78,"column":31,"offset":5467},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":78,"column":31,"offset":5467}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and makes it possible to be attached to `}{`Kerberos Cloud`}{` in parrallel. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-7cd80d2cdee97c73b41029f93671eb05.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-7cd80d2cdee97c73b41029f93671eb05.json new file mode 100644 index 0000000..6f25358 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-7cd80d2cdee97c73b41029f93671eb05.json @@ -0,0 +1 @@ +{"expireTime":9007200861859888000,"key":"gatsby-plugin-mdx-entire-payload-f080aed07a18b9130eb35bcf7e8d72d4-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":15,"offset":173},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":15,"offset":173},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If not already the case, start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (","position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":113,"offset":287},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"AWS","position":{"start":{"line":10,"column":115,"offset":289},"end":{"line":10,"column":118,"offset":292},"indent":[]}}],"position":{"start":{"line":10,"column":113,"offset":287},"end":{"line":10,"column":120,"offset":294},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":10,"column":120,"offset":294},"end":{"line":10,"column":122,"offset":296},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"GCP","position":{"start":{"line":10,"column":124,"offset":298},"end":{"line":10,"column":127,"offset":301},"indent":[]}}],"position":{"start":{"line":10,"column":122,"offset":296},"end":{"line":10,"column":129,"offset":303},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":10,"column":129,"offset":303},"end":{"line":10,"column":133,"offset":307},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Azure","position":{"start":{"line":10,"column":135,"offset":309},"end":{"line":10,"column":140,"offset":314},"indent":[]}}],"position":{"start":{"line":10,"column":133,"offset":307},"end":{"line":10,"column":142,"offset":316},"indent":[]}},{"type":"text","value":"), cloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.","position":{"start":{"line":10,"column":142,"offset":316},"end":{"line":10,"column":234,"offset":408},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":234,"offset":408},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":12,"column":1,"offset":410},"end":{"line":14,"column":11,"offset":612},"indent":[1,1]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":16,"column":3,"offset":616},"end":{"line":16,"column":16,"offset":629},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":614},"end":{"line":16,"column":16,"offset":629},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is the storage component for Kerberos Enterprise. It is used to store your recordings at a central place, in the storage system you prefer. Next to that it can be used for extension and integration capabilities. Learn more about ","position":{"start":{"line":18,"column":1,"offset":631},"end":{"line":18,"column":247,"offset":877},"indent":[]}},{"type":"link","title":null,"url":"/storage","children":[{"type":"text","value":"Kerberos Storage here","position":{"start":{"line":18,"column":248,"offset":878},"end":{"line":18,"column":269,"offset":899},"indent":[]}}],"position":{"start":{"line":18,"column":247,"offset":877},"end":{"line":18,"column":280,"offset":910},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":18,"column":280,"offset":910},"end":{"line":18,"column":281,"offset":911},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":631},"end":{"line":18,"column":281,"offset":911},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To use Kerberos Storage, you will need to have Kerberos Enterprise installed, and deployments running. Independent from that one can also use the Kerberos Storage API ","position":{"start":{"line":20,"column":1,"offset":913},"end":{"line":20,"column":168,"offset":1080},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":20,"column":168,"offset":1080},"end":{"line":20,"column":189,"offset":1101},"indent":[]}},{"type":"text","value":" to send recordings from a custom build VMS.","position":{"start":{"line":20,"column":189,"offset":1101},"end":{"line":20,"column":233,"offset":1145},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":913},"end":{"line":20,"column":233,"offset":1145},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":22,"column":3,"offset":1149},"end":{"line":22,"column":15,"offset":1161},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1147},"end":{"line":22,"column":15,"offset":1161},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to Kerberos Enterprise, Kerberos Storage, requires some initial components to be installed. If you will run Kerberos Storage in the same cluster as where you have Kerberos Enterprise running, there is not much to do.","position":{"start":{"line":24,"column":1,"offset":1163},"end":{"line":24,"column":225,"offset":1387},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1163},"end":{"line":24,"column":225,"offset":1387},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":26,"column":1,"offset":1389},"end":{"line":26,"column":99,"offset":1487},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1389},"end":{"line":26,"column":99,"offset":1487},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"However if you plan to run Kerberos Storage in a different cluster (which is perfectly possible), you will need to make sure you complete the initial setup of ","position":{"start":{"line":28,"column":1,"offset":1489},"end":{"line":28,"column":160,"offset":1648},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/installation","children":[{"type":"text","value":"Kerberos Enterprise installation","position":{"start":{"line":28,"column":161,"offset":1649},"end":{"line":28,"column":193,"offset":1681},"indent":[]}}],"position":{"start":{"line":28,"column":160,"offset":1648},"end":{"line":28,"column":220,"offset":1708},"indent":[]}},{"type":"text","value":". To be more specific you will need the following components running:","position":{"start":{"line":28,"column":220,"offset":1708},"end":{"line":28,"column":289,"offset":1777},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1489},"end":{"line":28,"column":289,"offset":1777},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Helm","position":{"start":{"line":30,"column":3,"offset":1781},"end":{"line":30,"column":7,"offset":1785},"indent":[]}}],"position":{"start":{"line":30,"column":3,"offset":1781},"end":{"line":30,"column":7,"offset":1785},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1779},"end":{"line":30,"column":7,"offset":1785},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":31,"column":3,"offset":1788},"end":{"line":31,"column":10,"offset":1795},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1788},"end":{"line":31,"column":10,"offset":1795},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1786},"end":{"line":31,"column":10,"offset":1795},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":32,"column":3,"offset":1798},"end":{"line":32,"column":10,"offset":1805},"indent":[]}}],"position":{"start":{"line":32,"column":3,"offset":1798},"end":{"line":32,"column":10,"offset":1805},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1796},"end":{"line":32,"column":10,"offset":1805},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1779},"end":{"line":32,"column":10,"offset":1805},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once this is done start by cloning the configurations from our ","position":{"start":{"line":34,"column":1,"offset":1807},"end":{"line":34,"column":64,"offset":1870},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/storage","children":[{"type":"text","value":"Github repo","position":{"start":{"line":34,"column":65,"offset":1871},"end":{"line":34,"column":76,"offset":1882},"indent":[]}}],"position":{"start":{"line":34,"column":64,"offset":1870},"end":{"line":34,"column":117,"offset":1923},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":34,"column":117,"offset":1923},"end":{"line":34,"column":118,"offset":1924},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":1807},"end":{"line":34,"column":118,"offset":1924},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/storage","position":{"start":{"line":36,"column":1,"offset":1926},"end":{"line":36,"column":53,"offset":1978},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage","position":{"start":{"line":38,"column":4,"offset":1983},"end":{"line":38,"column":11,"offset":1990},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1980},"end":{"line":38,"column":11,"offset":1990},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to Kerberos Enterprise, Kerberos Storage is managed through a web app. It allows you to add storage providers (S3, minio, etc), add queues for messaging, accounts for security and much more. It also comes with API's, which you can use to interact and retrieve information from Kerberos Storage. All is documented in the form of Swagger APIs ","position":{"start":{"line":40,"column":1,"offset":1992},"end":{"line":40,"column":350,"offset":2341},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":40,"column":350,"offset":2341},"end":{"line":40,"column":371,"offset":2362},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":40,"column":371,"offset":2362},"end":{"line":40,"column":372,"offset":2363},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1992},"end":{"line":40,"column":372,"offset":2363},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing Kerberos Storage, open the ","position":{"start":{"line":42,"column":1,"offset":2365},"end":{"line":42,"column":46,"offset":2410},"indent":[]}},{"type":"inlineCode","value":"./storage/yaml/deployment.yaml","position":{"start":{"line":42,"column":46,"offset":2410},"end":{"line":42,"column":78,"offset":2442},"indent":[]}},{"type":"text","value":" configuration file. At the bottom file you will find two endpoints, similar to the Traefik config file below. Update the domain names to your own domain, and add these to your DNS server or ","position":{"start":{"line":42,"column":78,"offset":2442},"end":{"line":42,"column":269,"offset":2633},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":42,"column":269,"offset":2633},"end":{"line":42,"column":281,"offset":2645},"indent":[]}},{"type":"text","value":" file (and point to the same IP as the Traefik EXTERNAL-IP).","position":{"start":{"line":42,"column":281,"offset":2645},"end":{"line":42,"column":341,"offset":2705},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2365},"end":{"line":42,"column":341,"offset":2705},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: storage.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: kerberos-storage\n servicePort: 80\n--> - host: api.storage.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: kerberos-storage\n servicePort: 8081","position":{"start":{"line":44,"column":1,"offset":2707},"end":{"line":59,"column":36,"offset":3157},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Ingress Nginx, do not forgot to comment ","position":{"start":{"line":61,"column":1,"offset":3159},"end":{"line":61,"column":58,"offset":3216},"indent":[]}},{"type":"inlineCode","value":"Traefik","position":{"start":{"line":61,"column":58,"offset":3216},"end":{"line":61,"column":67,"offset":3225},"indent":[]}},{"type":"text","value":" and uncomment ","position":{"start":{"line":61,"column":67,"offset":3225},"end":{"line":61,"column":82,"offset":3240},"indent":[]}},{"type":"inlineCode","value":"Ingress Nginx","position":{"start":{"line":61,"column":82,"offset":3240},"end":{"line":61,"column":97,"offset":3255},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":61,"column":97,"offset":3255},"end":{"line":61,"column":98,"offset":3256},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3159},"end":{"line":61,"column":98,"offset":3256},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"apiVersion: extensions/v1beta1\nkind: Ingress\nmetadata:\n name: kerberos-storage\n annotations:\n #kubernetes.io/ingress.class: traefik\n kubernetes.io/ingress.class: nginx\n nginx.ingress.kubernetes.io/proxy-body-size: 200m","position":{"start":{"line":63,"column":1,"offset":3258},"end":{"line":70,"column":58,"offset":3519},"indent":[1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":72,"column":1,"offset":3521},"end":{"line":72,"column":112,"offset":3632},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3521},"end":{"line":72,"column":112,"offset":3632},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":74,"column":1,"offset":3634},"end":{"line":77,"column":30,"offset":3753},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names and MongoDB credentials, install Kerberos Storage inside your cluster.","position":{"start":{"line":79,"column":1,"offset":3755},"end":{"line":79,"column":109,"offset":3863},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3755},"end":{"line":79,"column":109,"offset":3863},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./storage/yaml/deployment.yaml","position":{"start":{"line":81,"column":1,"offset":3865},"end":{"line":81,"column":52,"offset":3916},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":83,"column":4,"offset":3921},"end":{"line":83,"column":26,"offset":3943},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":3918},"end":{"line":83,"column":26,"offset":3943},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":85,"column":1,"offset":3945},"end":{"line":85,"column":94,"offset":4038},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":3945},"end":{"line":85,"column":94,"offset":4038},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":87,"column":5,"offset":4044},"end":{"line":87,"column":12,"offset":4051},"indent":[]}}],"position":{"start":{"line":87,"column":5,"offset":4044},"end":{"line":87,"column":12,"offset":4051},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4040},"end":{"line":87,"column":12,"offset":4051},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":88,"column":5,"offset":4056},"end":{"line":88,"column":12,"offset":4063},"indent":[]}}],"position":{"start":{"line":88,"column":5,"offset":4056},"end":{"line":88,"column":12,"offset":4063},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":4052},"end":{"line":88,"column":12,"offset":4063},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Storage","position":{"start":{"line":89,"column":5,"offset":4068},"end":{"line":89,"column":12,"offset":4075},"indent":[]}}],"position":{"start":{"line":89,"column":5,"offset":4068},"end":{"line":89,"column":12,"offset":4075},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4064},"end":{"line":89,"column":12,"offset":4075},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Enterprise (optional)","position":{"start":{"line":90,"column":5,"offset":4080},"end":{"line":90,"column":26,"offset":4101},"indent":[]}}],"position":{"start":{"line":90,"column":5,"offset":4080},"end":{"line":90,"column":26,"offset":4101},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4076},"end":{"line":90,"column":26,"offset":4101},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4040},"end":{"line":90,"column":26,"offset":4101},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":92,"column":1,"offset":4103},"end":{"line":92,"column":26,"offset":4128},"indent":[]}}],"position":{"start":{"line":92,"column":1,"offset":4103},"end":{"line":92,"column":26,"offset":4128},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nkerberos-storage-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-55566dc65c-xgmns 2/2 Running 0 4d13h\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":94,"column":1,"offset":4130},"end":{"line":98,"column":73,"offset":4442},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":100,"column":4,"offset":4447},"end":{"line":100,"column":21,"offset":4464},"indent":[]}}],"position":{"start":{"line":100,"column":1,"offset":4444},"end":{"line":100,"column":21,"offset":4464},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS or ","position":{"start":{"line":102,"column":1,"offset":4466},"end":{"line":102,"column":65,"offset":4530},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":102,"column":65,"offset":4530},"end":{"line":102,"column":77,"offset":4542},"indent":[]}},{"type":"text","value":" file, you should be able to access the Storage application. By navigating to the Storage domain ","position":{"start":{"line":102,"column":77,"offset":4542},"end":{"line":102,"column":174,"offset":4639},"indent":[]}},{"type":"inlineCode","value":"storage.domain.com","position":{"start":{"line":102,"column":174,"offset":4639},"end":{"line":102,"column":194,"offset":4659},"indent":[]}},{"type":"text","value":" in your browser you will see the Storage login page showing up.","position":{"start":{"line":102,"column":194,"offset":4659},"end":{"line":102,"column":258,"offset":4723},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":4466},"end":{"line":102,"column":258,"offset":4723},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Storage","position":{"start":{"line":104,"column":1,"offset":4725},"end":{"line":104,"column":71,"offset":4795},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":4725},"end":{"line":104,"column":71,"offset":4795},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":107,"column":1,"offset":4798},"end":{"line":107,"column":31,"offset":4828},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":107,"column":31,"offset":4828}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Introduction`}

\n

{`If not already the case, start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (`}{`AWS`}{`, `}{`GCP`}{` or `}{`Azure`}{`), cloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.`}

\n
\n
\n

\n

{`Prerequisites`}

\n

{`Kerberos Storage is the storage component for Kerberos Enterprise. It is used to store your recordings at a central place, in the storage system you prefer. Next to that it can be used for extension and integration capabilities. Learn more about `}{`Kerberos Storage here`}{`.`}

\n

{`To use Kerberos Storage, you will need to have Kerberos Enterprise installed, and deployments running. Independent from that one can also use the Kerberos Storage API `}{`/swagger/index.html`}{` to send recordings from a custom build VMS.`}

\n

{`Installation`}

\n

{`Similar to Kerberos Enterprise, Kerberos Storage, requires some initial components to be installed. If you will run Kerberos Storage in the same cluster as where you have Kerberos Enterprise running, there is not much to do.`}

\n

\"architecture

\n

{`However if you plan to run Kerberos Storage in a different cluster (which is perfectly possible), you will need to make sure you complete the initial setup of `}{`Kerberos Enterprise installation`}{`. To be more specific you will need the following components running:`}

\n
    \n
  • {`Helm`}
    • \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
\n

{`Once this is done start by cloning the configurations from our `}{`Github repo`}{`.`}

\n 
{`git clone https://github.com/kerberos-io/storage`}
\n

{`Storage`}

\n

{`Similar to Kerberos Enterprise, Kerberos Storage is managed through a web app. It allows you to add storage providers (S3, minio, etc), add queues for messaging, accounts for security and much more. It also comes with API's, which you can use to interact and retrieve information from Kerberos Storage. All is documented in the form of Swagger APIs `}{`/swagger/index.html`}{`.`}

\n

{`Before installing Kerberos Storage, open the `}{`./storage/yaml/deployment.yaml`}{` configuration file. At the bottom file you will find two endpoints, similar to the Traefik config file below. Update the domain names to your own domain, and add these to your DNS server or `}{`/etc/hosts`}{` file (and point to the same IP as the Traefik EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: storage.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: kerberos-storage`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.storage.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: kerberos-storage`}{`\n`}{`              servicePort: 8081`}
\n

{`If you are using Ingress Nginx, do not forgot to comment `}{`Traefik`}{` and uncomment `}{`Ingress Nginx`}{`.`}

\n 
{`apiVersion: extensions/v1beta1`}{`\n`}{`kind: Ingress`}{`\n`}{`metadata:`}{`\n`}{`  name: kerberos-storage`}{`\n`}{`  annotations:`}{`\n`}{`    #kubernetes.io/ingress.class: traefik`}{`\n`}{`    kubernetes.io/ingress.class: nginx`}{`\n`}{`    nginx.ingress.kubernetes.io/proxy-body-size: 200m`}
\n

{`Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names and MongoDB credentials, install Kerberos Storage inside your cluster.`}

\n 
{`kubectl apply -f ./storage/yaml/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Storage`}
    • \n
  • {`Enterprise (optional)`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`kerberos-storage-6f5c877d7c-hf77p 1/1     Running   0          2d11h`}{`\n`}{`mongodb-55566dc65c-xgmns          2/2     Running   0          4d13h`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS or `}{`/etc/hosts`}{` file, you should be able to access the Storage application. By navigating to the Storage domain `}{`storage.domain.com`}{` in your browser you will see the Storage login page showing up.`}

\n

\"Storage\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-80f1efe8d34adc7d6e5dee557701dcf6.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-80f1efe8d34adc7d6e5dee557701dcf6.json new file mode 100644 index 0000000..567b667 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-80f1efe8d34adc7d6e5dee557701dcf6.json @@ -0,0 +1 @@ +{"expireTime":9007200861859897000,"key":"gatsby-plugin-mdx-entire-payload-0dcc9286381a16677370848ea20cb06f-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":88,"offset":322},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"AWS","position":{"start":{"line":12,"column":90,"offset":324},"end":{"line":12,"column":93,"offset":327},"indent":[]}}],"position":{"start":{"line":12,"column":88,"offset":322},"end":{"line":12,"column":95,"offset":329},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":12,"column":95,"offset":329},"end":{"line":12,"column":97,"offset":331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"GCP","position":{"start":{"line":12,"column":99,"offset":333},"end":{"line":12,"column":102,"offset":336},"indent":[]}}],"position":{"start":{"line":12,"column":97,"offset":331},"end":{"line":12,"column":104,"offset":338},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":12,"column":104,"offset":338},"end":{"line":12,"column":108,"offset":342},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Azure","position":{"start":{"line":12,"column":110,"offset":344},"end":{"line":12,"column":115,"offset":349},"indent":[]}}],"position":{"start":{"line":12,"column":108,"offset":342},"end":{"line":12,"column":117,"offset":351},"indent":[]}},{"type":"text","value":"),\ncloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.","position":{"start":{"line":12,"column":117,"offset":351},"end":{"line":13,"column":90,"offset":443},"indent":[1]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":13,"column":90,"offset":443},"indent":[1]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":15,"column":1,"offset":445},"end":{"line":17,"column":11,"offset":647},"indent":[1,1]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":19,"column":3,"offset":651},"end":{"line":19,"column":15,"offset":663},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":649},"end":{"line":19,"column":15,"offset":663},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.","position":{"start":{"line":21,"column":1,"offset":665},"end":{"line":21,"column":323,"offset":987},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":665},"end":{"line":21,"column":323,"offset":987},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":23,"column":1,"offset":989},"end":{"line":25,"column":11,"offset":1191},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"First clone the configrations from our Github repo.","position":{"start":{"line":27,"column":1,"offset":1193},"end":{"line":27,"column":52,"offset":1244},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1193},"end":{"line":27,"column":52,"offset":1244},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/enterprise","position":{"start":{"line":29,"column":1,"offset":1246},"end":{"line":29,"column":56,"offset":1301},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next go into the directory and execute the first Kubernetes configuration file ","position":{"start":{"line":31,"column":1,"offset":1303},"end":{"line":31,"column":80,"offset":1382},"indent":[]}},{"type":"inlineCode","value":"clusterrole.yaml","position":{"start":{"line":31,"column":80,"offset":1382},"end":{"line":31,"column":98,"offset":1400},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":98,"offset":1400},"end":{"line":31,"column":99,"offset":1401},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1303},"end":{"line":31,"column":99,"offset":1401},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml","position":{"start":{"line":33,"column":1,"offset":1403},"end":{"line":33,"column":65,"offset":1467},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This will make several actions inside your cluster available. We need this to be able to create deployments from the factory web app.","position":{"start":{"line":35,"column":1,"offset":1469},"end":{"line":35,"column":134,"offset":1602},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1469},"end":{"line":35,"column":134,"offset":1602},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Helm","position":{"start":{"line":37,"column":4,"offset":1607},"end":{"line":37,"column":8,"offset":1611},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1604},"end":{"line":37,"column":8,"offset":1611},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next we will install a couple of dependencies which are required for Kerberos Enterprise. ","position":{"start":{"line":39,"column":1,"offset":1613},"end":{"line":39,"column":91,"offset":1703},"indent":[]}},{"type":"link","title":null,"url":"https://helm.sh/","children":[{"type":"strong","children":[{"type":"text","value":"Helm","position":{"start":{"line":39,"column":94,"offset":1706},"end":{"line":39,"column":98,"offset":1710},"indent":[]}}],"position":{"start":{"line":39,"column":92,"offset":1704},"end":{"line":39,"column":100,"offset":1712},"indent":[]}}],"position":{"start":{"line":39,"column":91,"offset":1703},"end":{"line":39,"column":119,"offset":1731},"indent":[]}},{"type":"text","value":" is a package manager for Kubernetes, it helps you setting up services more easily (this could be a MQTT broker, a database, etc).\nInstead of writing yaml files for every service we need, we use so called ","position":{"start":{"line":39,"column":119,"offset":1731},"end":{"line":40,"column":75,"offset":1936},"indent":[1]}},{"type":"strong","children":[{"type":"text","value":"Charts","position":{"start":{"line":40,"column":77,"offset":1938},"end":{"line":40,"column":83,"offset":1944},"indent":[]}}],"position":{"start":{"line":40,"column":75,"offset":1936},"end":{"line":40,"column":85,"offset":1946},"indent":[]}},{"type":"text","value":" (libraries), that you can reuse and configure the,\nwith the appropriate settings.","position":{"start":{"line":40,"column":85,"offset":1946},"end":{"line":41,"column":31,"offset":2028},"indent":[1]}}],"position":{"start":{"line":39,"column":1,"offset":1613},"end":{"line":41,"column":31,"offset":2028},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Use one of the preferred OS package managers to install the Helm client:","position":{"start":{"line":43,"column":1,"offset":2030},"end":{"line":43,"column":73,"offset":2102},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2030},"end":{"line":43,"column":73,"offset":2102},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"brew install helm\n\nchoco install kubernetes-helm\n\nscoop install helm\n\ngofish install helm","position":{"start":{"line":45,"column":1,"offset":2104},"end":{"line":51,"column":24,"offset":2209},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Traefik","position":{"start":{"line":53,"column":4,"offset":2214},"end":{"line":53,"column":11,"offset":2221},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2211},"end":{"line":53,"column":11,"offset":2221},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://containo.us/traefik/","children":[{"type":"strong","children":[{"type":"text","value":"Traefik","position":{"start":{"line":55,"column":4,"offset":2226},"end":{"line":55,"column":11,"offset":2233},"indent":[]}}],"position":{"start":{"line":55,"column":2,"offset":2224},"end":{"line":55,"column":13,"offset":2235},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2223},"end":{"line":55,"column":44,"offset":2266},"indent":[]}},{"type":"text","value":" is a reverse proxy and load balancer which allows you to expose your deployments more easily. Kerberos uses Traefik to expose it's APIs more easily.","position":{"start":{"line":55,"column":44,"offset":2266},"end":{"line":55,"column":193,"offset":2415},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2223},"end":{"line":55,"column":193,"offset":2415},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By executing following helm command, we will install traefik and link it to a specific DNS name. Open the traefik values file, ","position":{"start":{"line":57,"column":1,"offset":2417},"end":{"line":57,"column":128,"offset":2544},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/traefik/values.yaml","position":{"start":{"line":57,"column":128,"offset":2544},"end":{"line":57,"column":167,"offset":2583},"indent":[]}},{"type":"text","value":", and update the DNS name to your own domain.","position":{"start":{"line":57,"column":167,"offset":2583},"end":{"line":57,"column":212,"offset":2628},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2417},"end":{"line":57,"column":212,"offset":2628},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" dashboard:\n enabled: true\n--> domain: traefik.domain.com\n serviceType: NodePort\n rbac:\n enabled: true","position":{"start":{"line":59,"column":1,"offset":2630},"end":{"line":64,"column":26,"offset":2781},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Add Helm repository and install traefik.","position":{"start":{"line":66,"column":1,"offset":2783},"end":{"line":66,"column":41,"offset":2823},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":2783},"end":{"line":66,"column":41,"offset":2823},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add stable https://kubernetes-charts.storage.googleapis.com\nhelm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik","position":{"start":{"line":68,"column":1,"offset":2825},"end":{"line":69,"column":81,"offset":2979},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"After installation you should have an IP attached to traefik service, look for it by executing the ","position":{"start":{"line":71,"column":1,"offset":2981},"end":{"line":71,"column":100,"offset":3080},"indent":[]}},{"type":"inlineCode","value":"get service","position":{"start":{"line":71,"column":100,"offset":3080},"end":{"line":71,"column":113,"offset":3093},"indent":[]}},{"type":"text","value":" command. You will see the ip address in the ","position":{"start":{"line":71,"column":113,"offset":3093},"end":{"line":71,"column":158,"offset":3138},"indent":[]}},{"type":"inlineCode","value":"EXTERNAL-IP","position":{"start":{"line":71,"column":158,"offset":3138},"end":{"line":71,"column":171,"offset":3151},"indent":[]}},{"type":"text","value":" attribute.","position":{"start":{"line":71,"column":171,"offset":3151},"end":{"line":71,"column":182,"offset":3162},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":2981},"end":{"line":71,"column":182,"offset":3162},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl get svc\n\n NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE\n kubernetes ClusterIP 10.0.0.1 443/TCP 36h\n--> traefik LoadBalancer 10.0.27.93 40.114.168.96 443:31623/TCP,80:31804/TCP 35h\n traefik-dashboard NodePort 10.0.252.6 80:31146/TCP 35h","position":{"start":{"line":73,"column":1,"offset":3164},"end":{"line":78,"column":115,"offset":3644},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Go to your DNS provider and link the domain you've configured in the first step ","position":{"start":{"line":80,"column":1,"offset":3646},"end":{"line":80,"column":81,"offset":3726},"indent":[]}},{"type":"inlineCode","value":"traefik.domain.com","position":{"start":{"line":80,"column":81,"offset":3726},"end":{"line":80,"column":101,"offset":3746},"indent":[]}},{"type":"text","value":" to the IP address of the ","position":{"start":{"line":80,"column":101,"offset":3746},"end":{"line":80,"column":127,"offset":3772},"indent":[]}},{"type":"inlineCode","value":"EXTERNAL-IP","position":{"start":{"line":80,"column":127,"offset":3772},"end":{"line":80,"column":140,"offset":3785},"indent":[]}},{"type":"text","value":" attribute. When browsing to ","position":{"start":{"line":80,"column":140,"offset":3785},"end":{"line":80,"column":169,"offset":3814},"indent":[]}},{"type":"inlineCode","value":"traefik.domain.com","position":{"start":{"line":80,"column":169,"offset":3814},"end":{"line":80,"column":189,"offset":3834},"indent":[]}},{"type":"text","value":", you should see the traefik dashboard showing up.","position":{"start":{"line":80,"column":189,"offset":3834},"end":{"line":80,"column":239,"offset":3884},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":3646},"end":{"line":80,"column":239,"offset":3884},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Ingress-Nginx (alternative for Traefik)","position":{"start":{"line":82,"column":4,"offset":3889},"end":{"line":82,"column":43,"offset":3928},"indent":[]}}],"position":{"start":{"line":82,"column":1,"offset":3886},"end":{"line":82,"column":43,"offset":3928},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you don't like ","position":{"start":{"line":84,"column":1,"offset":3930},"end":{"line":84,"column":19,"offset":3948},"indent":[]}},{"type":"inlineCode","value":"Traefik","position":{"start":{"line":84,"column":19,"offset":3948},"end":{"line":84,"column":28,"offset":3957},"indent":[]}},{"type":"text","value":" but you prefer ","position":{"start":{"line":84,"column":28,"offset":3957},"end":{"line":84,"column":44,"offset":3973},"indent":[]}},{"type":"inlineCode","value":"Ingress Nginx","position":{"start":{"line":84,"column":44,"offset":3973},"end":{"line":84,"column":59,"offset":3988},"indent":[]}},{"type":"text","value":", that works as well.","position":{"start":{"line":84,"column":59,"offset":3988},"end":{"line":84,"column":80,"offset":4009},"indent":[]}}],"position":{"start":{"line":84,"column":1,"offset":3930},"end":{"line":84,"column":80,"offset":4009},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx\nhelm repo update\nhelm install ingress-nginx ingress-nginx/ingress-nginx","position":{"start":{"line":86,"column":1,"offset":4011},"end":{"line":88,"column":59,"offset":4165},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"MongoDB","position":{"start":{"line":90,"column":4,"offset":4170},"end":{"line":90,"column":11,"offset":4177},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4167},"end":{"line":90,"column":11,"offset":4177},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use ","position":{"start":{"line":92,"column":1,"offset":4179},"end":{"line":92,"column":192,"offset":4370},"indent":[]}},{"type":"inlineCode","value":"helm ","position":{"start":{"line":92,"column":192,"offset":4370},"end":{"line":92,"column":199,"offset":4377},"indent":[]}},{"type":"text","value":"to install a MongoDB instance inside your cluster.","position":{"start":{"line":92,"column":199,"offset":4377},"end":{"line":92,"column":249,"offset":4427},"indent":[]}}],"position":{"start":{"line":92,"column":1,"offset":4179},"end":{"line":92,"column":249,"offset":4427},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Have a look into the ","position":{"start":{"line":94,"column":1,"offset":4429},"end":{"line":94,"column":22,"offset":4450},"indent":[]}},{"type":"inlineCode","value":"yaml/mongodb/values.yaml","position":{"start":{"line":94,"column":22,"offset":4450},"end":{"line":94,"column":48,"offset":4476},"indent":[]}},{"type":"text","value":" file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb.","position":{"start":{"line":94,"column":48,"offset":4476},"end":{"line":94,"column":204,"offset":4632},"indent":[]}}],"position":{"start":{"line":94,"column":1,"offset":4429},"end":{"line":94,"column":204,"offset":4632},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values.yaml","position":{"start":{"line":96,"column":1,"offset":4634},"end":{"line":97,"column":88,"offset":4782},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.","position":{"start":{"line":99,"column":1,"offset":4784},"end":{"line":99,"column":170,"offset":4953},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4784},"end":{"line":99,"column":170,"offset":4953},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)\necho $MONGODB_ROOT_PASSWORD","position":{"start":{"line":101,"column":1,"offset":4955},"end":{"line":102,"column":32,"offset":5131},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Enterprise Web App - The Factory","position":{"start":{"line":104,"column":4,"offset":5136},"end":{"line":104,"column":45,"offset":5177},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":5133},"end":{"line":104,"column":45,"offset":5177},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the ","position":{"start":{"line":106,"column":1,"offset":5179},"end":{"line":106,"column":138,"offset":5316},"indent":[]}},{"type":"inlineCode","value":"Factory","position":{"start":{"line":106,"column":138,"offset":5316},"end":{"line":106,"column":147,"offset":5325},"indent":[]}},{"type":"text","value":". It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.","position":{"start":{"line":106,"column":147,"offset":5325},"end":{"line":106,"column":309,"offset":5487},"indent":[]}}],"position":{"start":{"line":106,"column":1,"offset":5179},"end":{"line":106,"column":309,"offset":5487},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the ","position":{"start":{"line":108,"column":1,"offset":5489},"end":{"line":108,"column":289,"offset":5777},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":108,"column":289,"offset":5777},"end":{"line":108,"column":298,"offset":5786},"indent":[]}},{"type":"text","value":" command.","position":{"start":{"line":108,"column":298,"offset":5786},"end":{"line":108,"column":307,"offset":5795},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":5489},"end":{"line":108,"column":307,"offset":5795},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing the Factory web app, open the ","position":{"start":{"line":110,"column":1,"offset":5797},"end":{"line":110,"column":49,"offset":5845},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":110,"column":49,"offset":5845},"end":{"line":110,"column":92,"offset":5888},"indent":[]}},{"type":"text","value":" configuration file. At the of the bottom file you will find two endpoints, similar to the Ingres file bewlwo. Update the hostnames to your own perferred domain, and add these to your DNS server or ","position":{"start":{"line":110,"column":92,"offset":5888},"end":{"line":110,"column":290,"offset":6086},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":110,"column":290,"offset":6086},"end":{"line":110,"column":302,"offset":6098},"indent":[]}},{"type":"text","value":" file (pointing to the same IP as the Traefik/Ingress nginx EXTERNAL-IP).","position":{"start":{"line":110,"column":302,"offset":6098},"end":{"line":110,"column":375,"offset":6171},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":5797},"end":{"line":110,"column":375,"offset":6171},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 80\n--> - host: api.factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 8081","position":{"start":{"line":112,"column":1,"offset":6173},"end":{"line":127,"column":36,"offset":6605},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Ingress Nginx, do not forgot to comment ","position":{"start":{"line":129,"column":1,"offset":6607},"end":{"line":129,"column":58,"offset":6664},"indent":[]}},{"type":"inlineCode","value":"Traefik","position":{"start":{"line":129,"column":58,"offset":6664},"end":{"line":129,"column":67,"offset":6673},"indent":[]}},{"type":"text","value":" and uncomment ","position":{"start":{"line":129,"column":67,"offset":6673},"end":{"line":129,"column":82,"offset":6688},"indent":[]}},{"type":"inlineCode","value":"Ingress Nginx","position":{"start":{"line":129,"column":82,"offset":6688},"end":{"line":129,"column":97,"offset":6703},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":129,"column":97,"offset":6703},"end":{"line":129,"column":98,"offset":6704},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":6607},"end":{"line":129,"column":98,"offset":6704},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"apiVersion: extensions/v1beta1\nkind: Ingress\nmetadata:\n name: factory\n annotations:\n #kubernetes.io/ingress.class: traefik\n kubernetes.io/ingress.class: nginx","position":{"start":{"line":131,"column":1,"offset":6706},"end":{"line":137,"column":43,"offset":6900},"indent":[1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":139,"column":1,"offset":6902},"end":{"line":139,"column":99,"offset":7000},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":6902},"end":{"line":139,"column":99,"offset":7000},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":141,"column":1,"offset":7002},"end":{"line":144,"column":30,"offset":7121},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.","position":{"start":{"line":146,"column":1,"offset":7123},"end":{"line":146,"column":118,"offset":7240},"indent":[]}}],"position":{"start":{"line":146,"column":1,"offset":7123},"end":{"line":146,"column":118,"offset":7240},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":148,"column":1,"offset":7242},"end":{"line":148,"column":63,"offset":7304},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":150,"column":4,"offset":7309},"end":{"line":150,"column":26,"offset":7331},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":7306},"end":{"line":150,"column":26,"offset":7331},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":152,"column":1,"offset":7333},"end":{"line":152,"column":94,"offset":7426},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":7333},"end":{"line":152,"column":94,"offset":7426},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":154,"column":5,"offset":7432},"end":{"line":154,"column":12,"offset":7439},"indent":[]}}],"position":{"start":{"line":154,"column":5,"offset":7432},"end":{"line":154,"column":12,"offset":7439},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":7428},"end":{"line":154,"column":12,"offset":7439},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":155,"column":5,"offset":7444},"end":{"line":155,"column":12,"offset":7451},"indent":[]}}],"position":{"start":{"line":155,"column":5,"offset":7444},"end":{"line":155,"column":12,"offset":7451},"indent":[]}}],"position":{"start":{"line":155,"column":1,"offset":7440},"end":{"line":155,"column":12,"offset":7451},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Factory","position":{"start":{"line":156,"column":5,"offset":7456},"end":{"line":156,"column":12,"offset":7463},"indent":[]}}],"position":{"start":{"line":156,"column":5,"offset":7456},"end":{"line":156,"column":12,"offset":7463},"indent":[]}}],"position":{"start":{"line":156,"column":1,"offset":7452},"end":{"line":156,"column":12,"offset":7463},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":7428},"end":{"line":156,"column":12,"offset":7463},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":158,"column":1,"offset":7465},"end":{"line":158,"column":26,"offset":7490},"indent":[]}}],"position":{"start":{"line":158,"column":1,"offset":7465},"end":{"line":158,"column":26,"offset":7490},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nfactory-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-758d5c5ddd-qsfq9 1/1 Running 0 5m31s\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":160,"column":1,"offset":7492},"end":{"line":164,"column":73,"offset":7804},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":166,"column":4,"offset":7809},"end":{"line":166,"column":21,"offset":7826},"indent":[]}}],"position":{"start":{"line":166,"column":1,"offset":7806},"end":{"line":166,"column":21,"offset":7826},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain ","position":{"start":{"line":168,"column":1,"offset":7828},"end":{"line":168,"column":152,"offset":7979},"indent":[]}},{"type":"inlineCode","value":"factory.domain.com","position":{"start":{"line":168,"column":152,"offset":7979},"end":{"line":168,"column":172,"offset":7999},"indent":[]}},{"type":"text","value":" in your browser you will see the Factory login page showing up.","position":{"start":{"line":168,"column":172,"offset":7999},"end":{"line":168,"column":236,"offset":8063},"indent":[]}}],"position":{"start":{"line":168,"column":1,"offset":7828},"end":{"line":168,"column":236,"offset":8063},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Factory","position":{"start":{"line":170,"column":1,"offset":8065},"end":{"line":170,"column":71,"offset":8135},"indent":[]}}],"position":{"start":{"line":170,"column":1,"offset":8065},"end":{"line":170,"column":71,"offset":8135},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":173,"column":1,"offset":8138},"end":{"line":173,"column":31,"offset":8168},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":173,"column":31,"offset":8168}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Introduction`}

\n

{`Start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (`}{`AWS`}{`, `}{`GCP`}{` or `}{`Azure`}{`),\ncloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.`}

\n
\n
\n

\n

{`Installation`}

\n

{`Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.`}

\n
\n
\n

\n

{`First clone the configrations from our Github repo.`}

\n 
{`git clone https://github.com/kerberos-io/enterprise`}
\n

{`Next go into the directory and execute the first Kubernetes configuration file `}{`clusterrole.yaml`}{`.`}

\n 
{`kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml`}
\n

{`This will make several actions inside your cluster available. We need this to be able to create deployments from the factory web app.`}

\n

{`Helm`}

\n

{`Next we will install a couple of dependencies which are required for Kerberos Enterprise. `}{`Helm`}{` is a package manager for Kubernetes, it helps you setting up services more easily (this could be a MQTT broker, a database, etc).\nInstead of writing yaml files for every service we need, we use so called `}{`Charts`}{` (libraries), that you can reuse and configure the,\nwith the appropriate settings.`}

\n

{`Use one of the preferred OS package managers to install the Helm client:`}

\n 
{`brew install helm`}{`\n`}{`\n`}{`choco install kubernetes-helm`}{`\n`}{`\n`}{`scoop install helm`}{`\n`}{`\n`}{`gofish install helm`}
\n

{`Traefik`}

\n

{`Traefik`}{` is a reverse proxy and load balancer which allows you to expose your deployments more easily. Kerberos uses Traefik to expose it's APIs more easily.`}

\n

{`By executing following helm command, we will install traefik and link it to a specific DNS name. Open the traefik values file, `}{`./enterprise/yaml/traefik/values.yaml`}{`, and update the DNS name to your own domain.`}

\n 
{`    dashboard:`}{`\n`}{`      enabled: true`}{`\n`}{`-->   domain: traefik.domain.com`}{`\n`}{`      serviceType: NodePort`}{`\n`}{`    rbac:`}{`\n`}{`        enabled: true`}
\n

{`Add Helm repository and install traefik.`}

\n 
{`helm repo add stable https://kubernetes-charts.storage.googleapis.com`}{`\n`}{`helm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik`}
\n

{`After installation you should have an IP attached to traefik service, look for it by executing the `}{`get service`}{` command. You will see the ip address in the `}{`EXTERNAL-IP`}{` attribute.`}

\n 
{`kubectl get svc`}{`\n`}{`\n`}{`    NAME                        TYPE           CLUSTER-IP     EXTERNAL-IP     PORT(S)                      AGE`}{`\n`}{`    kubernetes                  ClusterIP      10.0.0.1                 443/TCP                      36h`}{`\n`}{`--> traefik                     LoadBalancer   10.0.27.93     40.114.168.96   443:31623/TCP,80:31804/TCP   35h`}{`\n`}{`    traefik-dashboard           NodePort       10.0.252.6               80:31146/TCP                 35h`}
\n

{`Go to your DNS provider and link the domain you've configured in the first step `}{`traefik.domain.com`}{` to the IP address of the `}{`EXTERNAL-IP`}{` attribute. When browsing to `}{`traefik.domain.com`}{`, you should see the traefik dashboard showing up.`}

\n

{`Ingress-Nginx (alternative for Traefik)`}

\n

{`If you don't like `}{`Traefik`}{` but you prefer `}{`Ingress Nginx`}{`, that works as well.`}

\n 
{`helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx`}{`\n`}{`helm repo update`}{`\n`}{`helm install ingress-nginx ingress-nginx/ingress-nginx`}
\n

{`MongoDB`}

\n

{`When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use `}{`helm `}{`to install a MongoDB instance inside your cluster.`}

\n

{`Have a look into the `}{`yaml/mongodb/values.yaml`}{` file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb.`}

\n 
{`helm repo add bitnami https://charts.bitnami.com/bitnami`}{`\n`}{`helm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values.yaml`}
\n

{`Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.`}

\n 
{`export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)`}{`\n`}{`echo $MONGODB_ROOT_PASSWORD`}
\n

{`Kerberos Enterprise Web App - The Factory`}

\n

{`The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the `}{`Factory`}{`. It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.`}

\n

{`The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the `}{`kubectl`}{` command.`}

\n

{`Before installing the Factory web app, open the `}{`./enterprise/yaml/factory/deployment.yaml`}{` configuration file. At the of the bottom file you will find two endpoints, similar to the Ingres file bewlwo. Update the hostnames to your own perferred domain, and add these to your DNS server or `}{`/etc/hosts`}{` file (pointing to the same IP as the Traefik/Ingress nginx EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 8081`}
\n

{`If you are using Ingress Nginx, do not forgot to comment `}{`Traefik`}{` and uncomment `}{`Ingress Nginx`}{`.`}

\n 
{`apiVersion: extensions/v1beta1`}{`\n`}{`kind: Ingress`}{`\n`}{`metadata:`}{`\n`}{`  name: factory`}{`\n`}{`  annotations:`}{`\n`}{`    #kubernetes.io/ingress.class: traefik`}{`\n`}{`    kubernetes.io/ingress.class: nginx`}
\n

{`Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.`}

\n 
{`kubectl apply -f ./enterprise/yaml/factory/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Factory`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`factory-6f5c877d7c-hf77p          1/1     Running   0          2d11h`}{`\n`}{`mongodb-758d5c5ddd-qsfq9          1/1     Running   0          5m31s`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain `}{`factory.domain.com`}{` in your browser you will see the Factory login page showing up.`}

\n

\"Factory\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-86b347ac56ea35a84420f705171318ed.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-86b347ac56ea35a84420f705171318ed.json new file mode 100644 index 0000000..2e427c8 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-86b347ac56ea35a84420f705171318ed.json @@ -0,0 +1 @@ +{"expireTime":9007200861829416000,"key":"gatsby-plugin-mdx-entire-payload-6fb6943ec6c0c19e42048e489e44dd9e-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and be consumed by ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":191,"offset":844},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":192,"offset":845},"end":{"line":18,"column":206,"offset":859},"indent":[]}}],"position":{"start":{"line":18,"column":191,"offset":844},"end":{"line":18,"column":215,"offset":868},"indent":[]}},{"type":"text","value":" in parrallel. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":18,"column":215,"offset":868},"end":{"line":18,"column":632,"offset":1285},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":632,"offset":1285},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":20,"column":4,"offset":1290},"end":{"line":20,"column":18,"offset":1304},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1287},"end":{"line":20,"column":18,"offset":1304},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":22,"column":1,"offset":1306},"end":{"line":22,"column":291,"offset":1596},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":22,"column":292,"offset":1597},"end":{"line":22,"column":309,"offset":1614},"indent":[]}}],"position":{"start":{"line":22,"column":291,"offset":1596},"end":{"line":22,"column":318,"offset":1623},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":22,"column":318,"offset":1623},"end":{"line":22,"column":319,"offset":1624},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1306},"end":{"line":22,"column":319,"offset":1624},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":24,"column":1,"offset":1626},"end":{"line":24,"column":56,"offset":1681},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1626},"end":{"line":24,"column":56,"offset":1681},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":26,"column":4,"offset":1686},"end":{"line":26,"column":20,"offset":1702},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1683},"end":{"line":26,"column":20,"offset":1702},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":28,"column":1,"offset":1704},"end":{"line":28,"column":253,"offset":1956},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1704},"end":{"line":28,"column":253,"offset":1956},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":30,"column":6,"offset":1963},"end":{"line":30,"column":35,"offset":1992},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1962},"end":{"line":30,"column":70,"offset":2027},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1962},"end":{"line":30,"column":70,"offset":2027},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1958},"end":{"line":30,"column":70,"offset":2027},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":31,"column":6,"offset":2033},"end":{"line":31,"column":29,"offset":2056},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2032},"end":{"line":31,"column":83,"offset":2110},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2032},"end":{"line":31,"column":83,"offset":2110},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":2028},"end":{"line":31,"column":83,"offset":2110},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":32,"column":6,"offset":2116},"end":{"line":32,"column":28,"offset":2138},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2115},"end":{"line":32,"column":57,"offset":2167},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2115},"end":{"line":32,"column":57,"offset":2167},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2111},"end":{"line":32,"column":57,"offset":2167},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":33,"column":6,"offset":2173},"end":{"line":33,"column":11,"offset":2178},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2172},"end":{"line":33,"column":29,"offset":2196},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2172},"end":{"line":33,"column":29,"offset":2196},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2168},"end":{"line":33,"column":29,"offset":2196},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1958},"end":{"line":33,"column":29,"offset":2196},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":35,"column":1,"offset":2198},"end":{"line":35,"column":190,"offset":2387},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2198},"end":{"line":35,"column":190,"offset":2387},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":37,"column":1,"offset":2389},"end":{"line":37,"column":99,"offset":2487},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2389},"end":{"line":37,"column":99,"offset":2487},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":39,"column":1,"offset":2489},"end":{"line":39,"column":220,"offset":2708},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2489},"end":{"line":39,"column":220,"offset":2708},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":41,"column":1,"offset":2710},"end":{"line":41,"column":98,"offset":2807},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2710},"end":{"line":41,"column":98,"offset":2807},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":43,"column":5,"offset":2813},"end":{"line":43,"column":11,"offset":2819},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2809},"end":{"line":43,"column":11,"offset":2819},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":45,"column":1,"offset":2821},"end":{"line":45,"column":303,"offset":3123},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2821},"end":{"line":45,"column":303,"offset":3123},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":47,"column":6,"offset":3130},"end":{"line":47,"column":18,"offset":3142},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3129},"end":{"line":47,"column":46,"offset":3170},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3129},"end":{"line":47,"column":46,"offset":3170},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3125},"end":{"line":47,"column":46,"offset":3170},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":48,"column":6,"offset":3176},"end":{"line":48,"column":29,"offset":3199},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3175},"end":{"line":48,"column":59,"offset":3229},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3175},"end":{"line":48,"column":59,"offset":3229},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":3171},"end":{"line":48,"column":59,"offset":3229},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3125},"end":{"line":48,"column":59,"offset":3229},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":50,"column":1,"offset":3231},"end":{"line":50,"column":368,"offset":3598},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3231},"end":{"line":50,"column":368,"offset":3598},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":52,"column":1,"offset":3600},"end":{"line":52,"column":66,"offset":3665},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3600},"end":{"line":52,"column":66,"offset":3665},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":54,"column":5,"offset":3671},"end":{"line":54,"column":21,"offset":3687},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3667},"end":{"line":54,"column":21,"offset":3687},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":56,"column":1,"offset":3689},"end":{"line":56,"column":237,"offset":3925},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3689},"end":{"line":56,"column":237,"offset":3925},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":58,"column":1,"offset":3927},"end":{"line":58,"column":105,"offset":4031},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3927},"end":{"line":58,"column":105,"offset":4031},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":60,"column":1,"offset":4033},"end":{"line":60,"column":45,"offset":4077},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4033},"end":{"line":60,"column":45,"offset":4077},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":62,"column":3,"offset":4081},"end":{"line":62,"column":380,"offset":4458},"indent":[]}}],"position":{"start":{"line":62,"column":3,"offset":4081},"end":{"line":62,"column":380,"offset":4458},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4079},"end":{"line":63,"column":1,"offset":4459},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":64,"column":3,"offset":4462},"end":{"line":65,"column":49,"offset":4776},"indent":[2]}}],"position":{"start":{"line":64,"column":3,"offset":4462},"end":{"line":65,"column":49,"offset":4776},"indent":[2]}}],"position":{"start":{"line":64,"column":1,"offset":4460},"end":{"line":65,"column":49,"offset":4776},"indent":[1]}}],"position":{"start":{"line":62,"column":1,"offset":4079},"end":{"line":65,"column":49,"offset":4776},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":67,"column":5,"offset":4782},"end":{"line":67,"column":13,"offset":4790},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":4778},"end":{"line":67,"column":13,"offset":4790},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":69,"column":1,"offset":4792},"end":{"line":69,"column":156,"offset":4947},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":69,"column":156,"offset":4947},"end":{"line":69,"column":177,"offset":4968},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":69,"column":177,"offset":4968},"end":{"line":69,"column":188,"offset":4979},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":69,"column":188,"offset":4979},"end":{"line":69,"column":193,"offset":4984},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":69,"column":193,"offset":4984},"end":{"line":69,"column":379,"offset":5170},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4792},"end":{"line":69,"column":379,"offset":5170},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":71,"column":1,"offset":5172},"end":{"line":71,"column":68,"offset":5239},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":5172},"end":{"line":71,"column":68,"offset":5239},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":73,"column":4,"offset":5244},"end":{"line":73,"column":13,"offset":5253},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5241},"end":{"line":73,"column":13,"offset":5253},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":75,"column":1,"offset":5255},"end":{"line":75,"column":44,"offset":5298},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":75,"column":46,"offset":5300},"end":{"line":75,"column":68,"offset":5322},"indent":[]}}],"position":{"start":{"line":75,"column":44,"offset":5298},"end":{"line":75,"column":70,"offset":5324},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":75,"column":70,"offset":5324},"end":{"line":75,"column":106,"offset":5360},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":75,"column":108,"offset":5362},"end":{"line":75,"column":129,"offset":5383},"indent":[]}}],"position":{"start":{"line":75,"column":106,"offset":5360},"end":{"line":75,"column":131,"offset":5385},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":75,"column":131,"offset":5385},"end":{"line":75,"column":159,"offset":5413},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5255},"end":{"line":75,"column":159,"offset":5413},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":78,"column":1,"offset":5416},"end":{"line":78,"column":31,"offset":5446},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":78,"column":31,"offset":5446}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and be consumed by `}{`Kerberos Cloud`}{` in parrallel. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-87dfbe998ad89def6bc5d5d0604dcdb4.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-87dfbe998ad89def6bc5d5d0604dcdb4.json index 64133ca..b153e50 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-87dfbe998ad89def6bc5d5d0604dcdb4.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-87dfbe998ad89def6bc5d5d0604dcdb4.json @@ -1 +1 @@ -{"expireTime":9007200861747685000,"key":"gatsby-plugin-mdx-entire-payload-0d73657aeb7fd347bdc9340e676a33ca-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":88,"offset":322},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"AWS","position":{"start":{"line":12,"column":90,"offset":324},"end":{"line":12,"column":93,"offset":327},"indent":[]}}],"position":{"start":{"line":12,"column":88,"offset":322},"end":{"line":12,"column":95,"offset":329},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":12,"column":95,"offset":329},"end":{"line":12,"column":97,"offset":331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"GCP","position":{"start":{"line":12,"column":99,"offset":333},"end":{"line":12,"column":102,"offset":336},"indent":[]}}],"position":{"start":{"line":12,"column":97,"offset":331},"end":{"line":12,"column":104,"offset":338},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":12,"column":104,"offset":338},"end":{"line":12,"column":108,"offset":342},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Azure","position":{"start":{"line":12,"column":110,"offset":344},"end":{"line":12,"column":115,"offset":349},"indent":[]}}],"position":{"start":{"line":12,"column":108,"offset":342},"end":{"line":12,"column":117,"offset":351},"indent":[]}},{"type":"text","value":"),\ncloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.","position":{"start":{"line":12,"column":117,"offset":351},"end":{"line":13,"column":90,"offset":443},"indent":[1]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":13,"column":90,"offset":443},"indent":[1]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":15,"column":1,"offset":445},"end":{"line":17,"column":11,"offset":647},"indent":[1,1]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":19,"column":3,"offset":651},"end":{"line":19,"column":15,"offset":663},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":649},"end":{"line":19,"column":15,"offset":663},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.","position":{"start":{"line":21,"column":1,"offset":665},"end":{"line":21,"column":323,"offset":987},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":665},"end":{"line":21,"column":323,"offset":987},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":23,"column":1,"offset":989},"end":{"line":25,"column":11,"offset":1191},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"First clone the configrations from our Github repo.","position":{"start":{"line":27,"column":1,"offset":1193},"end":{"line":27,"column":52,"offset":1244},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1193},"end":{"line":27,"column":52,"offset":1244},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/enterprise","position":{"start":{"line":29,"column":1,"offset":1246},"end":{"line":29,"column":56,"offset":1301},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next go into the directory and execute the first Kubernetes configuration file ","position":{"start":{"line":31,"column":1,"offset":1303},"end":{"line":31,"column":80,"offset":1382},"indent":[]}},{"type":"inlineCode","value":"clusterrole.yaml","position":{"start":{"line":31,"column":80,"offset":1382},"end":{"line":31,"column":98,"offset":1400},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":98,"offset":1400},"end":{"line":31,"column":99,"offset":1401},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1303},"end":{"line":31,"column":99,"offset":1401},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml","position":{"start":{"line":33,"column":1,"offset":1403},"end":{"line":33,"column":65,"offset":1467},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This will make several actions inside your cluster available. We need this to be able to create deployments from the factory web app.","position":{"start":{"line":35,"column":1,"offset":1469},"end":{"line":35,"column":134,"offset":1602},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1469},"end":{"line":35,"column":134,"offset":1602},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Helm","position":{"start":{"line":37,"column":4,"offset":1607},"end":{"line":37,"column":8,"offset":1611},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1604},"end":{"line":37,"column":8,"offset":1611},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next we will install a couple of dependencies which are required for Kerberos Enterprise. ","position":{"start":{"line":39,"column":1,"offset":1613},"end":{"line":39,"column":91,"offset":1703},"indent":[]}},{"type":"link","title":null,"url":"https://helm.sh/","children":[{"type":"strong","children":[{"type":"text","value":"Helm","position":{"start":{"line":39,"column":94,"offset":1706},"end":{"line":39,"column":98,"offset":1710},"indent":[]}}],"position":{"start":{"line":39,"column":92,"offset":1704},"end":{"line":39,"column":100,"offset":1712},"indent":[]}}],"position":{"start":{"line":39,"column":91,"offset":1703},"end":{"line":39,"column":119,"offset":1731},"indent":[]}},{"type":"text","value":" is a package manager for Kubernetes, it helps you setting up services more easily (this could be a MQTT broker, a database, etc).\nInstead of writing yaml files for every service we need, we use so called ","position":{"start":{"line":39,"column":119,"offset":1731},"end":{"line":40,"column":75,"offset":1936},"indent":[1]}},{"type":"strong","children":[{"type":"text","value":"Charts","position":{"start":{"line":40,"column":77,"offset":1938},"end":{"line":40,"column":83,"offset":1944},"indent":[]}}],"position":{"start":{"line":40,"column":75,"offset":1936},"end":{"line":40,"column":85,"offset":1946},"indent":[]}},{"type":"text","value":" (libraries), that you can reuse and configure the,\nwith the appropriate settings.","position":{"start":{"line":40,"column":85,"offset":1946},"end":{"line":41,"column":31,"offset":2028},"indent":[1]}}],"position":{"start":{"line":39,"column":1,"offset":1613},"end":{"line":41,"column":31,"offset":2028},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Use one of the preferred OS package managers to install the Helm client:","position":{"start":{"line":43,"column":1,"offset":2030},"end":{"line":43,"column":73,"offset":2102},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2030},"end":{"line":43,"column":73,"offset":2102},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"brew install helm\n\nchoco install kubernetes-helm\n\nscoop install helm\n\ngofish install helm","position":{"start":{"line":45,"column":1,"offset":2104},"end":{"line":51,"column":24,"offset":2209},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Traefik","position":{"start":{"line":53,"column":4,"offset":2214},"end":{"line":53,"column":11,"offset":2221},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2211},"end":{"line":53,"column":11,"offset":2221},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://containo.us/traefik/","children":[{"type":"strong","children":[{"type":"text","value":"Traefik","position":{"start":{"line":55,"column":4,"offset":2226},"end":{"line":55,"column":11,"offset":2233},"indent":[]}}],"position":{"start":{"line":55,"column":2,"offset":2224},"end":{"line":55,"column":13,"offset":2235},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2223},"end":{"line":55,"column":44,"offset":2266},"indent":[]}},{"type":"text","value":" is a reverse proxy and load balancer which allows you to expose your deployments more easily. Kerberos uses Traefik to expose it's APIs more easily.","position":{"start":{"line":55,"column":44,"offset":2266},"end":{"line":55,"column":193,"offset":2415},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2223},"end":{"line":55,"column":193,"offset":2415},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By executing following helm command, we will install traefik and link it to a specific DNS name. Open the traefik values file, ","position":{"start":{"line":57,"column":1,"offset":2417},"end":{"line":57,"column":128,"offset":2544},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/traefik/values.yaml","position":{"start":{"line":57,"column":128,"offset":2544},"end":{"line":57,"column":167,"offset":2583},"indent":[]}},{"type":"text","value":", and update the DNS name to your own domain.","position":{"start":{"line":57,"column":167,"offset":2583},"end":{"line":57,"column":212,"offset":2628},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2417},"end":{"line":57,"column":212,"offset":2628},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" dashboard:\n enabled: true\n--> domain: traefik.domain.com\n serviceType: NodePort\n rbac:\n enabled: true","position":{"start":{"line":59,"column":1,"offset":2630},"end":{"line":64,"column":26,"offset":2781},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Add Helm repository and install traefik.","position":{"start":{"line":66,"column":1,"offset":2783},"end":{"line":66,"column":41,"offset":2823},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":2783},"end":{"line":66,"column":41,"offset":2823},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add stable https://kubernetes-charts.storage.googleapis.com\nhelm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik","position":{"start":{"line":68,"column":1,"offset":2825},"end":{"line":69,"column":81,"offset":2979},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"After installation you should have an IP attached to traefik service, look for it by executing the ","position":{"start":{"line":71,"column":1,"offset":2981},"end":{"line":71,"column":100,"offset":3080},"indent":[]}},{"type":"inlineCode","value":"get service","position":{"start":{"line":71,"column":100,"offset":3080},"end":{"line":71,"column":113,"offset":3093},"indent":[]}},{"type":"text","value":" command. You will see the ip address in the ","position":{"start":{"line":71,"column":113,"offset":3093},"end":{"line":71,"column":158,"offset":3138},"indent":[]}},{"type":"inlineCode","value":"EXTERNAL-IP","position":{"start":{"line":71,"column":158,"offset":3138},"end":{"line":71,"column":171,"offset":3151},"indent":[]}},{"type":"text","value":" attribute.","position":{"start":{"line":71,"column":171,"offset":3151},"end":{"line":71,"column":182,"offset":3162},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":2981},"end":{"line":71,"column":182,"offset":3162},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl get svc\n\n NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE\n kubernetes ClusterIP 10.0.0.1 443/TCP 36h\n--> traefik LoadBalancer 10.0.27.93 40.114.168.96 443:31623/TCP,80:31804/TCP 35h\n traefik-dashboard NodePort 10.0.252.6 80:31146/TCP 35h","position":{"start":{"line":73,"column":1,"offset":3164},"end":{"line":78,"column":115,"offset":3644},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Go to your DNS provider and link the domain you've configured in the first step ","position":{"start":{"line":80,"column":1,"offset":3646},"end":{"line":80,"column":81,"offset":3726},"indent":[]}},{"type":"inlineCode","value":"traefik.domain.com","position":{"start":{"line":80,"column":81,"offset":3726},"end":{"line":80,"column":101,"offset":3746},"indent":[]}},{"type":"text","value":" to the IP address of the ","position":{"start":{"line":80,"column":101,"offset":3746},"end":{"line":80,"column":127,"offset":3772},"indent":[]}},{"type":"inlineCode","value":"EXTERNAL-IP","position":{"start":{"line":80,"column":127,"offset":3772},"end":{"line":80,"column":140,"offset":3785},"indent":[]}},{"type":"text","value":" attribute. When browsing to ","position":{"start":{"line":80,"column":140,"offset":3785},"end":{"line":80,"column":169,"offset":3814},"indent":[]}},{"type":"inlineCode","value":"traefik.domain.com","position":{"start":{"line":80,"column":169,"offset":3814},"end":{"line":80,"column":189,"offset":3834},"indent":[]}},{"type":"text","value":", you should see the traefik dashboard showing up.","position":{"start":{"line":80,"column":189,"offset":3834},"end":{"line":80,"column":239,"offset":3884},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":3646},"end":{"line":80,"column":239,"offset":3884},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"MongoDB","position":{"start":{"line":82,"column":4,"offset":3889},"end":{"line":82,"column":11,"offset":3896},"indent":[]}}],"position":{"start":{"line":82,"column":1,"offset":3886},"end":{"line":82,"column":11,"offset":3896},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use ","position":{"start":{"line":84,"column":1,"offset":3898},"end":{"line":84,"column":192,"offset":4089},"indent":[]}},{"type":"inlineCode","value":"helm ","position":{"start":{"line":84,"column":192,"offset":4089},"end":{"line":84,"column":199,"offset":4096},"indent":[]}},{"type":"text","value":"to install a MongoDB instance inside your cluster.","position":{"start":{"line":84,"column":199,"offset":4096},"end":{"line":84,"column":249,"offset":4146},"indent":[]}}],"position":{"start":{"line":84,"column":1,"offset":3898},"end":{"line":84,"column":249,"offset":4146},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Have a look into the ","position":{"start":{"line":86,"column":1,"offset":4148},"end":{"line":86,"column":22,"offset":4169},"indent":[]}},{"type":"inlineCode","value":"yaml/mongodb/values.yaml","position":{"start":{"line":86,"column":22,"offset":4169},"end":{"line":86,"column":48,"offset":4195},"indent":[]}},{"type":"text","value":" file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb.","position":{"start":{"line":86,"column":48,"offset":4195},"end":{"line":86,"column":204,"offset":4351},"indent":[]}}],"position":{"start":{"line":86,"column":1,"offset":4148},"end":{"line":86,"column":204,"offset":4351},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values.yaml","position":{"start":{"line":88,"column":1,"offset":4353},"end":{"line":89,"column":88,"offset":4501},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.","position":{"start":{"line":91,"column":1,"offset":4503},"end":{"line":91,"column":170,"offset":4672},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4503},"end":{"line":91,"column":170,"offset":4672},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)\necho $MONGODB_ROOT_PASSWORD","position":{"start":{"line":93,"column":1,"offset":4674},"end":{"line":94,"column":32,"offset":4850},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Enterprise Web App - The Factory","position":{"start":{"line":96,"column":4,"offset":4855},"end":{"line":96,"column":45,"offset":4896},"indent":[]}}],"position":{"start":{"line":96,"column":1,"offset":4852},"end":{"line":96,"column":45,"offset":4896},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the ","position":{"start":{"line":98,"column":1,"offset":4898},"end":{"line":98,"column":138,"offset":5035},"indent":[]}},{"type":"inlineCode","value":"Factory","position":{"start":{"line":98,"column":138,"offset":5035},"end":{"line":98,"column":147,"offset":5044},"indent":[]}},{"type":"text","value":". It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.","position":{"start":{"line":98,"column":147,"offset":5044},"end":{"line":98,"column":309,"offset":5206},"indent":[]}}],"position":{"start":{"line":98,"column":1,"offset":4898},"end":{"line":98,"column":309,"offset":5206},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the ","position":{"start":{"line":100,"column":1,"offset":5208},"end":{"line":100,"column":289,"offset":5496},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":100,"column":289,"offset":5496},"end":{"line":100,"column":298,"offset":5505},"indent":[]}},{"type":"text","value":" command.","position":{"start":{"line":100,"column":298,"offset":5505},"end":{"line":100,"column":307,"offset":5514},"indent":[]}}],"position":{"start":{"line":100,"column":1,"offset":5208},"end":{"line":100,"column":307,"offset":5514},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing the Factory web app, open the ","position":{"start":{"line":102,"column":1,"offset":5516},"end":{"line":102,"column":49,"offset":5564},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":102,"column":49,"offset":5564},"end":{"line":102,"column":92,"offset":5607},"indent":[]}},{"type":"text","value":" configuration file. At the bottom file you will find two endpoints, similar to the traefik config file. Update the domain names to your own domain, and add these to your DNS server (pointing to the same IP as the traefik EXTERNAL-IP).","position":{"start":{"line":102,"column":92,"offset":5607},"end":{"line":102,"column":327,"offset":5842},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":5516},"end":{"line":102,"column":327,"offset":5842},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 80\n--> - host: api.factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 8081","position":{"start":{"line":104,"column":1,"offset":5844},"end":{"line":119,"column":36,"offset":6276},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":121,"column":1,"offset":6278},"end":{"line":121,"column":99,"offset":6376},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":6278},"end":{"line":121,"column":99,"offset":6376},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":123,"column":1,"offset":6378},"end":{"line":126,"column":30,"offset":6497},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.","position":{"start":{"line":128,"column":1,"offset":6499},"end":{"line":128,"column":118,"offset":6616},"indent":[]}}],"position":{"start":{"line":128,"column":1,"offset":6499},"end":{"line":128,"column":118,"offset":6616},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":130,"column":1,"offset":6618},"end":{"line":130,"column":63,"offset":6680},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":132,"column":4,"offset":6685},"end":{"line":132,"column":26,"offset":6707},"indent":[]}}],"position":{"start":{"line":132,"column":1,"offset":6682},"end":{"line":132,"column":26,"offset":6707},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":134,"column":1,"offset":6709},"end":{"line":134,"column":94,"offset":6802},"indent":[]}}],"position":{"start":{"line":134,"column":1,"offset":6709},"end":{"line":134,"column":94,"offset":6802},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":136,"column":5,"offset":6808},"end":{"line":136,"column":12,"offset":6815},"indent":[]}}],"position":{"start":{"line":136,"column":5,"offset":6808},"end":{"line":136,"column":12,"offset":6815},"indent":[]}}],"position":{"start":{"line":136,"column":1,"offset":6804},"end":{"line":136,"column":12,"offset":6815},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":137,"column":5,"offset":6820},"end":{"line":137,"column":12,"offset":6827},"indent":[]}}],"position":{"start":{"line":137,"column":5,"offset":6820},"end":{"line":137,"column":12,"offset":6827},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":6816},"end":{"line":137,"column":12,"offset":6827},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Factory","position":{"start":{"line":138,"column":5,"offset":6832},"end":{"line":138,"column":12,"offset":6839},"indent":[]}}],"position":{"start":{"line":138,"column":5,"offset":6832},"end":{"line":138,"column":12,"offset":6839},"indent":[]}}],"position":{"start":{"line":138,"column":1,"offset":6828},"end":{"line":138,"column":12,"offset":6839},"indent":[]}}],"position":{"start":{"line":136,"column":1,"offset":6804},"end":{"line":138,"column":12,"offset":6839},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":140,"column":1,"offset":6841},"end":{"line":140,"column":26,"offset":6866},"indent":[]}}],"position":{"start":{"line":140,"column":1,"offset":6841},"end":{"line":140,"column":26,"offset":6866},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nfactory-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-758d5c5ddd-qsfq9 1/1 Running 0 5m31s\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":142,"column":1,"offset":6868},"end":{"line":146,"column":73,"offset":7180},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":148,"column":4,"offset":7185},"end":{"line":148,"column":21,"offset":7202},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":7182},"end":{"line":148,"column":21,"offset":7202},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain ","position":{"start":{"line":150,"column":1,"offset":7204},"end":{"line":150,"column":152,"offset":7355},"indent":[]}},{"type":"inlineCode","value":"factory.domain.com","position":{"start":{"line":150,"column":152,"offset":7355},"end":{"line":150,"column":172,"offset":7375},"indent":[]}},{"type":"text","value":" in your browser you will see the Factory login page showing up.","position":{"start":{"line":150,"column":172,"offset":7375},"end":{"line":150,"column":236,"offset":7439},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":7204},"end":{"line":150,"column":236,"offset":7439},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Factory","position":{"start":{"line":152,"column":1,"offset":7441},"end":{"line":152,"column":71,"offset":7511},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":7441},"end":{"line":152,"column":71,"offset":7511},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":155,"column":1,"offset":7514},"end":{"line":155,"column":31,"offset":7544},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":155,"column":31,"offset":7544}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Introduction`}

\n

{`Start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (`}{`AWS`}{`, `}{`GCP`}{` or `}{`Azure`}{`),\ncloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.`}

\n
\n
\n

\n

{`Installation`}

\n

{`Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.`}

\n
\n
\n

\n

{`First clone the configrations from our Github repo.`}

\n 
{`git clone https://github.com/kerberos-io/enterprise`}
\n

{`Next go into the directory and execute the first Kubernetes configuration file `}{`clusterrole.yaml`}{`.`}

\n 
{`kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml`}
\n

{`This will make several actions inside your cluster available. We need this to be able to create deployments from the factory web app.`}

\n

{`Helm`}

\n

{`Next we will install a couple of dependencies which are required for Kerberos Enterprise. `}{`Helm`}{` is a package manager for Kubernetes, it helps you setting up services more easily (this could be a MQTT broker, a database, etc).\nInstead of writing yaml files for every service we need, we use so called `}{`Charts`}{` (libraries), that you can reuse and configure the,\nwith the appropriate settings.`}

\n

{`Use one of the preferred OS package managers to install the Helm client:`}

\n 
{`brew install helm`}{`\n`}{`\n`}{`choco install kubernetes-helm`}{`\n`}{`\n`}{`scoop install helm`}{`\n`}{`\n`}{`gofish install helm`}
\n

{`Traefik`}

\n

{`Traefik`}{` is a reverse proxy and load balancer which allows you to expose your deployments more easily. Kerberos uses Traefik to expose it's APIs more easily.`}

\n

{`By executing following helm command, we will install traefik and link it to a specific DNS name. Open the traefik values file, `}{`./enterprise/yaml/traefik/values.yaml`}{`, and update the DNS name to your own domain.`}

\n 
{`    dashboard:`}{`\n`}{`      enabled: true`}{`\n`}{`-->   domain: traefik.domain.com`}{`\n`}{`      serviceType: NodePort`}{`\n`}{`    rbac:`}{`\n`}{`        enabled: true`}
\n

{`Add Helm repository and install traefik.`}

\n 
{`helm repo add stable https://kubernetes-charts.storage.googleapis.com`}{`\n`}{`helm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik`}
\n

{`After installation you should have an IP attached to traefik service, look for it by executing the `}{`get service`}{` command. You will see the ip address in the `}{`EXTERNAL-IP`}{` attribute.`}

\n 
{`kubectl get svc`}{`\n`}{`\n`}{`    NAME                        TYPE           CLUSTER-IP     EXTERNAL-IP     PORT(S)                      AGE`}{`\n`}{`    kubernetes                  ClusterIP      10.0.0.1                 443/TCP                      36h`}{`\n`}{`--> traefik                     LoadBalancer   10.0.27.93     40.114.168.96   443:31623/TCP,80:31804/TCP   35h`}{`\n`}{`    traefik-dashboard           NodePort       10.0.252.6               80:31146/TCP                 35h`}
\n

{`Go to your DNS provider and link the domain you've configured in the first step `}{`traefik.domain.com`}{` to the IP address of the `}{`EXTERNAL-IP`}{` attribute. When browsing to `}{`traefik.domain.com`}{`, you should see the traefik dashboard showing up.`}

\n

{`MongoDB`}

\n

{`When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use `}{`helm `}{`to install a MongoDB instance inside your cluster.`}

\n

{`Have a look into the `}{`yaml/mongodb/values.yaml`}{` file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb.`}

\n 
{`helm repo add bitnami https://charts.bitnami.com/bitnami`}{`\n`}{`helm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values.yaml`}
\n

{`Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.`}

\n 
{`export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)`}{`\n`}{`echo $MONGODB_ROOT_PASSWORD`}
\n

{`Kerberos Enterprise Web App - The Factory`}

\n

{`The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the `}{`Factory`}{`. It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.`}

\n

{`The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the `}{`kubectl`}{` command.`}

\n

{`Before installing the Factory web app, open the `}{`./enterprise/yaml/factory/deployment.yaml`}{` configuration file. At the bottom file you will find two endpoints, similar to the traefik config file. Update the domain names to your own domain, and add these to your DNS server (pointing to the same IP as the traefik EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 8081`}
\n

{`Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.`}

\n 
{`kubectl apply -f ./enterprise/yaml/factory/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Factory`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`factory-6f5c877d7c-hf77p          1/1     Running   0          2d11h`}{`\n`}{`mongodb-758d5c5ddd-qsfq9          1/1     Running   0          5m31s`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain `}{`factory.domain.com`}{` in your browser you will see the Factory login page showing up.`}

\n

\"Factory\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750188000,"key":"gatsby-plugin-mdx-entire-payload-0d73657aeb7fd347bdc9340e676a33ca-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":88,"offset":322},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"AWS","position":{"start":{"line":12,"column":90,"offset":324},"end":{"line":12,"column":93,"offset":327},"indent":[]}}],"position":{"start":{"line":12,"column":88,"offset":322},"end":{"line":12,"column":95,"offset":329},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":12,"column":95,"offset":329},"end":{"line":12,"column":97,"offset":331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"GCP","position":{"start":{"line":12,"column":99,"offset":333},"end":{"line":12,"column":102,"offset":336},"indent":[]}}],"position":{"start":{"line":12,"column":97,"offset":331},"end":{"line":12,"column":104,"offset":338},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":12,"column":104,"offset":338},"end":{"line":12,"column":108,"offset":342},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Azure","position":{"start":{"line":12,"column":110,"offset":344},"end":{"line":12,"column":115,"offset":349},"indent":[]}}],"position":{"start":{"line":12,"column":108,"offset":342},"end":{"line":12,"column":117,"offset":351},"indent":[]}},{"type":"text","value":"),\ncloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.","position":{"start":{"line":12,"column":117,"offset":351},"end":{"line":13,"column":90,"offset":443},"indent":[1]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":13,"column":90,"offset":443},"indent":[1]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":15,"column":1,"offset":445},"end":{"line":17,"column":11,"offset":647},"indent":[1,1]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":19,"column":3,"offset":651},"end":{"line":19,"column":15,"offset":663},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":649},"end":{"line":19,"column":15,"offset":663},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.","position":{"start":{"line":21,"column":1,"offset":665},"end":{"line":21,"column":323,"offset":987},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":665},"end":{"line":21,"column":323,"offset":987},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":23,"column":1,"offset":989},"end":{"line":25,"column":11,"offset":1191},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"First clone the configrations from our Github repo.","position":{"start":{"line":27,"column":1,"offset":1193},"end":{"line":27,"column":52,"offset":1244},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1193},"end":{"line":27,"column":52,"offset":1244},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/enterprise","position":{"start":{"line":29,"column":1,"offset":1246},"end":{"line":29,"column":56,"offset":1301},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next go into the directory and execute the first Kubernetes configuration file ","position":{"start":{"line":31,"column":1,"offset":1303},"end":{"line":31,"column":80,"offset":1382},"indent":[]}},{"type":"inlineCode","value":"clusterrole.yaml","position":{"start":{"line":31,"column":80,"offset":1382},"end":{"line":31,"column":98,"offset":1400},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":98,"offset":1400},"end":{"line":31,"column":99,"offset":1401},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1303},"end":{"line":31,"column":99,"offset":1401},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml","position":{"start":{"line":33,"column":1,"offset":1403},"end":{"line":33,"column":65,"offset":1467},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This will make several actions inside your cluster available. We need this to be able to create deployments from the factory web app.","position":{"start":{"line":35,"column":1,"offset":1469},"end":{"line":35,"column":134,"offset":1602},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1469},"end":{"line":35,"column":134,"offset":1602},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Helm","position":{"start":{"line":37,"column":4,"offset":1607},"end":{"line":37,"column":8,"offset":1611},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1604},"end":{"line":37,"column":8,"offset":1611},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next we will install a couple of dependencies which are required for Kerberos Enterprise. ","position":{"start":{"line":39,"column":1,"offset":1613},"end":{"line":39,"column":91,"offset":1703},"indent":[]}},{"type":"link","title":null,"url":"https://helm.sh/","children":[{"type":"strong","children":[{"type":"text","value":"Helm","position":{"start":{"line":39,"column":94,"offset":1706},"end":{"line":39,"column":98,"offset":1710},"indent":[]}}],"position":{"start":{"line":39,"column":92,"offset":1704},"end":{"line":39,"column":100,"offset":1712},"indent":[]}}],"position":{"start":{"line":39,"column":91,"offset":1703},"end":{"line":39,"column":119,"offset":1731},"indent":[]}},{"type":"text","value":" is a package manager for Kubernetes, it helps you setting up services more easily (this could be a MQTT broker, a database, etc).\nInstead of writing yaml files for every service we need, we use so called ","position":{"start":{"line":39,"column":119,"offset":1731},"end":{"line":40,"column":75,"offset":1936},"indent":[1]}},{"type":"strong","children":[{"type":"text","value":"Charts","position":{"start":{"line":40,"column":77,"offset":1938},"end":{"line":40,"column":83,"offset":1944},"indent":[]}}],"position":{"start":{"line":40,"column":75,"offset":1936},"end":{"line":40,"column":85,"offset":1946},"indent":[]}},{"type":"text","value":" (libraries), that you can reuse and configure the,\nwith the appropriate settings.","position":{"start":{"line":40,"column":85,"offset":1946},"end":{"line":41,"column":31,"offset":2028},"indent":[1]}}],"position":{"start":{"line":39,"column":1,"offset":1613},"end":{"line":41,"column":31,"offset":2028},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Use one of the preferred OS package managers to install the Helm client:","position":{"start":{"line":43,"column":1,"offset":2030},"end":{"line":43,"column":73,"offset":2102},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2030},"end":{"line":43,"column":73,"offset":2102},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"brew install helm\n\nchoco install kubernetes-helm\n\nscoop install helm\n\ngofish install helm","position":{"start":{"line":45,"column":1,"offset":2104},"end":{"line":51,"column":24,"offset":2209},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Traefik","position":{"start":{"line":53,"column":4,"offset":2214},"end":{"line":53,"column":11,"offset":2221},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2211},"end":{"line":53,"column":11,"offset":2221},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://containo.us/traefik/","children":[{"type":"strong","children":[{"type":"text","value":"Traefik","position":{"start":{"line":55,"column":4,"offset":2226},"end":{"line":55,"column":11,"offset":2233},"indent":[]}}],"position":{"start":{"line":55,"column":2,"offset":2224},"end":{"line":55,"column":13,"offset":2235},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2223},"end":{"line":55,"column":44,"offset":2266},"indent":[]}},{"type":"text","value":" is a reverse proxy and load balancer which allows you to expose your deployments more easily. Kerberos uses Traefik to expose it's APIs more easily.","position":{"start":{"line":55,"column":44,"offset":2266},"end":{"line":55,"column":193,"offset":2415},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2223},"end":{"line":55,"column":193,"offset":2415},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By executing following helm command, we will install traefik and link it to a specific DNS name. Open the traefik values file, ","position":{"start":{"line":57,"column":1,"offset":2417},"end":{"line":57,"column":128,"offset":2544},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/traefik/values.yaml","position":{"start":{"line":57,"column":128,"offset":2544},"end":{"line":57,"column":167,"offset":2583},"indent":[]}},{"type":"text","value":", and update the DNS name to your own domain.","position":{"start":{"line":57,"column":167,"offset":2583},"end":{"line":57,"column":212,"offset":2628},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2417},"end":{"line":57,"column":212,"offset":2628},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" dashboard:\n enabled: true\n--> domain: traefik.domain.com\n serviceType: NodePort\n rbac:\n enabled: true","position":{"start":{"line":59,"column":1,"offset":2630},"end":{"line":64,"column":26,"offset":2781},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Add Helm repository and install traefik.","position":{"start":{"line":66,"column":1,"offset":2783},"end":{"line":66,"column":41,"offset":2823},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":2783},"end":{"line":66,"column":41,"offset":2823},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add stable https://kubernetes-charts.storage.googleapis.com\nhelm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik","position":{"start":{"line":68,"column":1,"offset":2825},"end":{"line":69,"column":81,"offset":2979},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"After installation you should have an IP attached to traefik service, look for it by executing the ","position":{"start":{"line":71,"column":1,"offset":2981},"end":{"line":71,"column":100,"offset":3080},"indent":[]}},{"type":"inlineCode","value":"get service","position":{"start":{"line":71,"column":100,"offset":3080},"end":{"line":71,"column":113,"offset":3093},"indent":[]}},{"type":"text","value":" command. You will see the ip address in the ","position":{"start":{"line":71,"column":113,"offset":3093},"end":{"line":71,"column":158,"offset":3138},"indent":[]}},{"type":"inlineCode","value":"EXTERNAL-IP","position":{"start":{"line":71,"column":158,"offset":3138},"end":{"line":71,"column":171,"offset":3151},"indent":[]}},{"type":"text","value":" attribute.","position":{"start":{"line":71,"column":171,"offset":3151},"end":{"line":71,"column":182,"offset":3162},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":2981},"end":{"line":71,"column":182,"offset":3162},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl get svc\n\n NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE\n kubernetes ClusterIP 10.0.0.1 443/TCP 36h\n--> traefik LoadBalancer 10.0.27.93 40.114.168.96 443:31623/TCP,80:31804/TCP 35h\n traefik-dashboard NodePort 10.0.252.6 80:31146/TCP 35h","position":{"start":{"line":73,"column":1,"offset":3164},"end":{"line":78,"column":115,"offset":3644},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Go to your DNS provider and link the domain you've configured in the first step ","position":{"start":{"line":80,"column":1,"offset":3646},"end":{"line":80,"column":81,"offset":3726},"indent":[]}},{"type":"inlineCode","value":"traefik.domain.com","position":{"start":{"line":80,"column":81,"offset":3726},"end":{"line":80,"column":101,"offset":3746},"indent":[]}},{"type":"text","value":" to the IP address of the ","position":{"start":{"line":80,"column":101,"offset":3746},"end":{"line":80,"column":127,"offset":3772},"indent":[]}},{"type":"inlineCode","value":"EXTERNAL-IP","position":{"start":{"line":80,"column":127,"offset":3772},"end":{"line":80,"column":140,"offset":3785},"indent":[]}},{"type":"text","value":" attribute. When browsing to ","position":{"start":{"line":80,"column":140,"offset":3785},"end":{"line":80,"column":169,"offset":3814},"indent":[]}},{"type":"inlineCode","value":"traefik.domain.com","position":{"start":{"line":80,"column":169,"offset":3814},"end":{"line":80,"column":189,"offset":3834},"indent":[]}},{"type":"text","value":", you should see the traefik dashboard showing up.","position":{"start":{"line":80,"column":189,"offset":3834},"end":{"line":80,"column":239,"offset":3884},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":3646},"end":{"line":80,"column":239,"offset":3884},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"MongoDB","position":{"start":{"line":82,"column":4,"offset":3889},"end":{"line":82,"column":11,"offset":3896},"indent":[]}}],"position":{"start":{"line":82,"column":1,"offset":3886},"end":{"line":82,"column":11,"offset":3896},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use ","position":{"start":{"line":84,"column":1,"offset":3898},"end":{"line":84,"column":192,"offset":4089},"indent":[]}},{"type":"inlineCode","value":"helm ","position":{"start":{"line":84,"column":192,"offset":4089},"end":{"line":84,"column":199,"offset":4096},"indent":[]}},{"type":"text","value":"to install a MongoDB instance inside your cluster.","position":{"start":{"line":84,"column":199,"offset":4096},"end":{"line":84,"column":249,"offset":4146},"indent":[]}}],"position":{"start":{"line":84,"column":1,"offset":3898},"end":{"line":84,"column":249,"offset":4146},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Have a look into the ","position":{"start":{"line":86,"column":1,"offset":4148},"end":{"line":86,"column":22,"offset":4169},"indent":[]}},{"type":"inlineCode","value":"yaml/mongodb/values.yaml","position":{"start":{"line":86,"column":22,"offset":4169},"end":{"line":86,"column":48,"offset":4195},"indent":[]}},{"type":"text","value":" file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb.","position":{"start":{"line":86,"column":48,"offset":4195},"end":{"line":86,"column":204,"offset":4351},"indent":[]}}],"position":{"start":{"line":86,"column":1,"offset":4148},"end":{"line":86,"column":204,"offset":4351},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values.yaml","position":{"start":{"line":88,"column":1,"offset":4353},"end":{"line":89,"column":88,"offset":4501},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.","position":{"start":{"line":91,"column":1,"offset":4503},"end":{"line":91,"column":170,"offset":4672},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4503},"end":{"line":91,"column":170,"offset":4672},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)\necho $MONGODB_ROOT_PASSWORD","position":{"start":{"line":93,"column":1,"offset":4674},"end":{"line":94,"column":32,"offset":4850},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Enterprise Web App - The Factory","position":{"start":{"line":96,"column":4,"offset":4855},"end":{"line":96,"column":45,"offset":4896},"indent":[]}}],"position":{"start":{"line":96,"column":1,"offset":4852},"end":{"line":96,"column":45,"offset":4896},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the ","position":{"start":{"line":98,"column":1,"offset":4898},"end":{"line":98,"column":138,"offset":5035},"indent":[]}},{"type":"inlineCode","value":"Factory","position":{"start":{"line":98,"column":138,"offset":5035},"end":{"line":98,"column":147,"offset":5044},"indent":[]}},{"type":"text","value":". It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.","position":{"start":{"line":98,"column":147,"offset":5044},"end":{"line":98,"column":309,"offset":5206},"indent":[]}}],"position":{"start":{"line":98,"column":1,"offset":4898},"end":{"line":98,"column":309,"offset":5206},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the ","position":{"start":{"line":100,"column":1,"offset":5208},"end":{"line":100,"column":289,"offset":5496},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":100,"column":289,"offset":5496},"end":{"line":100,"column":298,"offset":5505},"indent":[]}},{"type":"text","value":" command.","position":{"start":{"line":100,"column":298,"offset":5505},"end":{"line":100,"column":307,"offset":5514},"indent":[]}}],"position":{"start":{"line":100,"column":1,"offset":5208},"end":{"line":100,"column":307,"offset":5514},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing the Factory web app, open the ","position":{"start":{"line":102,"column":1,"offset":5516},"end":{"line":102,"column":49,"offset":5564},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":102,"column":49,"offset":5564},"end":{"line":102,"column":92,"offset":5607},"indent":[]}},{"type":"text","value":" configuration file. At the bottom file you will find two endpoints, similar to the traefik config file. Update the domain names to your own domain, and add these to your DNS server (pointing to the same IP as the traefik EXTERNAL-IP).","position":{"start":{"line":102,"column":92,"offset":5607},"end":{"line":102,"column":327,"offset":5842},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":5516},"end":{"line":102,"column":327,"offset":5842},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 80\n--> - host: api.factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 8081","position":{"start":{"line":104,"column":1,"offset":5844},"end":{"line":119,"column":36,"offset":6276},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":121,"column":1,"offset":6278},"end":{"line":121,"column":99,"offset":6376},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":6278},"end":{"line":121,"column":99,"offset":6376},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":123,"column":1,"offset":6378},"end":{"line":126,"column":30,"offset":6497},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.","position":{"start":{"line":128,"column":1,"offset":6499},"end":{"line":128,"column":118,"offset":6616},"indent":[]}}],"position":{"start":{"line":128,"column":1,"offset":6499},"end":{"line":128,"column":118,"offset":6616},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":130,"column":1,"offset":6618},"end":{"line":130,"column":63,"offset":6680},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":132,"column":4,"offset":6685},"end":{"line":132,"column":26,"offset":6707},"indent":[]}}],"position":{"start":{"line":132,"column":1,"offset":6682},"end":{"line":132,"column":26,"offset":6707},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":134,"column":1,"offset":6709},"end":{"line":134,"column":94,"offset":6802},"indent":[]}}],"position":{"start":{"line":134,"column":1,"offset":6709},"end":{"line":134,"column":94,"offset":6802},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":136,"column":5,"offset":6808},"end":{"line":136,"column":12,"offset":6815},"indent":[]}}],"position":{"start":{"line":136,"column":5,"offset":6808},"end":{"line":136,"column":12,"offset":6815},"indent":[]}}],"position":{"start":{"line":136,"column":1,"offset":6804},"end":{"line":136,"column":12,"offset":6815},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":137,"column":5,"offset":6820},"end":{"line":137,"column":12,"offset":6827},"indent":[]}}],"position":{"start":{"line":137,"column":5,"offset":6820},"end":{"line":137,"column":12,"offset":6827},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":6816},"end":{"line":137,"column":12,"offset":6827},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Factory","position":{"start":{"line":138,"column":5,"offset":6832},"end":{"line":138,"column":12,"offset":6839},"indent":[]}}],"position":{"start":{"line":138,"column":5,"offset":6832},"end":{"line":138,"column":12,"offset":6839},"indent":[]}}],"position":{"start":{"line":138,"column":1,"offset":6828},"end":{"line":138,"column":12,"offset":6839},"indent":[]}}],"position":{"start":{"line":136,"column":1,"offset":6804},"end":{"line":138,"column":12,"offset":6839},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":140,"column":1,"offset":6841},"end":{"line":140,"column":26,"offset":6866},"indent":[]}}],"position":{"start":{"line":140,"column":1,"offset":6841},"end":{"line":140,"column":26,"offset":6866},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nfactory-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-758d5c5ddd-qsfq9 1/1 Running 0 5m31s\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":142,"column":1,"offset":6868},"end":{"line":146,"column":73,"offset":7180},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":148,"column":4,"offset":7185},"end":{"line":148,"column":21,"offset":7202},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":7182},"end":{"line":148,"column":21,"offset":7202},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain ","position":{"start":{"line":150,"column":1,"offset":7204},"end":{"line":150,"column":152,"offset":7355},"indent":[]}},{"type":"inlineCode","value":"factory.domain.com","position":{"start":{"line":150,"column":152,"offset":7355},"end":{"line":150,"column":172,"offset":7375},"indent":[]}},{"type":"text","value":" in your browser you will see the Factory login page showing up.","position":{"start":{"line":150,"column":172,"offset":7375},"end":{"line":150,"column":236,"offset":7439},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":7204},"end":{"line":150,"column":236,"offset":7439},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Factory","position":{"start":{"line":152,"column":1,"offset":7441},"end":{"line":152,"column":71,"offset":7511},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":7441},"end":{"line":152,"column":71,"offset":7511},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":155,"column":1,"offset":7514},"end":{"line":155,"column":31,"offset":7544},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":155,"column":31,"offset":7544}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Introduction`}

\n

{`Start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (`}{`AWS`}{`, `}{`GCP`}{` or `}{`Azure`}{`),\ncloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.`}

\n
\n
\n

\n

{`Installation`}

\n

{`Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.`}

\n
\n
\n

\n

{`First clone the configrations from our Github repo.`}

\n 
{`git clone https://github.com/kerberos-io/enterprise`}
\n

{`Next go into the directory and execute the first Kubernetes configuration file `}{`clusterrole.yaml`}{`.`}

\n 
{`kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml`}
\n

{`This will make several actions inside your cluster available. We need this to be able to create deployments from the factory web app.`}

\n

{`Helm`}

\n

{`Next we will install a couple of dependencies which are required for Kerberos Enterprise. `}{`Helm`}{` is a package manager for Kubernetes, it helps you setting up services more easily (this could be a MQTT broker, a database, etc).\nInstead of writing yaml files for every service we need, we use so called `}{`Charts`}{` (libraries), that you can reuse and configure the,\nwith the appropriate settings.`}

\n

{`Use one of the preferred OS package managers to install the Helm client:`}

\n 
{`brew install helm`}{`\n`}{`\n`}{`choco install kubernetes-helm`}{`\n`}{`\n`}{`scoop install helm`}{`\n`}{`\n`}{`gofish install helm`}
\n

{`Traefik`}

\n

{`Traefik`}{` is a reverse proxy and load balancer which allows you to expose your deployments more easily. Kerberos uses Traefik to expose it's APIs more easily.`}

\n

{`By executing following helm command, we will install traefik and link it to a specific DNS name. Open the traefik values file, `}{`./enterprise/yaml/traefik/values.yaml`}{`, and update the DNS name to your own domain.`}

\n 
{`    dashboard:`}{`\n`}{`      enabled: true`}{`\n`}{`-->   domain: traefik.domain.com`}{`\n`}{`      serviceType: NodePort`}{`\n`}{`    rbac:`}{`\n`}{`        enabled: true`}
\n

{`Add Helm repository and install traefik.`}

\n 
{`helm repo add stable https://kubernetes-charts.storage.googleapis.com`}{`\n`}{`helm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik`}
\n

{`After installation you should have an IP attached to traefik service, look for it by executing the `}{`get service`}{` command. You will see the ip address in the `}{`EXTERNAL-IP`}{` attribute.`}

\n 
{`kubectl get svc`}{`\n`}{`\n`}{`    NAME                        TYPE           CLUSTER-IP     EXTERNAL-IP     PORT(S)                      AGE`}{`\n`}{`    kubernetes                  ClusterIP      10.0.0.1                 443/TCP                      36h`}{`\n`}{`--> traefik                     LoadBalancer   10.0.27.93     40.114.168.96   443:31623/TCP,80:31804/TCP   35h`}{`\n`}{`    traefik-dashboard           NodePort       10.0.252.6               80:31146/TCP                 35h`}
\n

{`Go to your DNS provider and link the domain you've configured in the first step `}{`traefik.domain.com`}{` to the IP address of the `}{`EXTERNAL-IP`}{` attribute. When browsing to `}{`traefik.domain.com`}{`, you should see the traefik dashboard showing up.`}

\n

{`MongoDB`}

\n

{`When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use `}{`helm `}{`to install a MongoDB instance inside your cluster.`}

\n

{`Have a look into the `}{`yaml/mongodb/values.yaml`}{` file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb.`}

\n 
{`helm repo add bitnami https://charts.bitnami.com/bitnami`}{`\n`}{`helm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values.yaml`}
\n

{`Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.`}

\n 
{`export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)`}{`\n`}{`echo $MONGODB_ROOT_PASSWORD`}
\n

{`Kerberos Enterprise Web App - The Factory`}

\n

{`The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the `}{`Factory`}{`. It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.`}

\n

{`The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the `}{`kubectl`}{` command.`}

\n

{`Before installing the Factory web app, open the `}{`./enterprise/yaml/factory/deployment.yaml`}{` configuration file. At the bottom file you will find two endpoints, similar to the traefik config file. Update the domain names to your own domain, and add these to your DNS server (pointing to the same IP as the traefik EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 8081`}
\n

{`Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.`}

\n 
{`kubectl apply -f ./enterprise/yaml/factory/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Factory`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`factory-6f5c877d7c-hf77p          1/1     Running   0          2d11h`}{`\n`}{`mongodb-758d5c5ddd-qsfq9          1/1     Running   0          5m31s`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain `}{`factory.domain.com`}{` in your browser you will see the Factory login page showing up.`}

\n

\"Factory\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-884ae4bc41832f440e053ce0989e7eaa.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-884ae4bc41832f440e053ce0989e7eaa.json new file mode 100644 index 0000000..c82a975 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-884ae4bc41832f440e053ce0989e7eaa.json @@ -0,0 +1 @@ +{"expireTime":9007200861750268000,"key":"gatsby-plugin-mdx-entire-payload-203dd05e1aac71a52550d385b98709b4-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Enterprise","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.","position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}}],"position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Next to that many other vendors started working on custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, and closed software with limited API or messaging capabilities.","position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":205,"offset":982},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":205,"offset":982},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud which is open solution stack, suitable for scaling against your ever growing video surveillance landscape, but having extensibility and integration built-in from the start.","position":{"start":{"line":18,"column":1,"offset":984},"end":{"line":18,"column":269,"offset":1252},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":984},"end":{"line":18,"column":269,"offset":1252},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":20,"column":1,"offset":1254},"end":{"line":22,"column":11,"offset":1456},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":24,"column":4,"offset":1461},"end":{"line":24,"column":14,"offset":1471},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1458},"end":{"line":24,"column":14,"offset":1471},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.","position":{"start":{"line":26,"column":1,"offset":1473},"end":{"line":26,"column":306,"offset":1778},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1473},"end":{"line":26,"column":306,"offset":1778},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":28,"column":1,"offset":1780},"end":{"line":28,"column":91,"offset":1870},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1780},"end":{"line":28,"column":91,"offset":1870},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).","position":{"start":{"line":30,"column":1,"offset":1872},"end":{"line":30,"column":239,"offset":2110},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1872},"end":{"line":30,"column":239,"offset":2110},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.","position":{"start":{"line":32,"column":1,"offset":2112},"end":{"line":32,"column":242,"offset":2353},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2112},"end":{"line":32,"column":242,"offset":2353},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.","position":{"start":{"line":34,"column":1,"offset":2355},"end":{"line":34,"column":205,"offset":2559},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2355},"end":{"line":34,"column":205,"offset":2559},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud or on premise","position":{"start":{"line":36,"column":4,"offset":2564},"end":{"line":36,"column":23,"offset":2583},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2561},"end":{"line":36,"column":23,"offset":2583},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.","position":{"start":{"line":38,"column":1,"offset":2585},"end":{"line":38,"column":283,"offset":2867},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2585},"end":{"line":38,"column":283,"offset":2867},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":40,"column":1,"offset":2869},"end":{"line":40,"column":97,"offset":2965},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2869},"end":{"line":40,"column":97,"offset":2965},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":42,"column":4,"offset":2970},"end":{"line":42,"column":13,"offset":2979},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2967},"end":{"line":42,"column":13,"offset":2979},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is publicly available and ","position":{"start":{"line":44,"column":1,"offset":2981},"end":{"line":44,"column":47,"offset":3027},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":44,"column":49,"offset":3029},"end":{"line":44,"column":57,"offset":3037},"indent":[]}}],"position":{"start":{"line":44,"column":47,"offset":3027},"end":{"line":44,"column":59,"offset":3039},"indent":[]}},{"type":"text","value":" require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.","position":{"start":{"line":44,"column":59,"offset":3039},"end":{"line":44,"column":174,"offset":3154},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":2981},"end":{"line":44,"column":174,"offset":3154},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":47,"column":1,"offset":3157},"end":{"line":47,"column":31,"offset":3187},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":47,"column":31,"offset":3187}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Enterprise`}

\n

{`Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.`}

\n

{`That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.`}

\n

{`Next to that many other vendors started working on custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, and closed software with limited API or messaging capabilities.`}

\n

{`Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud which is open solution stack, suitable for scaling against your ever growing video surveillance landscape, but having extensibility and integration built-in from the start.`}

\n
\n
\n

\n

{`Kubernetes`}

\n

{`To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.`}

\n

\"architecture

\n

{`Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).`}

\n

{`Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.`}

\n

{`By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.`}

\n

{`Cloud or on premise`}

\n

{`You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.`}

\n

\"architecture

\n

{`Licensing`}

\n

{`Kerberos Enterprise is publicly available and `}{`does not`}{` require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-88953cccab6dbee55302a5959b203981.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-88953cccab6dbee55302a5959b203981.json index 5e7f5d4..49cb47e 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-88953cccab6dbee55302a5959b203981.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-88953cccab6dbee55302a5959b203981.json @@ -1 +1 @@ -{"expireTime":9007200861747683000,"key":"gatsby-plugin-mdx-entire-payload-15219f36e3fb0a19a215f22d171e7f22-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":15,"offset":173},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":15,"offset":173},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If not already the case, start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (","position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":113,"offset":287},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"AWS","position":{"start":{"line":10,"column":115,"offset":289},"end":{"line":10,"column":118,"offset":292},"indent":[]}}],"position":{"start":{"line":10,"column":113,"offset":287},"end":{"line":10,"column":120,"offset":294},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":10,"column":120,"offset":294},"end":{"line":10,"column":122,"offset":296},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"GCP","position":{"start":{"line":10,"column":124,"offset":298},"end":{"line":10,"column":127,"offset":301},"indent":[]}}],"position":{"start":{"line":10,"column":122,"offset":296},"end":{"line":10,"column":129,"offset":303},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":10,"column":129,"offset":303},"end":{"line":10,"column":133,"offset":307},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Azure","position":{"start":{"line":10,"column":135,"offset":309},"end":{"line":10,"column":140,"offset":314},"indent":[]}}],"position":{"start":{"line":10,"column":133,"offset":307},"end":{"line":10,"column":142,"offset":316},"indent":[]}},{"type":"text","value":"), cloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.","position":{"start":{"line":10,"column":142,"offset":316},"end":{"line":10,"column":234,"offset":408},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":234,"offset":408},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":12,"column":1,"offset":410},"end":{"line":14,"column":11,"offset":612},"indent":[1,1]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":16,"column":3,"offset":616},"end":{"line":16,"column":16,"offset":629},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":614},"end":{"line":16,"column":16,"offset":629},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is the storage component for Kerberos Enterprise. It is used to store your recordings at a central place, in the storage system you prefer. Next to that it can be used for extension and integration capabilities. Learn more about ","position":{"start":{"line":18,"column":1,"offset":631},"end":{"line":18,"column":247,"offset":877},"indent":[]}},{"type":"link","title":null,"url":"/storage","children":[{"type":"text","value":"Kerberos Storage here","position":{"start":{"line":18,"column":248,"offset":878},"end":{"line":18,"column":269,"offset":899},"indent":[]}}],"position":{"start":{"line":18,"column":247,"offset":877},"end":{"line":18,"column":280,"offset":910},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":18,"column":280,"offset":910},"end":{"line":18,"column":281,"offset":911},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":631},"end":{"line":18,"column":281,"offset":911},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To use Kerberos Storage, you will need to have Kerberos Enterprise installed, and deployments running. Independent from that one can also use the Kerberos Storage API ","position":{"start":{"line":20,"column":1,"offset":913},"end":{"line":20,"column":168,"offset":1080},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":20,"column":168,"offset":1080},"end":{"line":20,"column":189,"offset":1101},"indent":[]}},{"type":"text","value":" to send recordings from a custom build VMS.","position":{"start":{"line":20,"column":189,"offset":1101},"end":{"line":20,"column":233,"offset":1145},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":913},"end":{"line":20,"column":233,"offset":1145},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":22,"column":3,"offset":1149},"end":{"line":22,"column":15,"offset":1161},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1147},"end":{"line":22,"column":15,"offset":1161},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to Kerberos Enterprise, Kerberos Storage, requires some initial components to be installed. If you will run Kerberos Storage in the same cluster as where you have Kerberos Enterprise running, there is not much to do.","position":{"start":{"line":24,"column":1,"offset":1163},"end":{"line":24,"column":225,"offset":1387},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1163},"end":{"line":24,"column":225,"offset":1387},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":26,"column":1,"offset":1389},"end":{"line":26,"column":99,"offset":1487},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1389},"end":{"line":26,"column":99,"offset":1487},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"However if you plan to run Kerberos Storage in a different cluster (which is perfectly possible), you will need to make sure you complete the initial setup of ","position":{"start":{"line":28,"column":1,"offset":1489},"end":{"line":28,"column":160,"offset":1648},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/installation","children":[{"type":"text","value":"Kerberos Enterprise installation","position":{"start":{"line":28,"column":161,"offset":1649},"end":{"line":28,"column":193,"offset":1681},"indent":[]}}],"position":{"start":{"line":28,"column":160,"offset":1648},"end":{"line":28,"column":220,"offset":1708},"indent":[]}},{"type":"text","value":". To be more specific you will need the following components running:","position":{"start":{"line":28,"column":220,"offset":1708},"end":{"line":28,"column":289,"offset":1777},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1489},"end":{"line":28,"column":289,"offset":1777},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Helm","position":{"start":{"line":30,"column":3,"offset":1781},"end":{"line":30,"column":7,"offset":1785},"indent":[]}}],"position":{"start":{"line":30,"column":3,"offset":1781},"end":{"line":30,"column":7,"offset":1785},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1779},"end":{"line":30,"column":7,"offset":1785},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":31,"column":3,"offset":1788},"end":{"line":31,"column":10,"offset":1795},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1788},"end":{"line":31,"column":10,"offset":1795},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1786},"end":{"line":31,"column":10,"offset":1795},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":32,"column":3,"offset":1798},"end":{"line":32,"column":10,"offset":1805},"indent":[]}}],"position":{"start":{"line":32,"column":3,"offset":1798},"end":{"line":32,"column":10,"offset":1805},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1796},"end":{"line":32,"column":10,"offset":1805},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1779},"end":{"line":32,"column":10,"offset":1805},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once this is done start by cloning the configurations from our ","position":{"start":{"line":34,"column":1,"offset":1807},"end":{"line":34,"column":64,"offset":1870},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/storage","children":[{"type":"text","value":"Github repo","position":{"start":{"line":34,"column":65,"offset":1871},"end":{"line":34,"column":76,"offset":1882},"indent":[]}}],"position":{"start":{"line":34,"column":64,"offset":1870},"end":{"line":34,"column":117,"offset":1923},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":34,"column":117,"offset":1923},"end":{"line":34,"column":118,"offset":1924},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":1807},"end":{"line":34,"column":118,"offset":1924},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/storage","position":{"start":{"line":36,"column":1,"offset":1926},"end":{"line":36,"column":53,"offset":1978},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage","position":{"start":{"line":38,"column":4,"offset":1983},"end":{"line":38,"column":11,"offset":1990},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1980},"end":{"line":38,"column":11,"offset":1990},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to Kerberos Enterprise, Kerberos Storage is managed through a web app. It allows you to add storage providers (S3, minio, etc), add queues for messaging, accounts for security and much more. It also comes with API's, which you can use to interact and retrieve information from Kerberos Storage. All is documented in the form of Swagger APIs ","position":{"start":{"line":40,"column":1,"offset":1992},"end":{"line":40,"column":350,"offset":2341},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":40,"column":350,"offset":2341},"end":{"line":40,"column":371,"offset":2362},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":40,"column":371,"offset":2362},"end":{"line":40,"column":372,"offset":2363},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1992},"end":{"line":40,"column":372,"offset":2363},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing Kerberos Storage, open the ","position":{"start":{"line":42,"column":1,"offset":2365},"end":{"line":42,"column":46,"offset":2410},"indent":[]}},{"type":"inlineCode","value":"./storage/yaml/deployment.yaml","position":{"start":{"line":42,"column":46,"offset":2410},"end":{"line":42,"column":78,"offset":2442},"indent":[]}},{"type":"text","value":" configuration file. At the bottom file you will find two endpoints, similar to the Traefik config file below. Update the domain names to your own domain, and add these to your DNS server or ","position":{"start":{"line":42,"column":78,"offset":2442},"end":{"line":42,"column":269,"offset":2633},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":42,"column":269,"offset":2633},"end":{"line":42,"column":281,"offset":2645},"indent":[]}},{"type":"text","value":" file (and point to the same IP as the Traefik EXTERNAL-IP).","position":{"start":{"line":42,"column":281,"offset":2645},"end":{"line":42,"column":341,"offset":2705},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2365},"end":{"line":42,"column":341,"offset":2705},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: storage.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: kerberos-storage\n servicePort: 80\n--> - host: api.storage.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: kerberos-storage\n servicePort: 8081","position":{"start":{"line":44,"column":1,"offset":2707},"end":{"line":59,"column":36,"offset":3157},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":61,"column":1,"offset":3159},"end":{"line":61,"column":112,"offset":3270},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3159},"end":{"line":61,"column":112,"offset":3270},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":63,"column":1,"offset":3272},"end":{"line":66,"column":30,"offset":3391},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names and MongoDB credentials, install Kerberos Storage inside your cluster.","position":{"start":{"line":68,"column":1,"offset":3393},"end":{"line":68,"column":109,"offset":3501},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":3393},"end":{"line":68,"column":109,"offset":3501},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./storage/yaml/deployment.yaml","position":{"start":{"line":70,"column":1,"offset":3503},"end":{"line":70,"column":52,"offset":3554},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":72,"column":4,"offset":3559},"end":{"line":72,"column":26,"offset":3581},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3556},"end":{"line":72,"column":26,"offset":3581},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":74,"column":1,"offset":3583},"end":{"line":74,"column":94,"offset":3676},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":3583},"end":{"line":74,"column":94,"offset":3676},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":76,"column":5,"offset":3682},"end":{"line":76,"column":12,"offset":3689},"indent":[]}}],"position":{"start":{"line":76,"column":5,"offset":3682},"end":{"line":76,"column":12,"offset":3689},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":3678},"end":{"line":76,"column":12,"offset":3689},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":77,"column":5,"offset":3694},"end":{"line":77,"column":12,"offset":3701},"indent":[]}}],"position":{"start":{"line":77,"column":5,"offset":3694},"end":{"line":77,"column":12,"offset":3701},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3690},"end":{"line":77,"column":12,"offset":3701},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Storage","position":{"start":{"line":78,"column":5,"offset":3706},"end":{"line":78,"column":12,"offset":3713},"indent":[]}}],"position":{"start":{"line":78,"column":5,"offset":3706},"end":{"line":78,"column":12,"offset":3713},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":3702},"end":{"line":78,"column":12,"offset":3713},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Enterprise (optional)","position":{"start":{"line":79,"column":5,"offset":3718},"end":{"line":79,"column":26,"offset":3739},"indent":[]}}],"position":{"start":{"line":79,"column":5,"offset":3718},"end":{"line":79,"column":26,"offset":3739},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3714},"end":{"line":79,"column":26,"offset":3739},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":3678},"end":{"line":79,"column":26,"offset":3739},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":81,"column":1,"offset":3741},"end":{"line":81,"column":26,"offset":3766},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3741},"end":{"line":81,"column":26,"offset":3766},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nkerberos-storage-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-55566dc65c-xgmns 2/2 Running 0 4d13h\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":83,"column":1,"offset":3768},"end":{"line":87,"column":73,"offset":4080},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":89,"column":4,"offset":4085},"end":{"line":89,"column":21,"offset":4102},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4082},"end":{"line":89,"column":21,"offset":4102},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS or ","position":{"start":{"line":91,"column":1,"offset":4104},"end":{"line":91,"column":65,"offset":4168},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":91,"column":65,"offset":4168},"end":{"line":91,"column":77,"offset":4180},"indent":[]}},{"type":"text","value":" file, you should be able to access the Storage application. By navigating to the Storage domain ","position":{"start":{"line":91,"column":77,"offset":4180},"end":{"line":91,"column":174,"offset":4277},"indent":[]}},{"type":"inlineCode","value":"storage.domain.com","position":{"start":{"line":91,"column":174,"offset":4277},"end":{"line":91,"column":194,"offset":4297},"indent":[]}},{"type":"text","value":" in your browser you will see the Storage login page showing up.","position":{"start":{"line":91,"column":194,"offset":4297},"end":{"line":91,"column":258,"offset":4361},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4104},"end":{"line":91,"column":258,"offset":4361},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Storage","position":{"start":{"line":93,"column":1,"offset":4363},"end":{"line":93,"column":71,"offset":4433},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4363},"end":{"line":93,"column":71,"offset":4433},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":96,"column":1,"offset":4436},"end":{"line":96,"column":31,"offset":4466},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":96,"column":31,"offset":4466}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Introduction`}

\n

{`If not already the case, start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (`}{`AWS`}{`, `}{`GCP`}{` or `}{`Azure`}{`), cloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.`}

\n
\n
\n

\n

{`Prerequisites`}

\n

{`Kerberos Storage is the storage component for Kerberos Enterprise. It is used to store your recordings at a central place, in the storage system you prefer. Next to that it can be used for extension and integration capabilities. Learn more about `}{`Kerberos Storage here`}{`.`}

\n

{`To use Kerberos Storage, you will need to have Kerberos Enterprise installed, and deployments running. Independent from that one can also use the Kerberos Storage API `}{`/swagger/index.html`}{` to send recordings from a custom build VMS.`}

\n

{`Installation`}

\n

{`Similar to Kerberos Enterprise, Kerberos Storage, requires some initial components to be installed. If you will run Kerberos Storage in the same cluster as where you have Kerberos Enterprise running, there is not much to do.`}

\n

\"architecture

\n

{`However if you plan to run Kerberos Storage in a different cluster (which is perfectly possible), you will need to make sure you complete the initial setup of `}{`Kerberos Enterprise installation`}{`. To be more specific you will need the following components running:`}

\n
    \n
  • {`Helm`}
    • \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
\n

{`Once this is done start by cloning the configurations from our `}{`Github repo`}{`.`}

\n 
{`git clone https://github.com/kerberos-io/storage`}
\n

{`Storage`}

\n

{`Similar to Kerberos Enterprise, Kerberos Storage is managed through a web app. It allows you to add storage providers (S3, minio, etc), add queues for messaging, accounts for security and much more. It also comes with API's, which you can use to interact and retrieve information from Kerberos Storage. All is documented in the form of Swagger APIs `}{`/swagger/index.html`}{`.`}

\n

{`Before installing Kerberos Storage, open the `}{`./storage/yaml/deployment.yaml`}{` configuration file. At the bottom file you will find two endpoints, similar to the Traefik config file below. Update the domain names to your own domain, and add these to your DNS server or `}{`/etc/hosts`}{` file (and point to the same IP as the Traefik EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: storage.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: kerberos-storage`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.storage.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: kerberos-storage`}{`\n`}{`              servicePort: 8081`}
\n

{`Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names and MongoDB credentials, install Kerberos Storage inside your cluster.`}

\n 
{`kubectl apply -f ./storage/yaml/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Storage`}
    • \n
  • {`Enterprise (optional)`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`kerberos-storage-6f5c877d7c-hf77p 1/1     Running   0          2d11h`}{`\n`}{`mongodb-55566dc65c-xgmns          2/2     Running   0          4d13h`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS or `}{`/etc/hosts`}{` file, you should be able to access the Storage application. By navigating to the Storage domain `}{`storage.domain.com`}{` in your browser you will see the Storage login page showing up.`}

\n

\"Storage\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750186000,"key":"gatsby-plugin-mdx-entire-payload-15219f36e3fb0a19a215f22d171e7f22-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":15,"offset":173},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":15,"offset":173},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If not already the case, start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (","position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":113,"offset":287},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"AWS","position":{"start":{"line":10,"column":115,"offset":289},"end":{"line":10,"column":118,"offset":292},"indent":[]}}],"position":{"start":{"line":10,"column":113,"offset":287},"end":{"line":10,"column":120,"offset":294},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":10,"column":120,"offset":294},"end":{"line":10,"column":122,"offset":296},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"GCP","position":{"start":{"line":10,"column":124,"offset":298},"end":{"line":10,"column":127,"offset":301},"indent":[]}}],"position":{"start":{"line":10,"column":122,"offset":296},"end":{"line":10,"column":129,"offset":303},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":10,"column":129,"offset":303},"end":{"line":10,"column":133,"offset":307},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Azure","position":{"start":{"line":10,"column":135,"offset":309},"end":{"line":10,"column":140,"offset":314},"indent":[]}}],"position":{"start":{"line":10,"column":133,"offset":307},"end":{"line":10,"column":142,"offset":316},"indent":[]}},{"type":"text","value":"), cloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.","position":{"start":{"line":10,"column":142,"offset":316},"end":{"line":10,"column":234,"offset":408},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":234,"offset":408},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":12,"column":1,"offset":410},"end":{"line":14,"column":11,"offset":612},"indent":[1,1]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":16,"column":3,"offset":616},"end":{"line":16,"column":16,"offset":629},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":614},"end":{"line":16,"column":16,"offset":629},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is the storage component for Kerberos Enterprise. It is used to store your recordings at a central place, in the storage system you prefer. Next to that it can be used for extension and integration capabilities. Learn more about ","position":{"start":{"line":18,"column":1,"offset":631},"end":{"line":18,"column":247,"offset":877},"indent":[]}},{"type":"link","title":null,"url":"/storage","children":[{"type":"text","value":"Kerberos Storage here","position":{"start":{"line":18,"column":248,"offset":878},"end":{"line":18,"column":269,"offset":899},"indent":[]}}],"position":{"start":{"line":18,"column":247,"offset":877},"end":{"line":18,"column":280,"offset":910},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":18,"column":280,"offset":910},"end":{"line":18,"column":281,"offset":911},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":631},"end":{"line":18,"column":281,"offset":911},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To use Kerberos Storage, you will need to have Kerberos Enterprise installed, and deployments running. Independent from that one can also use the Kerberos Storage API ","position":{"start":{"line":20,"column":1,"offset":913},"end":{"line":20,"column":168,"offset":1080},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":20,"column":168,"offset":1080},"end":{"line":20,"column":189,"offset":1101},"indent":[]}},{"type":"text","value":" to send recordings from a custom build VMS.","position":{"start":{"line":20,"column":189,"offset":1101},"end":{"line":20,"column":233,"offset":1145},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":913},"end":{"line":20,"column":233,"offset":1145},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":22,"column":3,"offset":1149},"end":{"line":22,"column":15,"offset":1161},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1147},"end":{"line":22,"column":15,"offset":1161},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to Kerberos Enterprise, Kerberos Storage, requires some initial components to be installed. If you will run Kerberos Storage in the same cluster as where you have Kerberos Enterprise running, there is not much to do.","position":{"start":{"line":24,"column":1,"offset":1163},"end":{"line":24,"column":225,"offset":1387},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1163},"end":{"line":24,"column":225,"offset":1387},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":26,"column":1,"offset":1389},"end":{"line":26,"column":99,"offset":1487},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1389},"end":{"line":26,"column":99,"offset":1487},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"However if you plan to run Kerberos Storage in a different cluster (which is perfectly possible), you will need to make sure you complete the initial setup of ","position":{"start":{"line":28,"column":1,"offset":1489},"end":{"line":28,"column":160,"offset":1648},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/installation","children":[{"type":"text","value":"Kerberos Enterprise installation","position":{"start":{"line":28,"column":161,"offset":1649},"end":{"line":28,"column":193,"offset":1681},"indent":[]}}],"position":{"start":{"line":28,"column":160,"offset":1648},"end":{"line":28,"column":220,"offset":1708},"indent":[]}},{"type":"text","value":". To be more specific you will need the following components running:","position":{"start":{"line":28,"column":220,"offset":1708},"end":{"line":28,"column":289,"offset":1777},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1489},"end":{"line":28,"column":289,"offset":1777},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Helm","position":{"start":{"line":30,"column":3,"offset":1781},"end":{"line":30,"column":7,"offset":1785},"indent":[]}}],"position":{"start":{"line":30,"column":3,"offset":1781},"end":{"line":30,"column":7,"offset":1785},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1779},"end":{"line":30,"column":7,"offset":1785},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":31,"column":3,"offset":1788},"end":{"line":31,"column":10,"offset":1795},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1788},"end":{"line":31,"column":10,"offset":1795},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1786},"end":{"line":31,"column":10,"offset":1795},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":32,"column":3,"offset":1798},"end":{"line":32,"column":10,"offset":1805},"indent":[]}}],"position":{"start":{"line":32,"column":3,"offset":1798},"end":{"line":32,"column":10,"offset":1805},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1796},"end":{"line":32,"column":10,"offset":1805},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1779},"end":{"line":32,"column":10,"offset":1805},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once this is done start by cloning the configurations from our ","position":{"start":{"line":34,"column":1,"offset":1807},"end":{"line":34,"column":64,"offset":1870},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/storage","children":[{"type":"text","value":"Github repo","position":{"start":{"line":34,"column":65,"offset":1871},"end":{"line":34,"column":76,"offset":1882},"indent":[]}}],"position":{"start":{"line":34,"column":64,"offset":1870},"end":{"line":34,"column":117,"offset":1923},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":34,"column":117,"offset":1923},"end":{"line":34,"column":118,"offset":1924},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":1807},"end":{"line":34,"column":118,"offset":1924},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/storage","position":{"start":{"line":36,"column":1,"offset":1926},"end":{"line":36,"column":53,"offset":1978},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage","position":{"start":{"line":38,"column":4,"offset":1983},"end":{"line":38,"column":11,"offset":1990},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1980},"end":{"line":38,"column":11,"offset":1990},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Similar to Kerberos Enterprise, Kerberos Storage is managed through a web app. It allows you to add storage providers (S3, minio, etc), add queues for messaging, accounts for security and much more. It also comes with API's, which you can use to interact and retrieve information from Kerberos Storage. All is documented in the form of Swagger APIs ","position":{"start":{"line":40,"column":1,"offset":1992},"end":{"line":40,"column":350,"offset":2341},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":40,"column":350,"offset":2341},"end":{"line":40,"column":371,"offset":2362},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":40,"column":371,"offset":2362},"end":{"line":40,"column":372,"offset":2363},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1992},"end":{"line":40,"column":372,"offset":2363},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing Kerberos Storage, open the ","position":{"start":{"line":42,"column":1,"offset":2365},"end":{"line":42,"column":46,"offset":2410},"indent":[]}},{"type":"inlineCode","value":"./storage/yaml/deployment.yaml","position":{"start":{"line":42,"column":46,"offset":2410},"end":{"line":42,"column":78,"offset":2442},"indent":[]}},{"type":"text","value":" configuration file. At the bottom file you will find two endpoints, similar to the Traefik config file below. Update the domain names to your own domain, and add these to your DNS server or ","position":{"start":{"line":42,"column":78,"offset":2442},"end":{"line":42,"column":269,"offset":2633},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":42,"column":269,"offset":2633},"end":{"line":42,"column":281,"offset":2645},"indent":[]}},{"type":"text","value":" file (and point to the same IP as the Traefik EXTERNAL-IP).","position":{"start":{"line":42,"column":281,"offset":2645},"end":{"line":42,"column":341,"offset":2705},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2365},"end":{"line":42,"column":341,"offset":2705},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: storage.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: kerberos-storage\n servicePort: 80\n--> - host: api.storage.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: kerberos-storage\n servicePort: 8081","position":{"start":{"line":44,"column":1,"offset":2707},"end":{"line":59,"column":36,"offset":3157},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":61,"column":1,"offset":3159},"end":{"line":61,"column":112,"offset":3270},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3159},"end":{"line":61,"column":112,"offset":3270},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":63,"column":1,"offset":3272},"end":{"line":66,"column":30,"offset":3391},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names and MongoDB credentials, install Kerberos Storage inside your cluster.","position":{"start":{"line":68,"column":1,"offset":3393},"end":{"line":68,"column":109,"offset":3501},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":3393},"end":{"line":68,"column":109,"offset":3501},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./storage/yaml/deployment.yaml","position":{"start":{"line":70,"column":1,"offset":3503},"end":{"line":70,"column":52,"offset":3554},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":72,"column":4,"offset":3559},"end":{"line":72,"column":26,"offset":3581},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3556},"end":{"line":72,"column":26,"offset":3581},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":74,"column":1,"offset":3583},"end":{"line":74,"column":94,"offset":3676},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":3583},"end":{"line":74,"column":94,"offset":3676},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":76,"column":5,"offset":3682},"end":{"line":76,"column":12,"offset":3689},"indent":[]}}],"position":{"start":{"line":76,"column":5,"offset":3682},"end":{"line":76,"column":12,"offset":3689},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":3678},"end":{"line":76,"column":12,"offset":3689},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":77,"column":5,"offset":3694},"end":{"line":77,"column":12,"offset":3701},"indent":[]}}],"position":{"start":{"line":77,"column":5,"offset":3694},"end":{"line":77,"column":12,"offset":3701},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3690},"end":{"line":77,"column":12,"offset":3701},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Storage","position":{"start":{"line":78,"column":5,"offset":3706},"end":{"line":78,"column":12,"offset":3713},"indent":[]}}],"position":{"start":{"line":78,"column":5,"offset":3706},"end":{"line":78,"column":12,"offset":3713},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":3702},"end":{"line":78,"column":12,"offset":3713},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Enterprise (optional)","position":{"start":{"line":79,"column":5,"offset":3718},"end":{"line":79,"column":26,"offset":3739},"indent":[]}}],"position":{"start":{"line":79,"column":5,"offset":3718},"end":{"line":79,"column":26,"offset":3739},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3714},"end":{"line":79,"column":26,"offset":3739},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":3678},"end":{"line":79,"column":26,"offset":3739},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":81,"column":1,"offset":3741},"end":{"line":81,"column":26,"offset":3766},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3741},"end":{"line":81,"column":26,"offset":3766},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nkerberos-storage-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-55566dc65c-xgmns 2/2 Running 0 4d13h\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":83,"column":1,"offset":3768},"end":{"line":87,"column":73,"offset":4080},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":89,"column":4,"offset":4085},"end":{"line":89,"column":21,"offset":4102},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4082},"end":{"line":89,"column":21,"offset":4102},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS or ","position":{"start":{"line":91,"column":1,"offset":4104},"end":{"line":91,"column":65,"offset":4168},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":91,"column":65,"offset":4168},"end":{"line":91,"column":77,"offset":4180},"indent":[]}},{"type":"text","value":" file, you should be able to access the Storage application. By navigating to the Storage domain ","position":{"start":{"line":91,"column":77,"offset":4180},"end":{"line":91,"column":174,"offset":4277},"indent":[]}},{"type":"inlineCode","value":"storage.domain.com","position":{"start":{"line":91,"column":174,"offset":4277},"end":{"line":91,"column":194,"offset":4297},"indent":[]}},{"type":"text","value":" in your browser you will see the Storage login page showing up.","position":{"start":{"line":91,"column":194,"offset":4297},"end":{"line":91,"column":258,"offset":4361},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4104},"end":{"line":91,"column":258,"offset":4361},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Storage","position":{"start":{"line":93,"column":1,"offset":4363},"end":{"line":93,"column":71,"offset":4433},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4363},"end":{"line":93,"column":71,"offset":4433},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":96,"column":1,"offset":4436},"end":{"line":96,"column":31,"offset":4466},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":96,"column":31,"offset":4466}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Introduction`}

\n

{`If not already the case, start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (`}{`AWS`}{`, `}{`GCP`}{` or `}{`Azure`}{`), cloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.`}

\n
\n
\n

\n

{`Prerequisites`}

\n

{`Kerberos Storage is the storage component for Kerberos Enterprise. It is used to store your recordings at a central place, in the storage system you prefer. Next to that it can be used for extension and integration capabilities. Learn more about `}{`Kerberos Storage here`}{`.`}

\n

{`To use Kerberos Storage, you will need to have Kerberos Enterprise installed, and deployments running. Independent from that one can also use the Kerberos Storage API `}{`/swagger/index.html`}{` to send recordings from a custom build VMS.`}

\n

{`Installation`}

\n

{`Similar to Kerberos Enterprise, Kerberos Storage, requires some initial components to be installed. If you will run Kerberos Storage in the same cluster as where you have Kerberos Enterprise running, there is not much to do.`}

\n

\"architecture

\n

{`However if you plan to run Kerberos Storage in a different cluster (which is perfectly possible), you will need to make sure you complete the initial setup of `}{`Kerberos Enterprise installation`}{`. To be more specific you will need the following components running:`}

\n
    \n
  • {`Helm`}
    • \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
\n

{`Once this is done start by cloning the configurations from our `}{`Github repo`}{`.`}

\n 
{`git clone https://github.com/kerberos-io/storage`}
\n

{`Storage`}

\n

{`Similar to Kerberos Enterprise, Kerberos Storage is managed through a web app. It allows you to add storage providers (S3, minio, etc), add queues for messaging, accounts for security and much more. It also comes with API's, which you can use to interact and retrieve information from Kerberos Storage. All is documented in the form of Swagger APIs `}{`/swagger/index.html`}{`.`}

\n

{`Before installing Kerberos Storage, open the `}{`./storage/yaml/deployment.yaml`}{` configuration file. At the bottom file you will find two endpoints, similar to the Traefik config file below. Update the domain names to your own domain, and add these to your DNS server or `}{`/etc/hosts`}{` file (and point to the same IP as the Traefik EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: storage.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: kerberos-storage`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.storage.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: kerberos-storage`}{`\n`}{`              servicePort: 8081`}
\n

{`Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names and MongoDB credentials, install Kerberos Storage inside your cluster.`}

\n 
{`kubectl apply -f ./storage/yaml/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Storage`}
    • \n
  • {`Enterprise (optional)`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`kerberos-storage-6f5c877d7c-hf77p 1/1     Running   0          2d11h`}{`\n`}{`mongodb-55566dc65c-xgmns          2/2     Running   0          4d13h`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS or `}{`/etc/hosts`}{` file, you should be able to access the Storage application. By navigating to the Storage domain `}{`storage.domain.com`}{` in your browser you will see the Storage login page showing up.`}

\n

\"Storage\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-8af19e9b33ced8997311160acc968d0e.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-8af19e9b33ced8997311160acc968d0e.json new file mode 100644 index 0000000..b891505 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-8af19e9b33ced8997311160acc968d0e.json @@ -0,0 +1 @@ +{"expireTime":9007200861829562000,"key":"gatsby-plugin-mdx-entire-payload-6dea68e9e2d8281e385ddfa8b2d2b3b6-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. These storage provider could be in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be localated on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":610,"offset":1263},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":610,"offset":1263},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":20,"column":4,"offset":1268},"end":{"line":20,"column":18,"offset":1282},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1265},"end":{"line":20,"column":18,"offset":1282},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":22,"column":1,"offset":1284},"end":{"line":22,"column":291,"offset":1574},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":22,"column":292,"offset":1575},"end":{"line":22,"column":309,"offset":1592},"indent":[]}}],"position":{"start":{"line":22,"column":291,"offset":1574},"end":{"line":22,"column":318,"offset":1601},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":22,"column":318,"offset":1601},"end":{"line":22,"column":319,"offset":1602},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1284},"end":{"line":22,"column":319,"offset":1602},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":24,"column":1,"offset":1604},"end":{"line":24,"column":56,"offset":1659},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1604},"end":{"line":24,"column":56,"offset":1659},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":26,"column":4,"offset":1664},"end":{"line":26,"column":20,"offset":1680},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1661},"end":{"line":26,"column":20,"offset":1680},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":28,"column":1,"offset":1682},"end":{"line":28,"column":253,"offset":1934},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1682},"end":{"line":28,"column":253,"offset":1934},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":30,"column":6,"offset":1941},"end":{"line":30,"column":35,"offset":1970},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1940},"end":{"line":30,"column":70,"offset":2005},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1940},"end":{"line":30,"column":70,"offset":2005},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1936},"end":{"line":30,"column":70,"offset":2005},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":31,"column":6,"offset":2011},"end":{"line":31,"column":29,"offset":2034},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2010},"end":{"line":31,"column":83,"offset":2088},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2010},"end":{"line":31,"column":83,"offset":2088},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":2006},"end":{"line":31,"column":83,"offset":2088},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":32,"column":6,"offset":2094},"end":{"line":32,"column":28,"offset":2116},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2093},"end":{"line":32,"column":57,"offset":2145},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2093},"end":{"line":32,"column":57,"offset":2145},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2089},"end":{"line":32,"column":57,"offset":2145},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":33,"column":6,"offset":2151},"end":{"line":33,"column":11,"offset":2156},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2150},"end":{"line":33,"column":29,"offset":2174},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2150},"end":{"line":33,"column":29,"offset":2174},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2146},"end":{"line":33,"column":29,"offset":2174},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1936},"end":{"line":33,"column":29,"offset":2174},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":35,"column":1,"offset":2176},"end":{"line":35,"column":190,"offset":2365},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2176},"end":{"line":35,"column":190,"offset":2365},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":37,"column":1,"offset":2367},"end":{"line":37,"column":99,"offset":2465},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2367},"end":{"line":37,"column":99,"offset":2465},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":39,"column":1,"offset":2467},"end":{"line":39,"column":220,"offset":2686},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2467},"end":{"line":39,"column":220,"offset":2686},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":41,"column":1,"offset":2688},"end":{"line":41,"column":98,"offset":2785},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2688},"end":{"line":41,"column":98,"offset":2785},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":43,"column":5,"offset":2791},"end":{"line":43,"column":11,"offset":2797},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2787},"end":{"line":43,"column":11,"offset":2797},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":45,"column":1,"offset":2799},"end":{"line":45,"column":303,"offset":3101},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2799},"end":{"line":45,"column":303,"offset":3101},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":47,"column":6,"offset":3108},"end":{"line":47,"column":18,"offset":3120},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3107},"end":{"line":47,"column":46,"offset":3148},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3107},"end":{"line":47,"column":46,"offset":3148},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3103},"end":{"line":47,"column":46,"offset":3148},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":48,"column":6,"offset":3154},"end":{"line":48,"column":29,"offset":3177},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3153},"end":{"line":48,"column":59,"offset":3207},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3153},"end":{"line":48,"column":59,"offset":3207},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":3149},"end":{"line":48,"column":59,"offset":3207},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3103},"end":{"line":48,"column":59,"offset":3207},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":50,"column":1,"offset":3209},"end":{"line":50,"column":368,"offset":3576},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3209},"end":{"line":50,"column":368,"offset":3576},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":52,"column":1,"offset":3578},"end":{"line":52,"column":66,"offset":3643},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3578},"end":{"line":52,"column":66,"offset":3643},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":54,"column":5,"offset":3649},"end":{"line":54,"column":21,"offset":3665},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3645},"end":{"line":54,"column":21,"offset":3665},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":56,"column":1,"offset":3667},"end":{"line":56,"column":237,"offset":3903},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3667},"end":{"line":56,"column":237,"offset":3903},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":58,"column":1,"offset":3905},"end":{"line":58,"column":105,"offset":4009},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3905},"end":{"line":58,"column":105,"offset":4009},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":60,"column":1,"offset":4011},"end":{"line":60,"column":45,"offset":4055},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4011},"end":{"line":60,"column":45,"offset":4055},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":62,"column":3,"offset":4059},"end":{"line":62,"column":380,"offset":4436},"indent":[]}}],"position":{"start":{"line":62,"column":3,"offset":4059},"end":{"line":62,"column":380,"offset":4436},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4057},"end":{"line":63,"column":1,"offset":4437},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":64,"column":3,"offset":4440},"end":{"line":65,"column":49,"offset":4754},"indent":[2]}}],"position":{"start":{"line":64,"column":3,"offset":4440},"end":{"line":65,"column":49,"offset":4754},"indent":[2]}}],"position":{"start":{"line":64,"column":1,"offset":4438},"end":{"line":65,"column":49,"offset":4754},"indent":[1]}}],"position":{"start":{"line":62,"column":1,"offset":4057},"end":{"line":65,"column":49,"offset":4754},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":67,"column":5,"offset":4760},"end":{"line":67,"column":13,"offset":4768},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":4756},"end":{"line":67,"column":13,"offset":4768},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":69,"column":1,"offset":4770},"end":{"line":69,"column":156,"offset":4925},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":69,"column":156,"offset":4925},"end":{"line":69,"column":177,"offset":4946},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":69,"column":177,"offset":4946},"end":{"line":69,"column":188,"offset":4957},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":69,"column":188,"offset":4957},"end":{"line":69,"column":193,"offset":4962},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":69,"column":193,"offset":4962},"end":{"line":69,"column":379,"offset":5148},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4770},"end":{"line":69,"column":379,"offset":5148},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":71,"column":1,"offset":5150},"end":{"line":71,"column":68,"offset":5217},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":5150},"end":{"line":71,"column":68,"offset":5217},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":73,"column":4,"offset":5222},"end":{"line":73,"column":13,"offset":5231},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5219},"end":{"line":73,"column":13,"offset":5231},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":75,"column":1,"offset":5233},"end":{"line":75,"column":44,"offset":5276},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":75,"column":46,"offset":5278},"end":{"line":75,"column":68,"offset":5300},"indent":[]}}],"position":{"start":{"line":75,"column":44,"offset":5276},"end":{"line":75,"column":70,"offset":5302},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":75,"column":70,"offset":5302},"end":{"line":75,"column":106,"offset":5338},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":75,"column":108,"offset":5340},"end":{"line":75,"column":129,"offset":5361},"indent":[]}}],"position":{"start":{"line":75,"column":106,"offset":5338},"end":{"line":75,"column":131,"offset":5363},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":75,"column":131,"offset":5363},"end":{"line":75,"column":159,"offset":5391},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5233},"end":{"line":75,"column":159,"offset":5391},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":78,"column":1,"offset":5394},"end":{"line":78,"column":31,"offset":5424},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":78,"column":31,"offset":5424}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. These storage provider could be in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be localated on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-8bce9318ffa5323149e488ee8a136c87.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-8bce9318ffa5323149e488ee8a136c87.json index e9e22ea..8583d40 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-8bce9318ffa5323149e488ee8a136c87.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-8bce9318ffa5323149e488ee8a136c87.json @@ -1 +1 @@ -{"expireTime":9007200861747692000,"key":"gatsby-plugin-mdx-entire-payload-4d75bdd89156882cf03d09e1b2abe7e1-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source comes with different installation flavours. So you might think, why? The reason is simple, depending on the use case one option is better than another. A short list of recommendations:","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":207,"offset":441},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":207,"offset":441},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Plug and play","position":{"start":{"line":14,"column":5,"offset":447},"end":{"line":14,"column":18,"offset":460},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":443},"end":{"line":14,"column":18,"offset":460},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation#kios","children":[{"type":"text","value":"KiOS","position":{"start":{"line":15,"column":5,"offset":465},"end":{"line":15,"column":9,"offset":469},"indent":[]}}],"position":{"start":{"line":15,"column":4,"offset":464},"end":{"line":15,"column":41,"offset":501},"indent":[]}},{"type":"text","value":": You have a Raspberry Pi, and you only want to run a Kerberos agent on it.","position":{"start":{"line":15,"column":41,"offset":501},"end":{"line":15,"column":116,"offset":576},"indent":[]}}],"position":{"start":{"line":15,"column":4,"offset":464},"end":{"line":15,"column":116,"offset":576},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":461},"end":{"line":15,"column":116,"offset":576},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation#docker","children":[{"type":"text","value":"Docker","position":{"start":{"line":16,"column":5,"offset":581},"end":{"line":16,"column":11,"offset":587},"indent":[]}}],"position":{"start":{"line":16,"column":4,"offset":580},"end":{"line":16,"column":45,"offset":621},"indent":[]}},{"type":"text","value":": You have a lot of IP cameras, and/or don't want to mess with dependencies.","position":{"start":{"line":16,"column":45,"offset":621},"end":{"line":16,"column":121,"offset":697},"indent":[]}}],"position":{"start":{"line":16,"column":4,"offset":580},"end":{"line":16,"column":121,"offset":697},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":577},"end":{"line":16,"column":121,"offset":697},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation#balena","children":[{"type":"text","value":"Balena","position":{"start":{"line":17,"column":5,"offset":702},"end":{"line":17,"column":11,"offset":708},"indent":[]}}],"position":{"start":{"line":17,"column":4,"offset":701},"end":{"line":17,"column":45,"offset":742},"indent":[]}},{"type":"text","value":": Runnning the Kerberos Docker container on top of Balena.","position":{"start":{"line":17,"column":45,"offset":742},"end":{"line":17,"column":103,"offset":800},"indent":[]}}],"position":{"start":{"line":17,"column":4,"offset":701},"end":{"line":17,"column":103,"offset":800},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":698},"end":{"line":17,"column":103,"offset":800},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":461},"end":{"line":17,"column":103,"offset":800},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Advanced","position":{"start":{"line":19,"column":5,"offset":806},"end":{"line":19,"column":13,"offset":814},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":802},"end":{"line":19,"column":13,"offset":814},"indent":[]}},{"type":"list","ordered":true,"start":4,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation-advanced#raspbian","children":[{"type":"text","value":"Raspbian","position":{"start":{"line":20,"column":5,"offset":819},"end":{"line":20,"column":13,"offset":827},"indent":[]}}],"position":{"start":{"line":20,"column":4,"offset":818},"end":{"line":20,"column":58,"offset":872},"indent":[]}},{"type":"text","value":": You have a Raspberry Pi, but you want other services running next to the Kerberos agent.","position":{"start":{"line":20,"column":58,"offset":872},"end":{"line":20,"column":148,"offset":962},"indent":[]}}],"position":{"start":{"line":20,"column":4,"offset":818},"end":{"line":20,"column":148,"offset":962},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":815},"end":{"line":20,"column":148,"offset":962},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation-advanced#generic","children":[{"type":"text","value":"Generic","position":{"start":{"line":21,"column":5,"offset":967},"end":{"line":21,"column":12,"offset":974},"indent":[]}}],"position":{"start":{"line":21,"column":4,"offset":966},"end":{"line":21,"column":56,"offset":1018},"indent":[]}},{"type":"text","value":": You want to develop/extend Kerberos with your own features, or you want to run a Kerberos agent on a not supported OS/architecure.","position":{"start":{"line":21,"column":56,"offset":1018},"end":{"line":21,"column":188,"offset":1150},"indent":[]}}],"position":{"start":{"line":21,"column":4,"offset":966},"end":{"line":21,"column":188,"offset":1150},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":963},"end":{"line":21,"column":188,"offset":1150},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":815},"end":{"line":21,"column":188,"offset":1150},"indent":[1]}},{"type":"thematicBreak","position":{"start":{"line":23,"column":1,"offset":1152},"end":{"line":23,"column":4,"offset":1155},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Advanced","position":{"start":{"line":25,"column":3,"offset":1159},"end":{"line":25,"column":11,"offset":1167},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1157},"end":{"line":25,"column":11,"offset":1167},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Following installation methods are only for advanced users, who need to have more control over the Kerberos Open Source environment.","position":{"start":{"line":27,"column":1,"offset":1169},"end":{"line":27,"column":133,"offset":1301},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1169},"end":{"line":27,"column":133,"offset":1301},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Raspbian","position":{"start":{"line":29,"column":4,"offset":1306},"end":{"line":29,"column":12,"offset":1314},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1303},"end":{"line":29,"column":12,"offset":1314},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you have already an OS (e.g. Raspbian Buster) flashed to your Raspberry Pi, then it makes sense to install the Kerberos agent on top of your existing OS. There are two ways to achieve this:","position":{"start":{"line":31,"column":1,"offset":1316},"end":{"line":31,"column":193,"offset":1508},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1316},"end":{"line":31,"column":193,"offset":1508},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Install the Kerberos agent using Docker (more info below),","position":{"start":{"line":33,"column":4,"offset":1513},"end":{"line":33,"column":62,"offset":1571},"indent":[]}}],"position":{"start":{"line":33,"column":4,"offset":1513},"end":{"line":33,"column":62,"offset":1571},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1510},"end":{"line":33,"column":62,"offset":1571},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"or you can install the Kerberos agent manually (machinery + web).","position":{"start":{"line":34,"column":4,"offset":1575},"end":{"line":34,"column":69,"offset":1640},"indent":[]}}],"position":{"start":{"line":34,"column":4,"offset":1575},"end":{"line":34,"column":69,"offset":1640},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":1572},"end":{"line":34,"column":69,"offset":1640},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1510},"end":{"line":34,"column":69,"offset":1640},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"This section will focus on option 2, and will show you how to install the Kerberos agent manually.","position":{"start":{"line":36,"column":1,"offset":1642},"end":{"line":36,"column":99,"offset":1740},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":1642},"end":{"line":36,"column":99,"offset":1740},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Update OS","position":{"start":{"line":38,"column":5,"offset":1746},"end":{"line":38,"column":14,"offset":1755},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1742},"end":{"line":38,"column":14,"offset":1755},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Let's start with updating the OS, and installing a couple of packages.","position":{"start":{"line":40,"column":1,"offset":1757},"end":{"line":40,"column":71,"offset":1827},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1757},"end":{"line":40,"column":71,"offset":1827},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"We have tested the Raspbian installation on ","position":{"start":{"line":42,"column":3,"offset":1831},"end":{"line":42,"column":47,"offset":1875},"indent":[]}},{"type":"inlineCode","value":"Raspbian GNU/Linux 10 (buster)","position":{"start":{"line":42,"column":47,"offset":1875},"end":{"line":42,"column":79,"offset":1907},"indent":[]}},{"type":"text","value":". It might be that if you have a different version of Raspbian, you will need to install additional/different packages.","position":{"start":{"line":42,"column":79,"offset":1907},"end":{"line":42,"column":198,"offset":2026},"indent":[]}}],"position":{"start":{"line":42,"column":3,"offset":1831},"end":{"line":42,"column":198,"offset":2026},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":1829},"end":{"line":42,"column":198,"offset":2026},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo apt-get update && sudo apt-get install -y ffmpeg","position":{"start":{"line":44,"column":1,"offset":2028},"end":{"line":46,"column":4,"offset":2091},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":48,"column":5,"offset":2097},"end":{"line":48,"column":14,"offset":2106},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":2093},"end":{"line":48,"column":14,"offset":2106},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Download the debian file from the machinery repository.","position":{"start":{"line":50,"column":1,"offset":2108},"end":{"line":50,"column":56,"offset":2163},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2108},"end":{"line":50,"column":56,"offset":2163},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/releases","children":[{"type":"text","value":"https://github.com/kerberos-io/machinery/releases","position":{"start":{"line":51,"column":3,"offset":2166},"end":{"line":51,"column":52,"offset":2215},"indent":[]}}],"position":{"start":{"line":51,"column":3,"offset":2166},"end":{"line":51,"column":52,"offset":2215},"indent":[]}}],"position":{"start":{"line":51,"column":3,"offset":2166},"end":{"line":51,"column":52,"offset":2215},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2164},"end":{"line":51,"column":52,"offset":2215},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A ","position":{"start":{"line":53,"column":1,"offset":2217},"end":{"line":53,"column":3,"offset":2219},"indent":[]}},{"type":"inlineCode","value":".deb","position":{"start":{"line":53,"column":3,"offset":2219},"end":{"line":53,"column":9,"offset":2225},"indent":[]}},{"type":"text","value":" file is available for every version of the Raspberry Pi. For example if you are using a Raspberry Pi 4 for version 2.8.0, execute following command. You can change the version and Raspberry Pi board to your needs.","position":{"start":{"line":53,"column":9,"offset":2225},"end":{"line":53,"column":223,"offset":2439},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2217},"end":{"line":53,"column":223,"offset":2439},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"Please make sure you pick the right board (rpi, rpi2, rpi3 or rpi4), and choose the version you want (e.g. 2.8.0). Replace below url, with your preferences.","position":{"start":{"line":55,"column":3,"offset":2443},"end":{"line":55,"column":159,"offset":2599},"indent":[]}}],"position":{"start":{"line":55,"column":3,"offset":2443},"end":{"line":55,"column":159,"offset":2599},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2441},"end":{"line":55,"column":159,"offset":2599},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"wget https://github.com/kerberos-io/machinery/releases/download/v2.8.0/rpi4-machinery-kerberosio-armhf-2.8.0.deb\nsudo dpkg -i rpi4-machinery-kerberosio-armhf-2.8.0.deb","position":{"start":{"line":57,"column":1,"offset":2601},"end":{"line":60,"column":4,"offset":2778},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Download the x265 library (version 160) from the machinery repository, as Raspbian Buster 10 only ships with version 165. Make sure you select the right board.","position":{"start":{"line":62,"column":1,"offset":2780},"end":{"line":62,"column":160,"offset":2939},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":2780},"end":{"line":62,"column":160,"offset":2939},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"inlineCode","value":"v2.8.0/rpi4-libx265.so.160","position":{"start":{"line":64,"column":3,"offset":2943},"end":{"line":64,"column":31,"offset":2971},"indent":[]}},{"type":"text","value":" this will download the libx265 shared library for the Raspberry Pi 4.","position":{"start":{"line":64,"column":31,"offset":2971},"end":{"line":64,"column":101,"offset":3041},"indent":[]}}],"position":{"start":{"line":64,"column":3,"offset":2943},"end":{"line":64,"column":101,"offset":3041},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":2941},"end":{"line":64,"column":101,"offset":3041},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"wget https://github.com/kerberos-io/machinery/releases/download/v2.8.0/rpi4-libx265.so.160\nsudo mv rpi4-libx265.so.160 /usr/lib/arm-linux-gnueabihf/libx265.so.160","position":{"start":{"line":66,"column":1,"offset":3043},"end":{"line":69,"column":4,"offset":3215},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Same applies for the libx264 library, download the right shared library.","position":{"start":{"line":71,"column":1,"offset":3217},"end":{"line":71,"column":73,"offset":3289},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3217},"end":{"line":71,"column":73,"offset":3289},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"inlineCode","value":"v2.8.0/rpi4-libx264.so.148","position":{"start":{"line":73,"column":3,"offset":3293},"end":{"line":73,"column":31,"offset":3321},"indent":[]}},{"type":"text","value":" this will download the libx264 shared library for the Raspberry Pi 4.","position":{"start":{"line":73,"column":31,"offset":3321},"end":{"line":73,"column":101,"offset":3391},"indent":[]}}],"position":{"start":{"line":73,"column":3,"offset":3293},"end":{"line":73,"column":101,"offset":3391},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":3291},"end":{"line":73,"column":101,"offset":3391},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"wget https://github.com/kerberos-io/machinery/releases/download/v2.8.0/rpi4-libx264.so.148\nsudo mv rpi4-libx264.so.148 /usr/lib/arm-linux-gnueabihf/libx264.so.148","position":{"start":{"line":75,"column":1,"offset":3393},"end":{"line":78,"column":4,"offset":3565},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"If you wish to use the Raspberry Pi Camera Module, make sure ","position":{"start":{"line":80,"column":1,"offset":3567},"end":{"line":80,"column":62,"offset":3628},"indent":[]}},{"type":"link","title":null,"url":"https://www.raspberrypi.org/documentation/configuration/camera.md","children":[{"type":"text","value":"to enable it","position":{"start":{"line":80,"column":63,"offset":3629},"end":{"line":80,"column":75,"offset":3641},"indent":[]}}],"position":{"start":{"line":80,"column":62,"offset":3628},"end":{"line":80,"column":143,"offset":3709},"indent":[]}},{"type":"text","value":" using ","position":{"start":{"line":80,"column":143,"offset":3709},"end":{"line":80,"column":150,"offset":3716},"indent":[]}},{"type":"inlineCode","value":"sudo raspi-config","position":{"start":{"line":80,"column":150,"offset":3716},"end":{"line":80,"column":169,"offset":3735},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":80,"column":169,"offset":3735},"end":{"line":80,"column":170,"offset":3736},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":3567},"end":{"line":80,"column":170,"offset":3736},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo raspi-config","position":{"start":{"line":82,"column":1,"offset":3738},"end":{"line":84,"column":4,"offset":3765},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Enable machinery to start on boot, and start the service.","position":{"start":{"line":86,"column":1,"offset":3767},"end":{"line":86,"column":58,"offset":3824},"indent":[]}}],"position":{"start":{"line":86,"column":1,"offset":3767},"end":{"line":86,"column":58,"offset":3824},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"sudo systemctl enable kerberosio\nsudo service kerberosio start","position":{"start":{"line":88,"column":1,"offset":3826},"end":{"line":91,"column":4,"offset":3896},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Web","position":{"start":{"line":93,"column":5,"offset":3902},"end":{"line":93,"column":8,"offset":3905},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":3898},"end":{"line":93,"column":8,"offset":3905},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before you can run the web interface, you'll need to download and configure a webserver. We recommend to use Nginx, as it is a light-weight and fast webserver. The web interface is written in PHP, so we also need to download PHP and some packages. Update the packages and kernel.","position":{"start":{"line":95,"column":1,"offset":3907},"end":{"line":95,"column":280,"offset":4186},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":3907},"end":{"line":95,"column":280,"offset":4186},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Install Nginx and PHP (+extensions).","position":{"start":{"line":97,"column":1,"offset":4188},"end":{"line":97,"column":37,"offset":4224},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4188},"end":{"line":97,"column":37,"offset":4224},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo apt-get install -y nginx php7.1 php7.1-curl php7.1-gd php7.1-fpm php7.1-cli php7.1-opcache php7.1-mbstring php7.1-xml php7.1-zip php7.1-mcrypt php7.1-readline","position":{"start":{"line":99,"column":1,"offset":4226},"end":{"line":101,"column":4,"offset":4399},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Creating a Nginx config.","position":{"start":{"line":103,"column":1,"offset":4401},"end":{"line":103,"column":25,"offset":4425},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":4401},"end":{"line":103,"column":25,"offset":4425},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo rm -f /etc/nginx/sites-enabled/default\nsudo nano /etc/nginx/sites-enabled/kerberosio.conf","position":{"start":{"line":105,"column":1,"offset":4427},"end":{"line":108,"column":4,"offset":4531},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Copy and paste following config file; this file tells nginx where the web will be installed and that it requires PHP.","position":{"start":{"line":110,"column":1,"offset":4533},"end":{"line":110,"column":118,"offset":4650},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":4533},"end":{"line":110,"column":118,"offset":4650},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"server\n{\n listen 80 default_server;\n listen [::]:80 default_server;\n root /var/www/web/public;\n server_name kerberos.rpi;\n index index.php index.html index.htm;\n location /\n {\n autoindex on;\n try_files $uri $uri/ /index.php?$query_string;\n }\n location ~ \\.php$\n {\n fastcgi_pass unix:/var/run/php/php7.1-fpm.sock;\n fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;\n include fastcgi_params;\n }\n}","position":{"start":{"line":112,"column":1,"offset":4652},"end":{"line":132,"column":4,"offset":5159},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Restart nginx","position":{"start":{"line":134,"column":1,"offset":5161},"end":{"line":134,"column":14,"offset":5174},"indent":[]}}],"position":{"start":{"line":134,"column":1,"offset":5161},"end":{"line":134,"column":14,"offset":5174},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo service nginx restart","position":{"start":{"line":136,"column":1,"offset":5176},"end":{"line":138,"column":4,"offset":5212},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Now we have installed all the dependencies, we can download the web interface source code.","position":{"start":{"line":140,"column":1,"offset":5214},"end":{"line":140,"column":91,"offset":5304},"indent":[]}}],"position":{"start":{"line":140,"column":1,"offset":5214},"end":{"line":140,"column":91,"offset":5304},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo mkdir -p /var/www/web && sudo chown www-data:www-data /var/www/web\ncd /var/www/web\nsudo -u www-data wget https://github.com/kerberos-io/web/releases/download/v2.8.0/web.tar.gz\nsudo -u www-data tar xvf web.tar.gz .\nsudo chown www-data -R storage bootstrap/cache config/kerberos.php\nsudo chmod -R 775 storage bootstrap/cache\nsudo chmod 0600 config/kerberos.php","position":{"start":{"line":142,"column":1,"offset":5306},"end":{"line":150,"column":4,"offset":5679},"indent":[1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is setup correctly, you should be able to browse towards the ip-address of your Raspberry Pi and see the Kerberos web interface.","position":{"start":{"line":152,"column":1,"offset":5681},"end":{"line":152,"column":145,"offset":5825},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":5681},"end":{"line":152,"column":145,"offset":5825},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Auto removal","position":{"start":{"line":154,"column":5,"offset":5831},"end":{"line":154,"column":17,"offset":5843},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":5827},"end":{"line":154,"column":17,"offset":5843},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By default images or videos aren't removed automatically. This means that the Kerberos agent will keep writing to disk, even if there is no more space available on your SD card. When your SD card is full you'll be experiencing strange errors: a corrupt web interface, blank images or corrupt videos.","position":{"start":{"line":156,"column":1,"offset":5845},"end":{"line":156,"column":300,"offset":6144},"indent":[]}}],"position":{"start":{"line":156,"column":1,"offset":5845},"end":{"line":156,"column":300,"offset":6144},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To resolve this your should install a simple bash script and initiate a cronjob which continuously poll your filesystem, and start removing media when your disk is getting full.","position":{"start":{"line":158,"column":1,"offset":6146},"end":{"line":158,"column":178,"offset":6323},"indent":[]}}],"position":{"start":{"line":158,"column":1,"offset":6146},"end":{"line":158,"column":178,"offset":6323},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Create a bash script and copy following script.","position":{"start":{"line":160,"column":1,"offset":6325},"end":{"line":160,"column":48,"offset":6372},"indent":[]}}],"position":{"start":{"line":160,"column":1,"offset":6325},"end":{"line":160,"column":48,"offset":6372},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"nano /home/pi/autoremoval.sh","position":{"start":{"line":162,"column":1,"offset":6374},"end":{"line":164,"column":4,"offset":6414},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Copy following script (make sure the partition is correct, this is the default one for a Raspberry Pi).","position":{"start":{"line":166,"column":1,"offset":6416},"end":{"line":166,"column":104,"offset":6519},"indent":[]}}],"position":{"start":{"line":166,"column":1,"offset":6416},"end":{"line":166,"column":104,"offset":6519},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"partition=/dev/root\nimagedir=/etc/opt/kerberosio/capture/\nif [[ $(df -h | grep $partition | head -1 | awk -F' ' '{ print $5/1 }' | tr ['%'] [\"0\"]) -gt 90 ]];\nthen\n echo \"Cleaning disk\"\n find $imagedir -type f | sort | head -n 100 | xargs -r rm -rf;\nfi;","position":{"start":{"line":168,"column":1,"offset":6521},"end":{"line":176,"column":4,"offset":6791},"indent":[1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Make the script executable.","position":{"start":{"line":178,"column":1,"offset":6793},"end":{"line":178,"column":28,"offset":6820},"indent":[]}}],"position":{"start":{"line":178,"column":1,"offset":6793},"end":{"line":178,"column":28,"offset":6820},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"chmod +x /home/pi/autoremoval.sh","position":{"start":{"line":180,"column":1,"offset":6822},"end":{"line":182,"column":4,"offset":6866},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Initiate a cronjob, and select the nano editor.","position":{"start":{"line":184,"column":1,"offset":6868},"end":{"line":184,"column":48,"offset":6915},"indent":[]}}],"position":{"start":{"line":184,"column":1,"offset":6868},"end":{"line":184,"column":48,"offset":6915},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"crontab -e","position":{"start":{"line":186,"column":1,"offset":6917},"end":{"line":188,"column":4,"offset":6939},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Append following line, to execute the autoremoval.sh script every 5min.","position":{"start":{"line":190,"column":1,"offset":6941},"end":{"line":190,"column":72,"offset":7012},"indent":[]}}],"position":{"start":{"line":190,"column":1,"offset":6941},"end":{"line":190,"column":72,"offset":7012},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"*/5 * * * * /bin/bash /home/pi/autoremoval.sh","position":{"start":{"line":192,"column":1,"offset":7014},"end":{"line":194,"column":4,"offset":7071},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Generic","position":{"start":{"line":196,"column":4,"offset":7076},"end":{"line":196,"column":11,"offset":7083},"indent":[]}}],"position":{"start":{"line":196,"column":1,"offset":7073},"end":{"line":196,"column":11,"offset":7083},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to install the Kerberos agent from source on your working station or server, either for development or running the software, this is the preferred installation procedure. We are assuming that you use a Linux OS, when using Mac OSX the installation is slightly different.","position":{"start":{"line":198,"column":1,"offset":7085},"end":{"line":198,"column":283,"offset":7367},"indent":[]}}],"position":{"start":{"line":198,"column":1,"offset":7085},"end":{"line":198,"column":283,"offset":7367},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"This was tested on a Ubuntu VM (18.04.3 (LTS) x64).","position":{"start":{"line":200,"column":3,"offset":7371},"end":{"line":200,"column":54,"offset":7422},"indent":[]}}],"position":{"start":{"line":200,"column":3,"offset":7371},"end":{"line":200,"column":54,"offset":7422},"indent":[]}}],"position":{"start":{"line":200,"column":1,"offset":7369},"end":{"line":200,"column":54,"offset":7422},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":202,"column":5,"offset":7428},"end":{"line":202,"column":14,"offset":7437},"indent":[]}}],"position":{"start":{"line":202,"column":1,"offset":7424},"end":{"line":202,"column":14,"offset":7437},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Update the packages and kernel, and install some development tools.","position":{"start":{"line":204,"column":1,"offset":7439},"end":{"line":204,"column":68,"offset":7506},"indent":[]}}],"position":{"start":{"line":204,"column":1,"offset":7439},"end":{"line":204,"column":68,"offset":7506},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo apt-get -y update\nsudo apt-get install -y git cmake subversion dh-autoreconf libcurl4-openssl-dev yasm libx264-dev pkg-config libssl-dev","position":{"start":{"line":206,"column":1,"offset":7508},"end":{"line":209,"column":4,"offset":7659},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Install the FFmpeg library with x264 support.","position":{"start":{"line":211,"column":1,"offset":7661},"end":{"line":211,"column":46,"offset":7706},"indent":[]}}],"position":{"start":{"line":211,"column":1,"offset":7661},"end":{"line":211,"column":46,"offset":7706},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"It's recommended to install FFmpeg 3.1. Later versions might give issues at compilation or run time.","position":{"start":{"line":213,"column":3,"offset":7710},"end":{"line":213,"column":103,"offset":7810},"indent":[]}}],"position":{"start":{"line":213,"column":3,"offset":7710},"end":{"line":213,"column":103,"offset":7810},"indent":[]}}],"position":{"start":{"line":213,"column":1,"offset":7708},"end":{"line":213,"column":103,"offset":7810},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"git clone https://github.com/FFmpeg/FFmpeg ffmpeg\ncd ffmpeg && git checkout remotes/origin/release/3.1\n./configure --enable-gpl --enable-libx264 --enable-shared --prefix=/usr\nmake && sudo make install","position":{"start":{"line":215,"column":1,"offset":7812},"end":{"line":220,"column":4,"offset":8022},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Go to your home directory, or any place your prefer and pull the machinery from Github. Afterwards create a build directory and start the compilation.","position":{"start":{"line":222,"column":1,"offset":8024},"end":{"line":222,"column":151,"offset":8174},"indent":[]}}],"position":{"start":{"line":222,"column":1,"offset":8024},"end":{"line":222,"column":151,"offset":8174},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"You can change the ","position":{"start":{"line":224,"column":3,"offset":8178},"end":{"line":224,"column":22,"offset":8197},"indent":[]}},{"type":"inlineCode","value":"-j","position":{"start":{"line":224,"column":22,"offset":8197},"end":{"line":224,"column":26,"offset":8201},"indent":[]}},{"type":"text","value":" attribute of ","position":{"start":{"line":224,"column":26,"offset":8201},"end":{"line":224,"column":40,"offset":8215},"indent":[]}},{"type":"inlineCode","value":"make -j8","position":{"start":{"line":224,"column":40,"offset":8215},"end":{"line":224,"column":50,"offset":8225},"indent":[]}},{"type":"text","value":"to the number of cores of your compilation host.","position":{"start":{"line":224,"column":50,"offset":8225},"end":{"line":224,"column":98,"offset":8273},"indent":[]}}],"position":{"start":{"line":224,"column":3,"offset":8178},"end":{"line":224,"column":98,"offset":8273},"indent":[]}}],"position":{"start":{"line":224,"column":1,"offset":8176},"end":{"line":224,"column":98,"offset":8273},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"cd && git clone https://github.com/kerberos-io/machinery\ncd machinery && mkdir build && cd build\ncmake .. && make -j8 && make check && sudo make install","position":{"start":{"line":226,"column":1,"offset":8275},"end":{"line":230,"column":4,"offset":8437},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"After the machinery is build and installed succesfully, you can enable ","position":{"start":{"line":232,"column":1,"offset":8439},"end":{"line":232,"column":72,"offset":8510},"indent":[]}},{"type":"inlineCode","value":"kerberosio","position":{"start":{"line":232,"column":72,"offset":8510},"end":{"line":232,"column":84,"offset":8522},"indent":[]}},{"type":"text","value":" to start on boot.","position":{"start":{"line":232,"column":84,"offset":8522},"end":{"line":232,"column":102,"offset":8540},"indent":[]}}],"position":{"start":{"line":232,"column":1,"offset":8439},"end":{"line":232,"column":102,"offset":8540},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo systemctl enable kerberosio\nsudo systemctl start kerberosio","position":{"start":{"line":234,"column":1,"offset":8542},"end":{"line":237,"column":4,"offset":8616},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Web","position":{"start":{"line":239,"column":5,"offset":8622},"end":{"line":239,"column":8,"offset":8625},"indent":[]}}],"position":{"start":{"line":239,"column":1,"offset":8618},"end":{"line":239,"column":8,"offset":8625},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to install the web, you'll need to have a webserver (e.g. Nginx) and PHP running with some extensions. You'll also need NodeJS and npm installed, to install Bower.","position":{"start":{"line":241,"column":1,"offset":8627},"end":{"line":241,"column":176,"offset":8802},"indent":[]}}],"position":{"start":{"line":241,"column":1,"offset":8627},"end":{"line":241,"column":176,"offset":8802},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"cd ~\ncurl -sL https://deb.nodesource.com/setup_10.x | sudo bash -\nsudo apt-add-repository -y ppa:ondrej/php\nsudo apt-get -y update\nsudo apt-get install -y git php7.1-cli php7.1-gd php7.1-mcrypt php7.1-curl php7.1-mbstring php7.1-dom php7.1-zip php7.1-fpm nodejs\nsudo npm -g install bower","position":{"start":{"line":243,"column":1,"offset":8804},"end":{"line":250,"column":4,"offset":9101},"indent":[1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Next we'll need to install Nginx, and create a config file.","position":{"start":{"line":252,"column":1,"offset":9103},"end":{"line":252,"column":60,"offset":9162},"indent":[]}}],"position":{"start":{"line":252,"column":1,"offset":9103},"end":{"line":252,"column":60,"offset":9162},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo apt-get -y install nginx\nsudo rm -f /etc/nginx/sites-enabled/default\nsudo nano /etc/nginx/sites-enabled/default","position":{"start":{"line":254,"column":1,"offset":9164},"end":{"line":258,"column":4,"offset":9290},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Assign Nginx to our web interface (which we will soon create).","position":{"start":{"line":260,"column":1,"offset":9292},"end":{"line":260,"column":63,"offset":9354},"indent":[]}}],"position":{"start":{"line":260,"column":1,"offset":9292},"end":{"line":260,"column":63,"offset":9354},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"server\n{\n listen 80 default_server;\n listen [::]:80 default_server;\n root /var/www/web/public;\n server_name kerberos.rpi;\n index index.php index.html index.htm;\n location /\n {\n autoindex on;\n try_files $uri $uri/ /index.php?$query_string;\n }\n location ~ \\.php$\n {\n fastcgi_pass unix:/var/run/php/php7.1-fpm.sock;\n fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;\n include fastcgi_params;\n }\n}","position":{"start":{"line":262,"column":1,"offset":9356},"end":{"line":282,"column":4,"offset":9863},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Now we have all the dependencies installed we can clone the web repository to our working station.","position":{"start":{"line":284,"column":1,"offset":9865},"end":{"line":284,"column":99,"offset":9963},"indent":[]}}],"position":{"start":{"line":284,"column":1,"offset":9865},"end":{"line":284,"column":99,"offset":9963},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"mkdir -p /var/www\ncd /var/www && sudo git clone https://github.com/kerberos-io/web && cd web","position":{"start":{"line":286,"column":1,"offset":9965},"end":{"line":289,"column":4,"offset":10067},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Install the PHP dependency manager, ","position":{"start":{"line":291,"column":1,"offset":10069},"end":{"line":291,"column":37,"offset":10105},"indent":[]}},{"type":"inlineCode","value":"composer","position":{"start":{"line":291,"column":37,"offset":10105},"end":{"line":291,"column":47,"offset":10115},"indent":[]}},{"type":"text","value":", the install all the needed dependencies.","position":{"start":{"line":291,"column":47,"offset":10115},"end":{"line":291,"column":89,"offset":10157},"indent":[]}}],"position":{"start":{"line":291,"column":1,"offset":10069},"end":{"line":291,"column":89,"offset":10157},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"curl -sS https://getcomposer.org/installer | sudo php\nsudo mv composer.phar /usr/bin/composer\nsudo composer install","position":{"start":{"line":293,"column":1,"offset":10159},"end":{"line":297,"column":4,"offset":10284},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Change some permissions, to make sure we can write logging and caching files.","position":{"start":{"line":299,"column":1,"offset":10286},"end":{"line":299,"column":78,"offset":10363},"indent":[]}}],"position":{"start":{"line":299,"column":1,"offset":10286},"end":{"line":299,"column":78,"offset":10363},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo chmod -R 777 storage\nsudo chmod -R 777 bootstrap/cache\nsudo chmod 777 config/kerberos.php","position":{"start":{"line":301,"column":1,"offset":10365},"end":{"line":305,"column":4,"offset":10469},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"We will need to install a couple of more JavaScript libraries using bower.","position":{"start":{"line":307,"column":1,"offset":10471},"end":{"line":307,"column":75,"offset":10545},"indent":[]}}],"position":{"start":{"line":307,"column":1,"offset":10471},"end":{"line":307,"column":75,"offset":10545},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"cd public\nsudo bower --allow-root install\nservice nginx restart","position":{"start":{"line":309,"column":1,"offset":10547},"end":{"line":313,"column":4,"offset":10620},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is setup correctly, you should be able to browse towards the ip-address of your Raspberry Pi and see the Kerberos web interface.","position":{"start":{"line":315,"column":1,"offset":10622},"end":{"line":315,"column":145,"offset":10766},"indent":[]}}],"position":{"start":{"line":315,"column":1,"offset":10622},"end":{"line":315,"column":145,"offset":10766},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Auto removal","position":{"start":{"line":317,"column":5,"offset":10772},"end":{"line":317,"column":17,"offset":10784},"indent":[]}}],"position":{"start":{"line":317,"column":1,"offset":10768},"end":{"line":317,"column":17,"offset":10784},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By default images or videos aren't removed automatically. This means that the Kerberos agent will keep writing to disk, even if there is no more space available on your SD card. When your SD card is full you'll be experiencing strange errors: a corrupt web interface, blank images or corrupt videos.","position":{"start":{"line":319,"column":1,"offset":10786},"end":{"line":319,"column":300,"offset":11085},"indent":[]}}],"position":{"start":{"line":319,"column":1,"offset":10786},"end":{"line":319,"column":300,"offset":11085},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To resolve this your should install a simple bash script and initiate a cronjob which continuously poll your filesystem, and start removing media when your disk is getting full.","position":{"start":{"line":321,"column":1,"offset":11087},"end":{"line":321,"column":178,"offset":11264},"indent":[]}}],"position":{"start":{"line":321,"column":1,"offset":11087},"end":{"line":321,"column":178,"offset":11264},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Create a bash script and copy following script.","position":{"start":{"line":323,"column":1,"offset":11266},"end":{"line":323,"column":48,"offset":11313},"indent":[]}}],"position":{"start":{"line":323,"column":1,"offset":11266},"end":{"line":323,"column":48,"offset":11313},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"nano /home/[user]/autoremoval.sh","position":{"start":{"line":325,"column":1,"offset":11315},"end":{"line":327,"column":4,"offset":11359},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Copy following script (make sure the partition is correct, this is the default one for a Raspberry Pi).","position":{"start":{"line":329,"column":1,"offset":11361},"end":{"line":329,"column":104,"offset":11464},"indent":[]}}],"position":{"start":{"line":329,"column":1,"offset":11361},"end":{"line":329,"column":104,"offset":11464},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"partition=/dev/root\nimagedir=/etc/opt/kerberosio/capture/\nif [[ $(df -h | grep $partition | head -1 | awk -F' ' '{ print $5/1 }' | tr ['%'] [\"0\"]) -gt 90 ]];\nthen\n echo \"Cleaning disk\"\n find $imagedir -type f | sort | head -n 100 | xargs -r rm -rf;\nfi;","position":{"start":{"line":331,"column":1,"offset":11466},"end":{"line":339,"column":4,"offset":11736},"indent":[1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Make the script executable.","position":{"start":{"line":341,"column":1,"offset":11738},"end":{"line":341,"column":28,"offset":11765},"indent":[]}}],"position":{"start":{"line":341,"column":1,"offset":11738},"end":{"line":341,"column":28,"offset":11765},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"chmod +x /home/[user]/autoremoval.sh","position":{"start":{"line":343,"column":1,"offset":11767},"end":{"line":345,"column":4,"offset":11815},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Initiate a cronjob, and select the nano editor.","position":{"start":{"line":347,"column":1,"offset":11817},"end":{"line":347,"column":48,"offset":11864},"indent":[]}}],"position":{"start":{"line":347,"column":1,"offset":11817},"end":{"line":347,"column":48,"offset":11864},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"crontab -e","position":{"start":{"line":349,"column":1,"offset":11866},"end":{"line":351,"column":4,"offset":11888},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Append following line, to execute the autoremoval.sh script every 5min.","position":{"start":{"line":353,"column":1,"offset":11890},"end":{"line":353,"column":72,"offset":11961},"indent":[]}}],"position":{"start":{"line":353,"column":1,"offset":11890},"end":{"line":353,"column":72,"offset":11961},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"*/5 * * * * /bin/bash /home/[user]/autoremoval.sh","position":{"start":{"line":355,"column":1,"offset":11963},"end":{"line":357,"column":4,"offset":12024},"indent":[1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":360,"column":1,"offset":12027},"end":{"line":360,"column":31,"offset":12057},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":360,"column":31,"offset":12057}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Installation`}

\n

{`Kerberos Open Source comes with different installation flavours. So you might think, why? The reason is simple, depending on the use case one option is better than another. A short list of recommendations:`}

\n

{`Plug and play`}

\n
    \n
  1. {`KiOS`}{`: You have a Raspberry Pi, and you only want to run a Kerberos agent on it.`}
    2. \n
  2. {`Docker`}{`: You have a lot of IP cameras, and/or don't want to mess with dependencies.`}
    3. \n
  3. {`Balena`}{`: Runnning the Kerberos Docker container on top of Balena.`}
    4. \n
\n

{`Advanced`}

\n
    \n
  1. {`Raspbian`}{`: You have a Raspberry Pi, but you want other services running next to the Kerberos agent.`}
    2. \n
  2. {`Generic`}{`: You want to develop/extend Kerberos with your own features, or you want to run a Kerberos agent on a not supported OS/architecure.`}
    3. \n
\n
\n

{`Advanced`}

\n

{`Following installation methods are only for advanced users, who need to have more control over the Kerberos Open Source environment.`}

\n

{`Raspbian`}

\n

{`If you have already an OS (e.g. Raspbian Buster) flashed to your Raspberry Pi, then it makes sense to install the Kerberos agent on top of your existing OS. There are two ways to achieve this:`}

\n
    \n
  1. {`Install the Kerberos agent using Docker (more info below),`}
    2. \n
  2. {`or you can install the Kerberos agent manually (machinery + web).`}
    3. \n
\n

{`This section will focus on option 2, and will show you how to install the Kerberos agent manually.`}

\n

{`Update OS`}

\n

{`Let's start with updating the OS, and installing a couple of packages.`}

\n
\n

{`We have tested the Raspbian installation on `}{`Raspbian GNU/Linux 10 (buster)`}{`. It might be that if you have a different version of Raspbian, you will need to install additional/different packages.`}

\n
\n 
{`sudo`}{` `}{`apt`}{`-`}{`get`}{` `}{`update`}{` && `}{`sudo`}{` `}{`apt`}{`-`}{`get`}{` `}{`install`}{` -`}{`y`}{` `}{`ffmpeg`}
\n

{`Machinery`}

\n

{`Download the debian file from the machinery repository.`}

\n
\n

{`https://github.com/kerberos-io/machinery/releases`}

\n
\n

{`A `}{`.deb`}{` file is available for every version of the Raspberry Pi. For example if you are using a Raspberry Pi 4 for version 2.8.0, execute following command. You can change the version and Raspberry Pi board to your needs.`}

\n
\n

{`Please make sure you pick the right board (rpi, rpi2, rpi3 or rpi4), and choose the version you want (e.g. 2.8.0). Replace below url, with your preferences.`}

\n
\n 
{`wget`}{` https:`}{`//github.com/kerberos-io/machinery/releases/download/v2.8.0/rpi4-machinery-kerberosio-armhf-2.8.0.deb`}{`\n`}{`sudo`}{` `}{`dpkg`}{` -`}{`i`}{` `}{`rpi4`}{`-`}{`machinery`}{`-`}{`kerberosio`}{`-`}{`armhf`}{`-`}{`2.8`}{`.0.`}{`deb`}
\n

{`Download the x265 library (version 160) from the machinery repository, as Raspbian Buster 10 only ships with version 165. Make sure you select the right board.`}

\n
\n

{`v2.8.0/rpi4-libx265.so.160`}{` this will download the libx265 shared library for the Raspberry Pi 4.`}

\n
\n 
{`wget`}{` https:`}{`//github.com/kerberos-io/machinery/releases/download/v2.8.0/rpi4-libx265.so.160`}{`\n`}{`sudo`}{` `}{`mv`}{` `}{`rpi4`}{`-`}{`libx265`}{`.`}{`so`}{`.`}{`160`}{` /`}{`usr`}{`/`}{`lib`}{`/`}{`arm`}{`-`}{`linux`}{`-`}{`gnueabihf`}{`/`}{`libx265`}{`.`}{`so`}{`.`}{`160`}
\n

{`Same applies for the libx264 library, download the right shared library.`}

\n
\n

{`v2.8.0/rpi4-libx264.so.148`}{` this will download the libx264 shared library for the Raspberry Pi 4.`}

\n
\n 
{`wget`}{` https:`}{`//github.com/kerberos-io/machinery/releases/download/v2.8.0/rpi4-libx264.so.148`}{`\n`}{`sudo`}{` `}{`mv`}{` `}{`rpi4`}{`-`}{`libx264`}{`.`}{`so`}{`.`}{`148`}{` /`}{`usr`}{`/`}{`lib`}{`/`}{`arm`}{`-`}{`linux`}{`-`}{`gnueabihf`}{`/`}{`libx264`}{`.`}{`so`}{`.`}{`148`}
\n

{`If you wish to use the Raspberry Pi Camera Module, make sure `}{`to enable it`}{` using `}{`sudo raspi-config`}{`.`}

\n 
{`sudo`}{` `}{`raspi`}{`-`}{`config`}
\n

{`Enable machinery to start on boot, and start the service.`}

\n 
{`sudo systemctl enable kerberosio`}{`\n`}{`sudo service kerberosio start`}
\n

{`Web`}

\n

{`Before you can run the web interface, you'll need to download and configure a webserver. We recommend to use Nginx, as it is a light-weight and fast webserver. The web interface is written in PHP, so we also need to download PHP and some packages. Update the packages and kernel.`}

\n

{`Install Nginx and PHP (+extensions).`}

\n 
{`sudo`}{` `}{`apt`}{`-`}{`get`}{` `}{`install`}{` -`}{`y`}{` `}{`nginx`}{` `}{`php7`}{`.`}{`1`}{` `}{`php7`}{`.`}{`1`}{`-`}{`curl`}{` `}{`php7`}{`.`}{`1`}{`-`}{`gd`}{` `}{`php7`}{`.`}{`1`}{`-`}{`fpm`}{` `}{`php7`}{`.`}{`1`}{`-`}{`cli`}{` `}{`php7`}{`.`}{`1`}{`-`}{`opcache`}{` `}{`php7`}{`.`}{`1`}{`-`}{`mbstring`}{` `}{`php7`}{`.`}{`1`}{`-`}{`xml`}{` `}{`php7`}{`.`}{`1`}{`-`}{`zip`}{` `}{`php7`}{`.`}{`1`}{`-`}{`mcrypt`}{` `}{`php7`}{`.`}{`1`}{`-`}{`readline`}
\n

{`Creating a Nginx config.`}

\n 
{`sudo`}{` `}{`rm`}{` -`}{`f`}{` /`}{`etc`}{`/`}{`nginx`}{`/`}{`sites`}{`-`}{`enabled`}{`/`}{`default`}{`\n`}{`sudo`}{` `}{`nano`}{` /`}{`etc`}{`/`}{`nginx`}{`/`}{`sites`}{`-`}{`enabled`}{`/`}{`kerberosio`}{`.`}{`conf`}
\n

{`Copy and paste following config file; this file tells nginx where the web will be installed and that it requires PHP.`}

\n 
{`server`}{`\n`}{`{`}{`\n`}{`    `}{`listen`}{` `}{`80`}{` `}{`default_server`}{`;`}{`\n`}{`    `}{`listen`}{` [::]:`}{`80`}{` `}{`default_server`}{`;`}{`\n`}{`    `}{`root`}{` /`}{`var`}{`/`}{`www`}{`/web/public;`}{`\n`}{`    `}{`server_name`}{` `}{`kerberos`}{`.`}{`rpi`}{`;`}{`\n`}{`    `}{`index`}{` `}{`index`}{`.`}{`php`}{` `}{`index`}{`.`}{`html`}{` `}{`index`}{`.`}{`htm`}{`;`}{`\n`}{`    `}{`location`}{` /`}{`\n`}{`    {`}{`\n`}{`            `}{`autoindex`}{` `}{`on`}{`;`}{`\n`}{`            `}{`try_files`}{` `}{`$uri`}{` `}{`$uri`}{`/ /`}{`index`}{`.`}{`php`}{`?`}{`$query_string`}{`;`}{`\n`}{`    }`}{`\n`}{`    `}{`location`}{` ~ \\\\.`}{`php$`}{`\n`}{`    {`}{`\n`}{`            fastcgi_pass `}{`unix:`}{`/`}{`var`}{`/`}{`run`}{`/`}{`php`}{`/`}{`php7`}{`.`}{`1`}{`-`}{`fpm`}{`.`}{`sock`}{`;`}{`\n`}{`            `}{`fastcgi_param`}{` `}{`SCRIPT_FILENAME`}{` `}{`$document_root$fastcgi_script_name`}{`;`}{`\n`}{`            `}{`include`}{` `}{`fastcgi_params`}{`;`}{`\n`}{`    }`}{`\n`}{`}`}
\n

{`Restart nginx`}

\n 
{`sudo`}{` `}{`service`}{` `}{`nginx`}{` `}{`restart`}
\n

{`Now we have installed all the dependencies, we can download the web interface source code.`}

\n 
{`sudo`}{` `}{`mkdir`}{` -`}{`p`}{` /`}{`var`}{`/`}{`www`}{`/web && sudo chown www-data:`}{`www`}{`-`}{`data`}{` /`}{`var`}{`/`}{`www`}{`/`}{`web`}{`\n`}{`cd`}{` /`}{`var`}{`/`}{`www`}{`/web`}{`\n`}{`sudo`}{` -`}{`u`}{` `}{`www`}{`-`}{`data`}{` `}{`wget`}{` https:`}{`//github.com/kerberos-io/web/releases/download/v2.8.0/web.tar.gz`}{`\n`}{`sudo`}{` -`}{`u`}{` `}{`www`}{`-`}{`data`}{` `}{`tar`}{` `}{`xvf`}{` `}{`web`}{`.`}{`tar`}{`.`}{`gz`}{` .`}{`\n`}{`sudo`}{` `}{`chown`}{` `}{`www`}{`-`}{`data`}{` -`}{`R`}{` `}{`storage`}{` `}{`bootstrap`}{`/`}{`cache`}{` `}{`config`}{`/`}{`kerberos`}{`.`}{`php`}{`\n`}{`sudo`}{` `}{`chmod`}{` -`}{`R`}{` `}{`775`}{` `}{`storage`}{` `}{`bootstrap`}{`/`}{`cache`}{`\n`}{`sudo`}{` `}{`chmod`}{` `}{`0600`}{` `}{`config`}{`/`}{`kerberos`}{`.`}{`php`}
\n

{`Once everything is setup correctly, you should be able to browse towards the ip-address of your Raspberry Pi and see the Kerberos web interface.`}

\n

{`Auto removal`}

\n

{`By default images or videos aren't removed automatically. This means that the Kerberos agent will keep writing to disk, even if there is no more space available on your SD card. When your SD card is full you'll be experiencing strange errors: a corrupt web interface, blank images or corrupt videos.`}

\n

{`To resolve this your should install a simple bash script and initiate a cronjob which continuously poll your filesystem, and start removing media when your disk is getting full.`}

\n

{`Create a bash script and copy following script.`}

\n 
{`nano /home/pi/autoremoval.sh`}
\n

{`Copy following script (make sure the partition is correct, this is the default one for a Raspberry Pi).`}

\n 
{`partition=/dev/root`}{`\n`}{`imagedir=/etc/opt/kerberosio/capture/`}{`\n`}{`if`}{` [[ `}{`$(df -h `}{`|`}{` grep `}{`$partition`}{` `}{`|`}{` head -1 `}{`|`}{` awk -F' ' '{ print $5/1 }' `}{`|`}{` tr ['%'] [\"0\"])`}{` -gt 90 ]];`}{`\n`}{`then`}{`\n`}{`    `}{`echo`}{` `}{`\"Cleaning disk\"`}{`\n`}{`    find `}{`$imagedir`}{` -type f | sort | head -n 100 | xargs -r rm -rf;`}{`\n`}{`fi`}{`;`}
\n

{`Make the script executable.`}

\n 
{`chmod +x /home/pi/autoremoval.sh`}
\n

{`Initiate a cronjob, and select the nano editor.`}

\n 
{`crontab -e`}
\n

{`Append following line, to execute the autoremoval.sh script every 5min.`}

\n 
{`*/5 * * * * /bin/bash /home/pi/autoremoval.sh`}
\n

{`Generic`}

\n

{`If you want to install the Kerberos agent from source on your working station or server, either for development or running the software, this is the preferred installation procedure. We are assuming that you use a Linux OS, when using Mac OSX the installation is slightly different.`}

\n
\n

{`This was tested on a Ubuntu VM (18.04.3 (LTS) x64).`}

\n
\n

{`Machinery`}

\n

{`Update the packages and kernel, and install some development tools.`}

\n 
{`sudo`}{` `}{`apt`}{`-`}{`get`}{` -`}{`y`}{` `}{`update`}{`\n`}{`sudo`}{` `}{`apt`}{`-`}{`get`}{` `}{`install`}{` -`}{`y`}{` `}{`git`}{` `}{`cmake`}{` `}{`subversion`}{` `}{`dh`}{`-`}{`autoreconf`}{` `}{`libcurl4`}{`-`}{`openssl`}{`-`}{`dev`}{` `}{`yasm`}{` `}{`libx264`}{`-`}{`dev`}{` `}{`pkg`}{`-`}{`config`}{` `}{`libssl`}{`-`}{`dev`}
\n

{`Install the FFmpeg library with x264 support.`}

\n
\n

{`It's recommended to install FFmpeg 3.1. Later versions might give issues at compilation or run time.`}

\n
\n 
{`git`}{` `}{`clone`}{` https:`}{`//github.com/FFmpeg/FFmpeg ffmpeg`}{`\n`}{`cd`}{` `}{`ffmpeg`}{` && `}{`git`}{` `}{`checkout`}{` `}{`remotes`}{`/`}{`origin`}{`/`}{`release`}{`/`}{`3.1`}{`\n`}{`./`}{`configure`}{` --`}{`enable`}{`-`}{`gpl`}{` --`}{`enable`}{`-`}{`libx264`}{` --`}{`enable`}{`-`}{`shared`}{` --`}{`prefix`}{`=/`}{`usr`}{`\n`}{`make`}{` && `}{`sudo`}{` `}{`make`}{` `}{`install`}
\n

{`Go to your home directory, or any place your prefer and pull the machinery from Github. Afterwards create a build directory and start the compilation.`}

\n
\n

{`You can change the `}{`-j`}{` attribute of `}{`make -j8`}{`to the number of cores of your compilation host.`}

\n
\n 
{`cd`}{` && `}{`git`}{` `}{`clone`}{` https:`}{`//github.com/kerberos-io/machinery`}{`\n`}{`cd`}{` `}{`machinery`}{` && `}{`mkdir`}{` `}{`build`}{` && `}{`cd`}{` `}{`build`}{`\n`}{`cmake`}{` .. && `}{`make`}{` -`}{`j8`}{` && `}{`make`}{` `}{`check`}{` && `}{`sudo`}{` `}{`make`}{` `}{`install`}
\n

{`After the machinery is build and installed succesfully, you can enable `}{`kerberosio`}{` to start on boot.`}

\n 
{`sudo`}{` `}{`systemctl`}{` `}{`enable`}{` `}{`kerberosio`}{`\n`}{`sudo`}{` `}{`systemctl`}{` `}{`start`}{` `}{`kerberosio`}
\n

{`Web`}

\n

{`If you want to install the web, you'll need to have a webserver (e.g. Nginx) and PHP running with some extensions. You'll also need NodeJS and npm installed, to install Bower.`}

\n 
{`cd`}{` ~`}{`\n`}{`curl`}{` -`}{`sL`}{` https:`}{`//deb.nodesource.com/setup_10.x | sudo bash -`}{`\n`}{`sudo`}{` `}{`apt`}{`-`}{`add`}{`-`}{`repository`}{` -`}{`y`}{` ppa:`}{`ondrej`}{`/`}{`php`}{`\n`}{`sudo`}{` `}{`apt`}{`-`}{`get`}{` -`}{`y`}{` `}{`update`}{`\n`}{`sudo`}{` `}{`apt`}{`-`}{`get`}{` `}{`install`}{` -`}{`y`}{` `}{`git`}{` `}{`php7`}{`.`}{`1`}{`-`}{`cli`}{` `}{`php7`}{`.`}{`1`}{`-`}{`gd`}{` `}{`php7`}{`.`}{`1`}{`-`}{`mcrypt`}{` `}{`php7`}{`.`}{`1`}{`-`}{`curl`}{` `}{`php7`}{`.`}{`1`}{`-`}{`mbstring`}{` `}{`php7`}{`.`}{`1`}{`-`}{`dom`}{` `}{`php7`}{`.`}{`1`}{`-`}{`zip`}{` `}{`php7`}{`.`}{`1`}{`-`}{`fpm`}{` `}{`nodejs`}{`\n`}{`sudo`}{` `}{`npm`}{` -`}{`g`}{` `}{`install`}{` `}{`bower`}
\n

{`Next we'll need to install Nginx, and create a config file.`}

\n 
{`sudo`}{` `}{`apt`}{`-`}{`get`}{` -`}{`y`}{` `}{`install`}{` `}{`nginx`}{`\n`}{`sudo`}{` `}{`rm`}{` -`}{`f`}{` /`}{`etc`}{`/`}{`nginx`}{`/`}{`sites`}{`-`}{`enabled`}{`/`}{`default`}{`\n`}{`sudo`}{` `}{`nano`}{` /`}{`etc`}{`/`}{`nginx`}{`/`}{`sites`}{`-`}{`enabled`}{`/`}{`default`}
\n

{`Assign Nginx to our web interface (which we will soon create).`}

\n 
{`server`}{`\n`}{`{`}{`\n`}{`    `}{`listen`}{` `}{`80`}{` `}{`default_server`}{`;`}{`\n`}{`    `}{`listen`}{` [::]:`}{`80`}{` `}{`default_server`}{`;`}{`\n`}{`    `}{`root`}{` /`}{`var`}{`/`}{`www`}{`/web/public;`}{`\n`}{`    `}{`server_name`}{` `}{`kerberos`}{`.`}{`rpi`}{`;`}{`\n`}{`    `}{`index`}{` `}{`index`}{`.`}{`php`}{` `}{`index`}{`.`}{`html`}{` `}{`index`}{`.`}{`htm`}{`;`}{`\n`}{`    `}{`location`}{` /`}{`\n`}{`    {`}{`\n`}{`            `}{`autoindex`}{` `}{`on`}{`;`}{`\n`}{`            `}{`try_files`}{` `}{`$uri`}{` `}{`$uri`}{`/ /`}{`index`}{`.`}{`php`}{`?`}{`$query_string`}{`;`}{`\n`}{`    }`}{`\n`}{`    `}{`location`}{` ~ \\\\.`}{`php$`}{`\n`}{`    {`}{`\n`}{`            fastcgi_pass `}{`unix:`}{`/`}{`var`}{`/`}{`run`}{`/`}{`php`}{`/`}{`php7`}{`.`}{`1`}{`-`}{`fpm`}{`.`}{`sock`}{`;`}{`\n`}{`            `}{`fastcgi_param`}{` `}{`SCRIPT_FILENAME`}{` `}{`$document_root$fastcgi_script_name`}{`;`}{`\n`}{`            `}{`include`}{` `}{`fastcgi_params`}{`;`}{`\n`}{`    }`}{`\n`}{`}`}
\n

{`Now we have all the dependencies installed we can clone the web repository to our working station.`}

\n 
{`mkdir`}{` -`}{`p`}{` /`}{`var`}{`/`}{`www`}{`\n`}{`cd`}{` /`}{`var`}{`/`}{`www`}{` && sudo git clone https:`}{`//github.com/kerberos-io/web && cd web`}
\n

{`Install the PHP dependency manager, `}{`composer`}{`, the install all the needed dependencies.`}

\n 
{`curl`}{` -`}{`sS`}{` https:`}{`//getcomposer.org/installer | sudo php`}{`\n`}{`sudo`}{` `}{`mv`}{` `}{`composer`}{`.`}{`phar`}{` /`}{`usr`}{`/`}{`bin`}{`/`}{`composer`}{`\n`}{`sudo`}{` `}{`composer`}{` `}{`install`}
\n

{`Change some permissions, to make sure we can write logging and caching files.`}

\n 
{`sudo`}{` `}{`chmod`}{` -`}{`R`}{` `}{`777`}{` `}{`storage`}{`\n`}{`sudo`}{` `}{`chmod`}{` -`}{`R`}{` `}{`777`}{` `}{`bootstrap`}{`/`}{`cache`}{`\n`}{`sudo`}{` `}{`chmod`}{` `}{`777`}{` `}{`config`}{`/`}{`kerberos`}{`.`}{`php`}
\n

{`We will need to install a couple of more JavaScript libraries using bower.`}

\n 
{`cd`}{` `}{`public`}{`\n`}{`sudo`}{` `}{`bower`}{` --`}{`allow`}{`-`}{`root`}{` `}{`install`}{`\n`}{`service`}{` `}{`nginx`}{` `}{`restart`}
\n

{`Once everything is setup correctly, you should be able to browse towards the ip-address of your Raspberry Pi and see the Kerberos web interface.`}

\n

{`Auto removal`}

\n

{`By default images or videos aren't removed automatically. This means that the Kerberos agent will keep writing to disk, even if there is no more space available on your SD card. When your SD card is full you'll be experiencing strange errors: a corrupt web interface, blank images or corrupt videos.`}

\n

{`To resolve this your should install a simple bash script and initiate a cronjob which continuously poll your filesystem, and start removing media when your disk is getting full.`}

\n

{`Create a bash script and copy following script.`}

\n 
{`nano /home/[user]/autoremoval.sh`}
\n

{`Copy following script (make sure the partition is correct, this is the default one for a Raspberry Pi).`}

\n 
{`partition=/dev/root`}{`\n`}{`imagedir=/etc/opt/kerberosio/capture/`}{`\n`}{`if`}{` [[ `}{`$(df -h `}{`|`}{` grep `}{`$partition`}{` `}{`|`}{` head -1 `}{`|`}{` awk -F' ' '{ print $5/1 }' `}{`|`}{` tr ['%'] [\"0\"])`}{` -gt 90 ]];`}{`\n`}{`then`}{`\n`}{`    `}{`echo`}{` `}{`\"Cleaning disk\"`}{`\n`}{`    find `}{`$imagedir`}{` -type f | sort | head -n 100 | xargs -r rm -rf;`}{`\n`}{`fi`}{`;`}
\n

{`Make the script executable.`}

\n 
{`chmod +x /home/[user]/autoremoval.sh`}
\n

{`Initiate a cronjob, and select the nano editor.`}

\n 
{`crontab -e`}
\n

{`Append following line, to execute the autoremoval.sh script every 5min.`}

\n 
{`*/5 * * * * /bin/bash /home/[user]/autoremoval.sh`}
\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750192000,"key":"gatsby-plugin-mdx-entire-payload-4d75bdd89156882cf03d09e1b2abe7e1-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source comes with different installation flavours. So you might think, why? The reason is simple, depending on the use case one option is better than another. A short list of recommendations:","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":207,"offset":441},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":207,"offset":441},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Plug and play","position":{"start":{"line":14,"column":5,"offset":447},"end":{"line":14,"column":18,"offset":460},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":443},"end":{"line":14,"column":18,"offset":460},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation#kios","children":[{"type":"text","value":"KiOS","position":{"start":{"line":15,"column":5,"offset":465},"end":{"line":15,"column":9,"offset":469},"indent":[]}}],"position":{"start":{"line":15,"column":4,"offset":464},"end":{"line":15,"column":41,"offset":501},"indent":[]}},{"type":"text","value":": You have a Raspberry Pi, and you only want to run a Kerberos agent on it.","position":{"start":{"line":15,"column":41,"offset":501},"end":{"line":15,"column":116,"offset":576},"indent":[]}}],"position":{"start":{"line":15,"column":4,"offset":464},"end":{"line":15,"column":116,"offset":576},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":461},"end":{"line":15,"column":116,"offset":576},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation#docker","children":[{"type":"text","value":"Docker","position":{"start":{"line":16,"column":5,"offset":581},"end":{"line":16,"column":11,"offset":587},"indent":[]}}],"position":{"start":{"line":16,"column":4,"offset":580},"end":{"line":16,"column":45,"offset":621},"indent":[]}},{"type":"text","value":": You have a lot of IP cameras, and/or don't want to mess with dependencies.","position":{"start":{"line":16,"column":45,"offset":621},"end":{"line":16,"column":121,"offset":697},"indent":[]}}],"position":{"start":{"line":16,"column":4,"offset":580},"end":{"line":16,"column":121,"offset":697},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":577},"end":{"line":16,"column":121,"offset":697},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation#balena","children":[{"type":"text","value":"Balena","position":{"start":{"line":17,"column":5,"offset":702},"end":{"line":17,"column":11,"offset":708},"indent":[]}}],"position":{"start":{"line":17,"column":4,"offset":701},"end":{"line":17,"column":45,"offset":742},"indent":[]}},{"type":"text","value":": Runnning the Kerberos Docker container on top of Balena.","position":{"start":{"line":17,"column":45,"offset":742},"end":{"line":17,"column":103,"offset":800},"indent":[]}}],"position":{"start":{"line":17,"column":4,"offset":701},"end":{"line":17,"column":103,"offset":800},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":698},"end":{"line":17,"column":103,"offset":800},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":461},"end":{"line":17,"column":103,"offset":800},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Advanced","position":{"start":{"line":19,"column":5,"offset":806},"end":{"line":19,"column":13,"offset":814},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":802},"end":{"line":19,"column":13,"offset":814},"indent":[]}},{"type":"list","ordered":true,"start":4,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation-advanced#raspbian","children":[{"type":"text","value":"Raspbian","position":{"start":{"line":20,"column":5,"offset":819},"end":{"line":20,"column":13,"offset":827},"indent":[]}}],"position":{"start":{"line":20,"column":4,"offset":818},"end":{"line":20,"column":58,"offset":872},"indent":[]}},{"type":"text","value":": You have a Raspberry Pi, but you want other services running next to the Kerberos agent.","position":{"start":{"line":20,"column":58,"offset":872},"end":{"line":20,"column":148,"offset":962},"indent":[]}}],"position":{"start":{"line":20,"column":4,"offset":818},"end":{"line":20,"column":148,"offset":962},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":815},"end":{"line":20,"column":148,"offset":962},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation-advanced#generic","children":[{"type":"text","value":"Generic","position":{"start":{"line":21,"column":5,"offset":967},"end":{"line":21,"column":12,"offset":974},"indent":[]}}],"position":{"start":{"line":21,"column":4,"offset":966},"end":{"line":21,"column":56,"offset":1018},"indent":[]}},{"type":"text","value":": You want to develop/extend Kerberos with your own features, or you want to run a Kerberos agent on a not supported OS/architecure.","position":{"start":{"line":21,"column":56,"offset":1018},"end":{"line":21,"column":188,"offset":1150},"indent":[]}}],"position":{"start":{"line":21,"column":4,"offset":966},"end":{"line":21,"column":188,"offset":1150},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":963},"end":{"line":21,"column":188,"offset":1150},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":815},"end":{"line":21,"column":188,"offset":1150},"indent":[1]}},{"type":"thematicBreak","position":{"start":{"line":23,"column":1,"offset":1152},"end":{"line":23,"column":4,"offset":1155},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Advanced","position":{"start":{"line":25,"column":3,"offset":1159},"end":{"line":25,"column":11,"offset":1167},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1157},"end":{"line":25,"column":11,"offset":1167},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Following installation methods are only for advanced users, who need to have more control over the Kerberos Open Source environment.","position":{"start":{"line":27,"column":1,"offset":1169},"end":{"line":27,"column":133,"offset":1301},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1169},"end":{"line":27,"column":133,"offset":1301},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Raspbian","position":{"start":{"line":29,"column":4,"offset":1306},"end":{"line":29,"column":12,"offset":1314},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1303},"end":{"line":29,"column":12,"offset":1314},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you have already an OS (e.g. Raspbian Buster) flashed to your Raspberry Pi, then it makes sense to install the Kerberos agent on top of your existing OS. There are two ways to achieve this:","position":{"start":{"line":31,"column":1,"offset":1316},"end":{"line":31,"column":193,"offset":1508},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1316},"end":{"line":31,"column":193,"offset":1508},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Install the Kerberos agent using Docker (more info below),","position":{"start":{"line":33,"column":4,"offset":1513},"end":{"line":33,"column":62,"offset":1571},"indent":[]}}],"position":{"start":{"line":33,"column":4,"offset":1513},"end":{"line":33,"column":62,"offset":1571},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1510},"end":{"line":33,"column":62,"offset":1571},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"or you can install the Kerberos agent manually (machinery + web).","position":{"start":{"line":34,"column":4,"offset":1575},"end":{"line":34,"column":69,"offset":1640},"indent":[]}}],"position":{"start":{"line":34,"column":4,"offset":1575},"end":{"line":34,"column":69,"offset":1640},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":1572},"end":{"line":34,"column":69,"offset":1640},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1510},"end":{"line":34,"column":69,"offset":1640},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"This section will focus on option 2, and will show you how to install the Kerberos agent manually.","position":{"start":{"line":36,"column":1,"offset":1642},"end":{"line":36,"column":99,"offset":1740},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":1642},"end":{"line":36,"column":99,"offset":1740},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Update OS","position":{"start":{"line":38,"column":5,"offset":1746},"end":{"line":38,"column":14,"offset":1755},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1742},"end":{"line":38,"column":14,"offset":1755},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Let's start with updating the OS, and installing a couple of packages.","position":{"start":{"line":40,"column":1,"offset":1757},"end":{"line":40,"column":71,"offset":1827},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1757},"end":{"line":40,"column":71,"offset":1827},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"We have tested the Raspbian installation on ","position":{"start":{"line":42,"column":3,"offset":1831},"end":{"line":42,"column":47,"offset":1875},"indent":[]}},{"type":"inlineCode","value":"Raspbian GNU/Linux 10 (buster)","position":{"start":{"line":42,"column":47,"offset":1875},"end":{"line":42,"column":79,"offset":1907},"indent":[]}},{"type":"text","value":". It might be that if you have a different version of Raspbian, you will need to install additional/different packages.","position":{"start":{"line":42,"column":79,"offset":1907},"end":{"line":42,"column":198,"offset":2026},"indent":[]}}],"position":{"start":{"line":42,"column":3,"offset":1831},"end":{"line":42,"column":198,"offset":2026},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":1829},"end":{"line":42,"column":198,"offset":2026},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo apt-get update && sudo apt-get install -y ffmpeg","position":{"start":{"line":44,"column":1,"offset":2028},"end":{"line":46,"column":4,"offset":2091},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":48,"column":5,"offset":2097},"end":{"line":48,"column":14,"offset":2106},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":2093},"end":{"line":48,"column":14,"offset":2106},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Download the debian file from the machinery repository.","position":{"start":{"line":50,"column":1,"offset":2108},"end":{"line":50,"column":56,"offset":2163},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2108},"end":{"line":50,"column":56,"offset":2163},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://github.com/kerberos-io/machinery/releases","children":[{"type":"text","value":"https://github.com/kerberos-io/machinery/releases","position":{"start":{"line":51,"column":3,"offset":2166},"end":{"line":51,"column":52,"offset":2215},"indent":[]}}],"position":{"start":{"line":51,"column":3,"offset":2166},"end":{"line":51,"column":52,"offset":2215},"indent":[]}}],"position":{"start":{"line":51,"column":3,"offset":2166},"end":{"line":51,"column":52,"offset":2215},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2164},"end":{"line":51,"column":52,"offset":2215},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A ","position":{"start":{"line":53,"column":1,"offset":2217},"end":{"line":53,"column":3,"offset":2219},"indent":[]}},{"type":"inlineCode","value":".deb","position":{"start":{"line":53,"column":3,"offset":2219},"end":{"line":53,"column":9,"offset":2225},"indent":[]}},{"type":"text","value":" file is available for every version of the Raspberry Pi. For example if you are using a Raspberry Pi 4 for version 2.8.0, execute following command. You can change the version and Raspberry Pi board to your needs.","position":{"start":{"line":53,"column":9,"offset":2225},"end":{"line":53,"column":223,"offset":2439},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2217},"end":{"line":53,"column":223,"offset":2439},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"Please make sure you pick the right board (rpi, rpi2, rpi3 or rpi4), and choose the version you want (e.g. 2.8.0). Replace below url, with your preferences.","position":{"start":{"line":55,"column":3,"offset":2443},"end":{"line":55,"column":159,"offset":2599},"indent":[]}}],"position":{"start":{"line":55,"column":3,"offset":2443},"end":{"line":55,"column":159,"offset":2599},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2441},"end":{"line":55,"column":159,"offset":2599},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"wget https://github.com/kerberos-io/machinery/releases/download/v2.8.0/rpi4-machinery-kerberosio-armhf-2.8.0.deb\nsudo dpkg -i rpi4-machinery-kerberosio-armhf-2.8.0.deb","position":{"start":{"line":57,"column":1,"offset":2601},"end":{"line":60,"column":4,"offset":2778},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Download the x265 library (version 160) from the machinery repository, as Raspbian Buster 10 only ships with version 165. Make sure you select the right board.","position":{"start":{"line":62,"column":1,"offset":2780},"end":{"line":62,"column":160,"offset":2939},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":2780},"end":{"line":62,"column":160,"offset":2939},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"inlineCode","value":"v2.8.0/rpi4-libx265.so.160","position":{"start":{"line":64,"column":3,"offset":2943},"end":{"line":64,"column":31,"offset":2971},"indent":[]}},{"type":"text","value":" this will download the libx265 shared library for the Raspberry Pi 4.","position":{"start":{"line":64,"column":31,"offset":2971},"end":{"line":64,"column":101,"offset":3041},"indent":[]}}],"position":{"start":{"line":64,"column":3,"offset":2943},"end":{"line":64,"column":101,"offset":3041},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":2941},"end":{"line":64,"column":101,"offset":3041},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"wget https://github.com/kerberos-io/machinery/releases/download/v2.8.0/rpi4-libx265.so.160\nsudo mv rpi4-libx265.so.160 /usr/lib/arm-linux-gnueabihf/libx265.so.160","position":{"start":{"line":66,"column":1,"offset":3043},"end":{"line":69,"column":4,"offset":3215},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Same applies for the libx264 library, download the right shared library.","position":{"start":{"line":71,"column":1,"offset":3217},"end":{"line":71,"column":73,"offset":3289},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3217},"end":{"line":71,"column":73,"offset":3289},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"inlineCode","value":"v2.8.0/rpi4-libx264.so.148","position":{"start":{"line":73,"column":3,"offset":3293},"end":{"line":73,"column":31,"offset":3321},"indent":[]}},{"type":"text","value":" this will download the libx264 shared library for the Raspberry Pi 4.","position":{"start":{"line":73,"column":31,"offset":3321},"end":{"line":73,"column":101,"offset":3391},"indent":[]}}],"position":{"start":{"line":73,"column":3,"offset":3293},"end":{"line":73,"column":101,"offset":3391},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":3291},"end":{"line":73,"column":101,"offset":3391},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"wget https://github.com/kerberos-io/machinery/releases/download/v2.8.0/rpi4-libx264.so.148\nsudo mv rpi4-libx264.so.148 /usr/lib/arm-linux-gnueabihf/libx264.so.148","position":{"start":{"line":75,"column":1,"offset":3393},"end":{"line":78,"column":4,"offset":3565},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"If you wish to use the Raspberry Pi Camera Module, make sure ","position":{"start":{"line":80,"column":1,"offset":3567},"end":{"line":80,"column":62,"offset":3628},"indent":[]}},{"type":"link","title":null,"url":"https://www.raspberrypi.org/documentation/configuration/camera.md","children":[{"type":"text","value":"to enable it","position":{"start":{"line":80,"column":63,"offset":3629},"end":{"line":80,"column":75,"offset":3641},"indent":[]}}],"position":{"start":{"line":80,"column":62,"offset":3628},"end":{"line":80,"column":143,"offset":3709},"indent":[]}},{"type":"text","value":" using ","position":{"start":{"line":80,"column":143,"offset":3709},"end":{"line":80,"column":150,"offset":3716},"indent":[]}},{"type":"inlineCode","value":"sudo raspi-config","position":{"start":{"line":80,"column":150,"offset":3716},"end":{"line":80,"column":169,"offset":3735},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":80,"column":169,"offset":3735},"end":{"line":80,"column":170,"offset":3736},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":3567},"end":{"line":80,"column":170,"offset":3736},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo raspi-config","position":{"start":{"line":82,"column":1,"offset":3738},"end":{"line":84,"column":4,"offset":3765},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Enable machinery to start on boot, and start the service.","position":{"start":{"line":86,"column":1,"offset":3767},"end":{"line":86,"column":58,"offset":3824},"indent":[]}}],"position":{"start":{"line":86,"column":1,"offset":3767},"end":{"line":86,"column":58,"offset":3824},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"sudo systemctl enable kerberosio\nsudo service kerberosio start","position":{"start":{"line":88,"column":1,"offset":3826},"end":{"line":91,"column":4,"offset":3896},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Web","position":{"start":{"line":93,"column":5,"offset":3902},"end":{"line":93,"column":8,"offset":3905},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":3898},"end":{"line":93,"column":8,"offset":3905},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before you can run the web interface, you'll need to download and configure a webserver. We recommend to use Nginx, as it is a light-weight and fast webserver. The web interface is written in PHP, so we also need to download PHP and some packages. Update the packages and kernel.","position":{"start":{"line":95,"column":1,"offset":3907},"end":{"line":95,"column":280,"offset":4186},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":3907},"end":{"line":95,"column":280,"offset":4186},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Install Nginx and PHP (+extensions).","position":{"start":{"line":97,"column":1,"offset":4188},"end":{"line":97,"column":37,"offset":4224},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4188},"end":{"line":97,"column":37,"offset":4224},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo apt-get install -y nginx php7.1 php7.1-curl php7.1-gd php7.1-fpm php7.1-cli php7.1-opcache php7.1-mbstring php7.1-xml php7.1-zip php7.1-mcrypt php7.1-readline","position":{"start":{"line":99,"column":1,"offset":4226},"end":{"line":101,"column":4,"offset":4399},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Creating a Nginx config.","position":{"start":{"line":103,"column":1,"offset":4401},"end":{"line":103,"column":25,"offset":4425},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":4401},"end":{"line":103,"column":25,"offset":4425},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo rm -f /etc/nginx/sites-enabled/default\nsudo nano /etc/nginx/sites-enabled/kerberosio.conf","position":{"start":{"line":105,"column":1,"offset":4427},"end":{"line":108,"column":4,"offset":4531},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Copy and paste following config file; this file tells nginx where the web will be installed and that it requires PHP.","position":{"start":{"line":110,"column":1,"offset":4533},"end":{"line":110,"column":118,"offset":4650},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":4533},"end":{"line":110,"column":118,"offset":4650},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"server\n{\n listen 80 default_server;\n listen [::]:80 default_server;\n root /var/www/web/public;\n server_name kerberos.rpi;\n index index.php index.html index.htm;\n location /\n {\n autoindex on;\n try_files $uri $uri/ /index.php?$query_string;\n }\n location ~ \\.php$\n {\n fastcgi_pass unix:/var/run/php/php7.1-fpm.sock;\n fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;\n include fastcgi_params;\n }\n}","position":{"start":{"line":112,"column":1,"offset":4652},"end":{"line":132,"column":4,"offset":5159},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Restart nginx","position":{"start":{"line":134,"column":1,"offset":5161},"end":{"line":134,"column":14,"offset":5174},"indent":[]}}],"position":{"start":{"line":134,"column":1,"offset":5161},"end":{"line":134,"column":14,"offset":5174},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo service nginx restart","position":{"start":{"line":136,"column":1,"offset":5176},"end":{"line":138,"column":4,"offset":5212},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Now we have installed all the dependencies, we can download the web interface source code.","position":{"start":{"line":140,"column":1,"offset":5214},"end":{"line":140,"column":91,"offset":5304},"indent":[]}}],"position":{"start":{"line":140,"column":1,"offset":5214},"end":{"line":140,"column":91,"offset":5304},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo mkdir -p /var/www/web && sudo chown www-data:www-data /var/www/web\ncd /var/www/web\nsudo -u www-data wget https://github.com/kerberos-io/web/releases/download/v2.8.0/web.tar.gz\nsudo -u www-data tar xvf web.tar.gz .\nsudo chown www-data -R storage bootstrap/cache config/kerberos.php\nsudo chmod -R 775 storage bootstrap/cache\nsudo chmod 0600 config/kerberos.php","position":{"start":{"line":142,"column":1,"offset":5306},"end":{"line":150,"column":4,"offset":5679},"indent":[1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is setup correctly, you should be able to browse towards the ip-address of your Raspberry Pi and see the Kerberos web interface.","position":{"start":{"line":152,"column":1,"offset":5681},"end":{"line":152,"column":145,"offset":5825},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":5681},"end":{"line":152,"column":145,"offset":5825},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Auto removal","position":{"start":{"line":154,"column":5,"offset":5831},"end":{"line":154,"column":17,"offset":5843},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":5827},"end":{"line":154,"column":17,"offset":5843},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By default images or videos aren't removed automatically. This means that the Kerberos agent will keep writing to disk, even if there is no more space available on your SD card. When your SD card is full you'll be experiencing strange errors: a corrupt web interface, blank images or corrupt videos.","position":{"start":{"line":156,"column":1,"offset":5845},"end":{"line":156,"column":300,"offset":6144},"indent":[]}}],"position":{"start":{"line":156,"column":1,"offset":5845},"end":{"line":156,"column":300,"offset":6144},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To resolve this your should install a simple bash script and initiate a cronjob which continuously poll your filesystem, and start removing media when your disk is getting full.","position":{"start":{"line":158,"column":1,"offset":6146},"end":{"line":158,"column":178,"offset":6323},"indent":[]}}],"position":{"start":{"line":158,"column":1,"offset":6146},"end":{"line":158,"column":178,"offset":6323},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Create a bash script and copy following script.","position":{"start":{"line":160,"column":1,"offset":6325},"end":{"line":160,"column":48,"offset":6372},"indent":[]}}],"position":{"start":{"line":160,"column":1,"offset":6325},"end":{"line":160,"column":48,"offset":6372},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"nano /home/pi/autoremoval.sh","position":{"start":{"line":162,"column":1,"offset":6374},"end":{"line":164,"column":4,"offset":6414},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Copy following script (make sure the partition is correct, this is the default one for a Raspberry Pi).","position":{"start":{"line":166,"column":1,"offset":6416},"end":{"line":166,"column":104,"offset":6519},"indent":[]}}],"position":{"start":{"line":166,"column":1,"offset":6416},"end":{"line":166,"column":104,"offset":6519},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"partition=/dev/root\nimagedir=/etc/opt/kerberosio/capture/\nif [[ $(df -h | grep $partition | head -1 | awk -F' ' '{ print $5/1 }' | tr ['%'] [\"0\"]) -gt 90 ]];\nthen\n echo \"Cleaning disk\"\n find $imagedir -type f | sort | head -n 100 | xargs -r rm -rf;\nfi;","position":{"start":{"line":168,"column":1,"offset":6521},"end":{"line":176,"column":4,"offset":6791},"indent":[1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Make the script executable.","position":{"start":{"line":178,"column":1,"offset":6793},"end":{"line":178,"column":28,"offset":6820},"indent":[]}}],"position":{"start":{"line":178,"column":1,"offset":6793},"end":{"line":178,"column":28,"offset":6820},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"chmod +x /home/pi/autoremoval.sh","position":{"start":{"line":180,"column":1,"offset":6822},"end":{"line":182,"column":4,"offset":6866},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Initiate a cronjob, and select the nano editor.","position":{"start":{"line":184,"column":1,"offset":6868},"end":{"line":184,"column":48,"offset":6915},"indent":[]}}],"position":{"start":{"line":184,"column":1,"offset":6868},"end":{"line":184,"column":48,"offset":6915},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"crontab -e","position":{"start":{"line":186,"column":1,"offset":6917},"end":{"line":188,"column":4,"offset":6939},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Append following line, to execute the autoremoval.sh script every 5min.","position":{"start":{"line":190,"column":1,"offset":6941},"end":{"line":190,"column":72,"offset":7012},"indent":[]}}],"position":{"start":{"line":190,"column":1,"offset":6941},"end":{"line":190,"column":72,"offset":7012},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"*/5 * * * * /bin/bash /home/pi/autoremoval.sh","position":{"start":{"line":192,"column":1,"offset":7014},"end":{"line":194,"column":4,"offset":7071},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Generic","position":{"start":{"line":196,"column":4,"offset":7076},"end":{"line":196,"column":11,"offset":7083},"indent":[]}}],"position":{"start":{"line":196,"column":1,"offset":7073},"end":{"line":196,"column":11,"offset":7083},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to install the Kerberos agent from source on your working station or server, either for development or running the software, this is the preferred installation procedure. We are assuming that you use a Linux OS, when using Mac OSX the installation is slightly different.","position":{"start":{"line":198,"column":1,"offset":7085},"end":{"line":198,"column":283,"offset":7367},"indent":[]}}],"position":{"start":{"line":198,"column":1,"offset":7085},"end":{"line":198,"column":283,"offset":7367},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"This was tested on a Ubuntu VM (18.04.3 (LTS) x64).","position":{"start":{"line":200,"column":3,"offset":7371},"end":{"line":200,"column":54,"offset":7422},"indent":[]}}],"position":{"start":{"line":200,"column":3,"offset":7371},"end":{"line":200,"column":54,"offset":7422},"indent":[]}}],"position":{"start":{"line":200,"column":1,"offset":7369},"end":{"line":200,"column":54,"offset":7422},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":202,"column":5,"offset":7428},"end":{"line":202,"column":14,"offset":7437},"indent":[]}}],"position":{"start":{"line":202,"column":1,"offset":7424},"end":{"line":202,"column":14,"offset":7437},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Update the packages and kernel, and install some development tools.","position":{"start":{"line":204,"column":1,"offset":7439},"end":{"line":204,"column":68,"offset":7506},"indent":[]}}],"position":{"start":{"line":204,"column":1,"offset":7439},"end":{"line":204,"column":68,"offset":7506},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo apt-get -y update\nsudo apt-get install -y git cmake subversion dh-autoreconf libcurl4-openssl-dev yasm libx264-dev pkg-config libssl-dev","position":{"start":{"line":206,"column":1,"offset":7508},"end":{"line":209,"column":4,"offset":7659},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Install the FFmpeg library with x264 support.","position":{"start":{"line":211,"column":1,"offset":7661},"end":{"line":211,"column":46,"offset":7706},"indent":[]}}],"position":{"start":{"line":211,"column":1,"offset":7661},"end":{"line":211,"column":46,"offset":7706},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"It's recommended to install FFmpeg 3.1. Later versions might give issues at compilation or run time.","position":{"start":{"line":213,"column":3,"offset":7710},"end":{"line":213,"column":103,"offset":7810},"indent":[]}}],"position":{"start":{"line":213,"column":3,"offset":7710},"end":{"line":213,"column":103,"offset":7810},"indent":[]}}],"position":{"start":{"line":213,"column":1,"offset":7708},"end":{"line":213,"column":103,"offset":7810},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"git clone https://github.com/FFmpeg/FFmpeg ffmpeg\ncd ffmpeg && git checkout remotes/origin/release/3.1\n./configure --enable-gpl --enable-libx264 --enable-shared --prefix=/usr\nmake && sudo make install","position":{"start":{"line":215,"column":1,"offset":7812},"end":{"line":220,"column":4,"offset":8022},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Go to your home directory, or any place your prefer and pull the machinery from Github. Afterwards create a build directory and start the compilation.","position":{"start":{"line":222,"column":1,"offset":8024},"end":{"line":222,"column":151,"offset":8174},"indent":[]}}],"position":{"start":{"line":222,"column":1,"offset":8024},"end":{"line":222,"column":151,"offset":8174},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"You can change the ","position":{"start":{"line":224,"column":3,"offset":8178},"end":{"line":224,"column":22,"offset":8197},"indent":[]}},{"type":"inlineCode","value":"-j","position":{"start":{"line":224,"column":22,"offset":8197},"end":{"line":224,"column":26,"offset":8201},"indent":[]}},{"type":"text","value":" attribute of ","position":{"start":{"line":224,"column":26,"offset":8201},"end":{"line":224,"column":40,"offset":8215},"indent":[]}},{"type":"inlineCode","value":"make -j8","position":{"start":{"line":224,"column":40,"offset":8215},"end":{"line":224,"column":50,"offset":8225},"indent":[]}},{"type":"text","value":"to the number of cores of your compilation host.","position":{"start":{"line":224,"column":50,"offset":8225},"end":{"line":224,"column":98,"offset":8273},"indent":[]}}],"position":{"start":{"line":224,"column":3,"offset":8178},"end":{"line":224,"column":98,"offset":8273},"indent":[]}}],"position":{"start":{"line":224,"column":1,"offset":8176},"end":{"line":224,"column":98,"offset":8273},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"cd && git clone https://github.com/kerberos-io/machinery\ncd machinery && mkdir build && cd build\ncmake .. && make -j8 && make check && sudo make install","position":{"start":{"line":226,"column":1,"offset":8275},"end":{"line":230,"column":4,"offset":8437},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"After the machinery is build and installed succesfully, you can enable ","position":{"start":{"line":232,"column":1,"offset":8439},"end":{"line":232,"column":72,"offset":8510},"indent":[]}},{"type":"inlineCode","value":"kerberosio","position":{"start":{"line":232,"column":72,"offset":8510},"end":{"line":232,"column":84,"offset":8522},"indent":[]}},{"type":"text","value":" to start on boot.","position":{"start":{"line":232,"column":84,"offset":8522},"end":{"line":232,"column":102,"offset":8540},"indent":[]}}],"position":{"start":{"line":232,"column":1,"offset":8439},"end":{"line":232,"column":102,"offset":8540},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo systemctl enable kerberosio\nsudo systemctl start kerberosio","position":{"start":{"line":234,"column":1,"offset":8542},"end":{"line":237,"column":4,"offset":8616},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Web","position":{"start":{"line":239,"column":5,"offset":8622},"end":{"line":239,"column":8,"offset":8625},"indent":[]}}],"position":{"start":{"line":239,"column":1,"offset":8618},"end":{"line":239,"column":8,"offset":8625},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to install the web, you'll need to have a webserver (e.g. Nginx) and PHP running with some extensions. You'll also need NodeJS and npm installed, to install Bower.","position":{"start":{"line":241,"column":1,"offset":8627},"end":{"line":241,"column":176,"offset":8802},"indent":[]}}],"position":{"start":{"line":241,"column":1,"offset":8627},"end":{"line":241,"column":176,"offset":8802},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"cd ~\ncurl -sL https://deb.nodesource.com/setup_10.x | sudo bash -\nsudo apt-add-repository -y ppa:ondrej/php\nsudo apt-get -y update\nsudo apt-get install -y git php7.1-cli php7.1-gd php7.1-mcrypt php7.1-curl php7.1-mbstring php7.1-dom php7.1-zip php7.1-fpm nodejs\nsudo npm -g install bower","position":{"start":{"line":243,"column":1,"offset":8804},"end":{"line":250,"column":4,"offset":9101},"indent":[1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Next we'll need to install Nginx, and create a config file.","position":{"start":{"line":252,"column":1,"offset":9103},"end":{"line":252,"column":60,"offset":9162},"indent":[]}}],"position":{"start":{"line":252,"column":1,"offset":9103},"end":{"line":252,"column":60,"offset":9162},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo apt-get -y install nginx\nsudo rm -f /etc/nginx/sites-enabled/default\nsudo nano /etc/nginx/sites-enabled/default","position":{"start":{"line":254,"column":1,"offset":9164},"end":{"line":258,"column":4,"offset":9290},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Assign Nginx to our web interface (which we will soon create).","position":{"start":{"line":260,"column":1,"offset":9292},"end":{"line":260,"column":63,"offset":9354},"indent":[]}}],"position":{"start":{"line":260,"column":1,"offset":9292},"end":{"line":260,"column":63,"offset":9354},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"server\n{\n listen 80 default_server;\n listen [::]:80 default_server;\n root /var/www/web/public;\n server_name kerberos.rpi;\n index index.php index.html index.htm;\n location /\n {\n autoindex on;\n try_files $uri $uri/ /index.php?$query_string;\n }\n location ~ \\.php$\n {\n fastcgi_pass unix:/var/run/php/php7.1-fpm.sock;\n fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;\n include fastcgi_params;\n }\n}","position":{"start":{"line":262,"column":1,"offset":9356},"end":{"line":282,"column":4,"offset":9863},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Now we have all the dependencies installed we can clone the web repository to our working station.","position":{"start":{"line":284,"column":1,"offset":9865},"end":{"line":284,"column":99,"offset":9963},"indent":[]}}],"position":{"start":{"line":284,"column":1,"offset":9865},"end":{"line":284,"column":99,"offset":9963},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"mkdir -p /var/www\ncd /var/www && sudo git clone https://github.com/kerberos-io/web && cd web","position":{"start":{"line":286,"column":1,"offset":9965},"end":{"line":289,"column":4,"offset":10067},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Install the PHP dependency manager, ","position":{"start":{"line":291,"column":1,"offset":10069},"end":{"line":291,"column":37,"offset":10105},"indent":[]}},{"type":"inlineCode","value":"composer","position":{"start":{"line":291,"column":37,"offset":10105},"end":{"line":291,"column":47,"offset":10115},"indent":[]}},{"type":"text","value":", the install all the needed dependencies.","position":{"start":{"line":291,"column":47,"offset":10115},"end":{"line":291,"column":89,"offset":10157},"indent":[]}}],"position":{"start":{"line":291,"column":1,"offset":10069},"end":{"line":291,"column":89,"offset":10157},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"curl -sS https://getcomposer.org/installer | sudo php\nsudo mv composer.phar /usr/bin/composer\nsudo composer install","position":{"start":{"line":293,"column":1,"offset":10159},"end":{"line":297,"column":4,"offset":10284},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Change some permissions, to make sure we can write logging and caching files.","position":{"start":{"line":299,"column":1,"offset":10286},"end":{"line":299,"column":78,"offset":10363},"indent":[]}}],"position":{"start":{"line":299,"column":1,"offset":10286},"end":{"line":299,"column":78,"offset":10363},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"sudo chmod -R 777 storage\nsudo chmod -R 777 bootstrap/cache\nsudo chmod 777 config/kerberos.php","position":{"start":{"line":301,"column":1,"offset":10365},"end":{"line":305,"column":4,"offset":10469},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"We will need to install a couple of more JavaScript libraries using bower.","position":{"start":{"line":307,"column":1,"offset":10471},"end":{"line":307,"column":75,"offset":10545},"indent":[]}}],"position":{"start":{"line":307,"column":1,"offset":10471},"end":{"line":307,"column":75,"offset":10545},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"cd public\nsudo bower --allow-root install\nservice nginx restart","position":{"start":{"line":309,"column":1,"offset":10547},"end":{"line":313,"column":4,"offset":10620},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is setup correctly, you should be able to browse towards the ip-address of your Raspberry Pi and see the Kerberos web interface.","position":{"start":{"line":315,"column":1,"offset":10622},"end":{"line":315,"column":145,"offset":10766},"indent":[]}}],"position":{"start":{"line":315,"column":1,"offset":10622},"end":{"line":315,"column":145,"offset":10766},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Auto removal","position":{"start":{"line":317,"column":5,"offset":10772},"end":{"line":317,"column":17,"offset":10784},"indent":[]}}],"position":{"start":{"line":317,"column":1,"offset":10768},"end":{"line":317,"column":17,"offset":10784},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By default images or videos aren't removed automatically. This means that the Kerberos agent will keep writing to disk, even if there is no more space available on your SD card. When your SD card is full you'll be experiencing strange errors: a corrupt web interface, blank images or corrupt videos.","position":{"start":{"line":319,"column":1,"offset":10786},"end":{"line":319,"column":300,"offset":11085},"indent":[]}}],"position":{"start":{"line":319,"column":1,"offset":10786},"end":{"line":319,"column":300,"offset":11085},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To resolve this your should install a simple bash script and initiate a cronjob which continuously poll your filesystem, and start removing media when your disk is getting full.","position":{"start":{"line":321,"column":1,"offset":11087},"end":{"line":321,"column":178,"offset":11264},"indent":[]}}],"position":{"start":{"line":321,"column":1,"offset":11087},"end":{"line":321,"column":178,"offset":11264},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Create a bash script and copy following script.","position":{"start":{"line":323,"column":1,"offset":11266},"end":{"line":323,"column":48,"offset":11313},"indent":[]}}],"position":{"start":{"line":323,"column":1,"offset":11266},"end":{"line":323,"column":48,"offset":11313},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"nano /home/[user]/autoremoval.sh","position":{"start":{"line":325,"column":1,"offset":11315},"end":{"line":327,"column":4,"offset":11359},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Copy following script (make sure the partition is correct, this is the default one for a Raspberry Pi).","position":{"start":{"line":329,"column":1,"offset":11361},"end":{"line":329,"column":104,"offset":11464},"indent":[]}}],"position":{"start":{"line":329,"column":1,"offset":11361},"end":{"line":329,"column":104,"offset":11464},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"partition=/dev/root\nimagedir=/etc/opt/kerberosio/capture/\nif [[ $(df -h | grep $partition | head -1 | awk -F' ' '{ print $5/1 }' | tr ['%'] [\"0\"]) -gt 90 ]];\nthen\n echo \"Cleaning disk\"\n find $imagedir -type f | sort | head -n 100 | xargs -r rm -rf;\nfi;","position":{"start":{"line":331,"column":1,"offset":11466},"end":{"line":339,"column":4,"offset":11736},"indent":[1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Make the script executable.","position":{"start":{"line":341,"column":1,"offset":11738},"end":{"line":341,"column":28,"offset":11765},"indent":[]}}],"position":{"start":{"line":341,"column":1,"offset":11738},"end":{"line":341,"column":28,"offset":11765},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"chmod +x /home/[user]/autoremoval.sh","position":{"start":{"line":343,"column":1,"offset":11767},"end":{"line":345,"column":4,"offset":11815},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Initiate a cronjob, and select the nano editor.","position":{"start":{"line":347,"column":1,"offset":11817},"end":{"line":347,"column":48,"offset":11864},"indent":[]}}],"position":{"start":{"line":347,"column":1,"offset":11817},"end":{"line":347,"column":48,"offset":11864},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"crontab -e","position":{"start":{"line":349,"column":1,"offset":11866},"end":{"line":351,"column":4,"offset":11888},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Append following line, to execute the autoremoval.sh script every 5min.","position":{"start":{"line":353,"column":1,"offset":11890},"end":{"line":353,"column":72,"offset":11961},"indent":[]}}],"position":{"start":{"line":353,"column":1,"offset":11890},"end":{"line":353,"column":72,"offset":11961},"indent":[]}},{"type":"code","lang":"bash","meta":null,"value":"*/5 * * * * /bin/bash /home/[user]/autoremoval.sh","position":{"start":{"line":355,"column":1,"offset":11963},"end":{"line":357,"column":4,"offset":12024},"indent":[1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":360,"column":1,"offset":12027},"end":{"line":360,"column":31,"offset":12057},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":360,"column":31,"offset":12057}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Installation`}

\n

{`Kerberos Open Source comes with different installation flavours. So you might think, why? The reason is simple, depending on the use case one option is better than another. A short list of recommendations:`}

\n

{`Plug and play`}

\n
    \n
  1. {`KiOS`}{`: You have a Raspberry Pi, and you only want to run a Kerberos agent on it.`}
    2. \n
  2. {`Docker`}{`: You have a lot of IP cameras, and/or don't want to mess with dependencies.`}
    3. \n
  3. {`Balena`}{`: Runnning the Kerberos Docker container on top of Balena.`}
    4. \n
\n

{`Advanced`}

\n
    \n
  1. {`Raspbian`}{`: You have a Raspberry Pi, but you want other services running next to the Kerberos agent.`}
    2. \n
  2. {`Generic`}{`: You want to develop/extend Kerberos with your own features, or you want to run a Kerberos agent on a not supported OS/architecure.`}
    3. \n
\n
\n

{`Advanced`}

\n

{`Following installation methods are only for advanced users, who need to have more control over the Kerberos Open Source environment.`}

\n

{`Raspbian`}

\n

{`If you have already an OS (e.g. Raspbian Buster) flashed to your Raspberry Pi, then it makes sense to install the Kerberos agent on top of your existing OS. There are two ways to achieve this:`}

\n
    \n
  1. {`Install the Kerberos agent using Docker (more info below),`}
    2. \n
  2. {`or you can install the Kerberos agent manually (machinery + web).`}
    3. \n
\n

{`This section will focus on option 2, and will show you how to install the Kerberos agent manually.`}

\n

{`Update OS`}

\n

{`Let's start with updating the OS, and installing a couple of packages.`}

\n
\n

{`We have tested the Raspbian installation on `}{`Raspbian GNU/Linux 10 (buster)`}{`. It might be that if you have a different version of Raspbian, you will need to install additional/different packages.`}

\n
\n 
{`sudo`}{` `}{`apt`}{`-`}{`get`}{` `}{`update`}{` && `}{`sudo`}{` `}{`apt`}{`-`}{`get`}{` `}{`install`}{` -`}{`y`}{` `}{`ffmpeg`}
\n

{`Machinery`}

\n

{`Download the debian file from the machinery repository.`}

\n
\n

{`https://github.com/kerberos-io/machinery/releases`}

\n
\n

{`A `}{`.deb`}{` file is available for every version of the Raspberry Pi. For example if you are using a Raspberry Pi 4 for version 2.8.0, execute following command. You can change the version and Raspberry Pi board to your needs.`}

\n
\n

{`Please make sure you pick the right board (rpi, rpi2, rpi3 or rpi4), and choose the version you want (e.g. 2.8.0). Replace below url, with your preferences.`}

\n
\n 
{`wget`}{` https:`}{`//github.com/kerberos-io/machinery/releases/download/v2.8.0/rpi4-machinery-kerberosio-armhf-2.8.0.deb`}{`\n`}{`sudo`}{` `}{`dpkg`}{` -`}{`i`}{` `}{`rpi4`}{`-`}{`machinery`}{`-`}{`kerberosio`}{`-`}{`armhf`}{`-`}{`2.8`}{`.0.`}{`deb`}
\n

{`Download the x265 library (version 160) from the machinery repository, as Raspbian Buster 10 only ships with version 165. Make sure you select the right board.`}

\n
\n

{`v2.8.0/rpi4-libx265.so.160`}{` this will download the libx265 shared library for the Raspberry Pi 4.`}

\n
\n 
{`wget`}{` https:`}{`//github.com/kerberos-io/machinery/releases/download/v2.8.0/rpi4-libx265.so.160`}{`\n`}{`sudo`}{` `}{`mv`}{` `}{`rpi4`}{`-`}{`libx265`}{`.`}{`so`}{`.`}{`160`}{` /`}{`usr`}{`/`}{`lib`}{`/`}{`arm`}{`-`}{`linux`}{`-`}{`gnueabihf`}{`/`}{`libx265`}{`.`}{`so`}{`.`}{`160`}
\n

{`Same applies for the libx264 library, download the right shared library.`}

\n
\n

{`v2.8.0/rpi4-libx264.so.148`}{` this will download the libx264 shared library for the Raspberry Pi 4.`}

\n
\n 
{`wget`}{` https:`}{`//github.com/kerberos-io/machinery/releases/download/v2.8.0/rpi4-libx264.so.148`}{`\n`}{`sudo`}{` `}{`mv`}{` `}{`rpi4`}{`-`}{`libx264`}{`.`}{`so`}{`.`}{`148`}{` /`}{`usr`}{`/`}{`lib`}{`/`}{`arm`}{`-`}{`linux`}{`-`}{`gnueabihf`}{`/`}{`libx264`}{`.`}{`so`}{`.`}{`148`}
\n

{`If you wish to use the Raspberry Pi Camera Module, make sure `}{`to enable it`}{` using `}{`sudo raspi-config`}{`.`}

\n 
{`sudo`}{` `}{`raspi`}{`-`}{`config`}
\n

{`Enable machinery to start on boot, and start the service.`}

\n 
{`sudo systemctl enable kerberosio`}{`\n`}{`sudo service kerberosio start`}
\n

{`Web`}

\n

{`Before you can run the web interface, you'll need to download and configure a webserver. We recommend to use Nginx, as it is a light-weight and fast webserver. The web interface is written in PHP, so we also need to download PHP and some packages. Update the packages and kernel.`}

\n

{`Install Nginx and PHP (+extensions).`}

\n 
{`sudo`}{` `}{`apt`}{`-`}{`get`}{` `}{`install`}{` -`}{`y`}{` `}{`nginx`}{` `}{`php7`}{`.`}{`1`}{` `}{`php7`}{`.`}{`1`}{`-`}{`curl`}{` `}{`php7`}{`.`}{`1`}{`-`}{`gd`}{` `}{`php7`}{`.`}{`1`}{`-`}{`fpm`}{` `}{`php7`}{`.`}{`1`}{`-`}{`cli`}{` `}{`php7`}{`.`}{`1`}{`-`}{`opcache`}{` `}{`php7`}{`.`}{`1`}{`-`}{`mbstring`}{` `}{`php7`}{`.`}{`1`}{`-`}{`xml`}{` `}{`php7`}{`.`}{`1`}{`-`}{`zip`}{` `}{`php7`}{`.`}{`1`}{`-`}{`mcrypt`}{` `}{`php7`}{`.`}{`1`}{`-`}{`readline`}
\n

{`Creating a Nginx config.`}

\n 
{`sudo`}{` `}{`rm`}{` -`}{`f`}{` /`}{`etc`}{`/`}{`nginx`}{`/`}{`sites`}{`-`}{`enabled`}{`/`}{`default`}{`\n`}{`sudo`}{` `}{`nano`}{` /`}{`etc`}{`/`}{`nginx`}{`/`}{`sites`}{`-`}{`enabled`}{`/`}{`kerberosio`}{`.`}{`conf`}
\n

{`Copy and paste following config file; this file tells nginx where the web will be installed and that it requires PHP.`}

\n 
{`server`}{`\n`}{`{`}{`\n`}{`    `}{`listen`}{` `}{`80`}{` `}{`default_server`}{`;`}{`\n`}{`    `}{`listen`}{` [::]:`}{`80`}{` `}{`default_server`}{`;`}{`\n`}{`    `}{`root`}{` /`}{`var`}{`/`}{`www`}{`/web/public;`}{`\n`}{`    `}{`server_name`}{` `}{`kerberos`}{`.`}{`rpi`}{`;`}{`\n`}{`    `}{`index`}{` `}{`index`}{`.`}{`php`}{` `}{`index`}{`.`}{`html`}{` `}{`index`}{`.`}{`htm`}{`;`}{`\n`}{`    `}{`location`}{` /`}{`\n`}{`    {`}{`\n`}{`            `}{`autoindex`}{` `}{`on`}{`;`}{`\n`}{`            `}{`try_files`}{` `}{`$uri`}{` `}{`$uri`}{`/ /`}{`index`}{`.`}{`php`}{`?`}{`$query_string`}{`;`}{`\n`}{`    }`}{`\n`}{`    `}{`location`}{` ~ \\\\.`}{`php$`}{`\n`}{`    {`}{`\n`}{`            fastcgi_pass `}{`unix:`}{`/`}{`var`}{`/`}{`run`}{`/`}{`php`}{`/`}{`php7`}{`.`}{`1`}{`-`}{`fpm`}{`.`}{`sock`}{`;`}{`\n`}{`            `}{`fastcgi_param`}{` `}{`SCRIPT_FILENAME`}{` `}{`$document_root$fastcgi_script_name`}{`;`}{`\n`}{`            `}{`include`}{` `}{`fastcgi_params`}{`;`}{`\n`}{`    }`}{`\n`}{`}`}
\n

{`Restart nginx`}

\n 
{`sudo`}{` `}{`service`}{` `}{`nginx`}{` `}{`restart`}
\n

{`Now we have installed all the dependencies, we can download the web interface source code.`}

\n 
{`sudo`}{` `}{`mkdir`}{` -`}{`p`}{` /`}{`var`}{`/`}{`www`}{`/web && sudo chown www-data:`}{`www`}{`-`}{`data`}{` /`}{`var`}{`/`}{`www`}{`/`}{`web`}{`\n`}{`cd`}{` /`}{`var`}{`/`}{`www`}{`/web`}{`\n`}{`sudo`}{` -`}{`u`}{` `}{`www`}{`-`}{`data`}{` `}{`wget`}{` https:`}{`//github.com/kerberos-io/web/releases/download/v2.8.0/web.tar.gz`}{`\n`}{`sudo`}{` -`}{`u`}{` `}{`www`}{`-`}{`data`}{` `}{`tar`}{` `}{`xvf`}{` `}{`web`}{`.`}{`tar`}{`.`}{`gz`}{` .`}{`\n`}{`sudo`}{` `}{`chown`}{` `}{`www`}{`-`}{`data`}{` -`}{`R`}{` `}{`storage`}{` `}{`bootstrap`}{`/`}{`cache`}{` `}{`config`}{`/`}{`kerberos`}{`.`}{`php`}{`\n`}{`sudo`}{` `}{`chmod`}{` -`}{`R`}{` `}{`775`}{` `}{`storage`}{` `}{`bootstrap`}{`/`}{`cache`}{`\n`}{`sudo`}{` `}{`chmod`}{` `}{`0600`}{` `}{`config`}{`/`}{`kerberos`}{`.`}{`php`}
\n

{`Once everything is setup correctly, you should be able to browse towards the ip-address of your Raspberry Pi and see the Kerberos web interface.`}

\n

{`Auto removal`}

\n

{`By default images or videos aren't removed automatically. This means that the Kerberos agent will keep writing to disk, even if there is no more space available on your SD card. When your SD card is full you'll be experiencing strange errors: a corrupt web interface, blank images or corrupt videos.`}

\n

{`To resolve this your should install a simple bash script and initiate a cronjob which continuously poll your filesystem, and start removing media when your disk is getting full.`}

\n

{`Create a bash script and copy following script.`}

\n 
{`nano /home/pi/autoremoval.sh`}
\n

{`Copy following script (make sure the partition is correct, this is the default one for a Raspberry Pi).`}

\n 
{`partition=/dev/root`}{`\n`}{`imagedir=/etc/opt/kerberosio/capture/`}{`\n`}{`if`}{` [[ `}{`$(df -h `}{`|`}{` grep `}{`$partition`}{` `}{`|`}{` head -1 `}{`|`}{` awk -F' ' '{ print $5/1 }' `}{`|`}{` tr ['%'] [\"0\"])`}{` -gt 90 ]];`}{`\n`}{`then`}{`\n`}{`    `}{`echo`}{` `}{`\"Cleaning disk\"`}{`\n`}{`    find `}{`$imagedir`}{` -type f | sort | head -n 100 | xargs -r rm -rf;`}{`\n`}{`fi`}{`;`}
\n

{`Make the script executable.`}

\n 
{`chmod +x /home/pi/autoremoval.sh`}
\n

{`Initiate a cronjob, and select the nano editor.`}

\n 
{`crontab -e`}
\n

{`Append following line, to execute the autoremoval.sh script every 5min.`}

\n 
{`*/5 * * * * /bin/bash /home/pi/autoremoval.sh`}
\n

{`Generic`}

\n

{`If you want to install the Kerberos agent from source on your working station or server, either for development or running the software, this is the preferred installation procedure. We are assuming that you use a Linux OS, when using Mac OSX the installation is slightly different.`}

\n
\n

{`This was tested on a Ubuntu VM (18.04.3 (LTS) x64).`}

\n
\n

{`Machinery`}

\n

{`Update the packages and kernel, and install some development tools.`}

\n 
{`sudo`}{` `}{`apt`}{`-`}{`get`}{` -`}{`y`}{` `}{`update`}{`\n`}{`sudo`}{` `}{`apt`}{`-`}{`get`}{` `}{`install`}{` -`}{`y`}{` `}{`git`}{` `}{`cmake`}{` `}{`subversion`}{` `}{`dh`}{`-`}{`autoreconf`}{` `}{`libcurl4`}{`-`}{`openssl`}{`-`}{`dev`}{` `}{`yasm`}{` `}{`libx264`}{`-`}{`dev`}{` `}{`pkg`}{`-`}{`config`}{` `}{`libssl`}{`-`}{`dev`}
\n

{`Install the FFmpeg library with x264 support.`}

\n
\n

{`It's recommended to install FFmpeg 3.1. Later versions might give issues at compilation or run time.`}

\n
\n 
{`git`}{` `}{`clone`}{` https:`}{`//github.com/FFmpeg/FFmpeg ffmpeg`}{`\n`}{`cd`}{` `}{`ffmpeg`}{` && `}{`git`}{` `}{`checkout`}{` `}{`remotes`}{`/`}{`origin`}{`/`}{`release`}{`/`}{`3.1`}{`\n`}{`./`}{`configure`}{` --`}{`enable`}{`-`}{`gpl`}{` --`}{`enable`}{`-`}{`libx264`}{` --`}{`enable`}{`-`}{`shared`}{` --`}{`prefix`}{`=/`}{`usr`}{`\n`}{`make`}{` && `}{`sudo`}{` `}{`make`}{` `}{`install`}
\n

{`Go to your home directory, or any place your prefer and pull the machinery from Github. Afterwards create a build directory and start the compilation.`}

\n
\n

{`You can change the `}{`-j`}{` attribute of `}{`make -j8`}{`to the number of cores of your compilation host.`}

\n
\n 
{`cd`}{` && `}{`git`}{` `}{`clone`}{` https:`}{`//github.com/kerberos-io/machinery`}{`\n`}{`cd`}{` `}{`machinery`}{` && `}{`mkdir`}{` `}{`build`}{` && `}{`cd`}{` `}{`build`}{`\n`}{`cmake`}{` .. && `}{`make`}{` -`}{`j8`}{` && `}{`make`}{` `}{`check`}{` && `}{`sudo`}{` `}{`make`}{` `}{`install`}
\n

{`After the machinery is build and installed succesfully, you can enable `}{`kerberosio`}{` to start on boot.`}

\n 
{`sudo`}{` `}{`systemctl`}{` `}{`enable`}{` `}{`kerberosio`}{`\n`}{`sudo`}{` `}{`systemctl`}{` `}{`start`}{` `}{`kerberosio`}
\n

{`Web`}

\n

{`If you want to install the web, you'll need to have a webserver (e.g. Nginx) and PHP running with some extensions. You'll also need NodeJS and npm installed, to install Bower.`}

\n 
{`cd`}{` ~`}{`\n`}{`curl`}{` -`}{`sL`}{` https:`}{`//deb.nodesource.com/setup_10.x | sudo bash -`}{`\n`}{`sudo`}{` `}{`apt`}{`-`}{`add`}{`-`}{`repository`}{` -`}{`y`}{` ppa:`}{`ondrej`}{`/`}{`php`}{`\n`}{`sudo`}{` `}{`apt`}{`-`}{`get`}{` -`}{`y`}{` `}{`update`}{`\n`}{`sudo`}{` `}{`apt`}{`-`}{`get`}{` `}{`install`}{` -`}{`y`}{` `}{`git`}{` `}{`php7`}{`.`}{`1`}{`-`}{`cli`}{` `}{`php7`}{`.`}{`1`}{`-`}{`gd`}{` `}{`php7`}{`.`}{`1`}{`-`}{`mcrypt`}{` `}{`php7`}{`.`}{`1`}{`-`}{`curl`}{` `}{`php7`}{`.`}{`1`}{`-`}{`mbstring`}{` `}{`php7`}{`.`}{`1`}{`-`}{`dom`}{` `}{`php7`}{`.`}{`1`}{`-`}{`zip`}{` `}{`php7`}{`.`}{`1`}{`-`}{`fpm`}{` `}{`nodejs`}{`\n`}{`sudo`}{` `}{`npm`}{` -`}{`g`}{` `}{`install`}{` `}{`bower`}
\n

{`Next we'll need to install Nginx, and create a config file.`}

\n 
{`sudo`}{` `}{`apt`}{`-`}{`get`}{` -`}{`y`}{` `}{`install`}{` `}{`nginx`}{`\n`}{`sudo`}{` `}{`rm`}{` -`}{`f`}{` /`}{`etc`}{`/`}{`nginx`}{`/`}{`sites`}{`-`}{`enabled`}{`/`}{`default`}{`\n`}{`sudo`}{` `}{`nano`}{` /`}{`etc`}{`/`}{`nginx`}{`/`}{`sites`}{`-`}{`enabled`}{`/`}{`default`}
\n

{`Assign Nginx to our web interface (which we will soon create).`}

\n 
{`server`}{`\n`}{`{`}{`\n`}{`    `}{`listen`}{` `}{`80`}{` `}{`default_server`}{`;`}{`\n`}{`    `}{`listen`}{` [::]:`}{`80`}{` `}{`default_server`}{`;`}{`\n`}{`    `}{`root`}{` /`}{`var`}{`/`}{`www`}{`/web/public;`}{`\n`}{`    `}{`server_name`}{` `}{`kerberos`}{`.`}{`rpi`}{`;`}{`\n`}{`    `}{`index`}{` `}{`index`}{`.`}{`php`}{` `}{`index`}{`.`}{`html`}{` `}{`index`}{`.`}{`htm`}{`;`}{`\n`}{`    `}{`location`}{` /`}{`\n`}{`    {`}{`\n`}{`            `}{`autoindex`}{` `}{`on`}{`;`}{`\n`}{`            `}{`try_files`}{` `}{`$uri`}{` `}{`$uri`}{`/ /`}{`index`}{`.`}{`php`}{`?`}{`$query_string`}{`;`}{`\n`}{`    }`}{`\n`}{`    `}{`location`}{` ~ \\\\.`}{`php$`}{`\n`}{`    {`}{`\n`}{`            fastcgi_pass `}{`unix:`}{`/`}{`var`}{`/`}{`run`}{`/`}{`php`}{`/`}{`php7`}{`.`}{`1`}{`-`}{`fpm`}{`.`}{`sock`}{`;`}{`\n`}{`            `}{`fastcgi_param`}{` `}{`SCRIPT_FILENAME`}{` `}{`$document_root$fastcgi_script_name`}{`;`}{`\n`}{`            `}{`include`}{` `}{`fastcgi_params`}{`;`}{`\n`}{`    }`}{`\n`}{`}`}
\n

{`Now we have all the dependencies installed we can clone the web repository to our working station.`}

\n 
{`mkdir`}{` -`}{`p`}{` /`}{`var`}{`/`}{`www`}{`\n`}{`cd`}{` /`}{`var`}{`/`}{`www`}{` && sudo git clone https:`}{`//github.com/kerberos-io/web && cd web`}
\n

{`Install the PHP dependency manager, `}{`composer`}{`, the install all the needed dependencies.`}

\n 
{`curl`}{` -`}{`sS`}{` https:`}{`//getcomposer.org/installer | sudo php`}{`\n`}{`sudo`}{` `}{`mv`}{` `}{`composer`}{`.`}{`phar`}{` /`}{`usr`}{`/`}{`bin`}{`/`}{`composer`}{`\n`}{`sudo`}{` `}{`composer`}{` `}{`install`}
\n

{`Change some permissions, to make sure we can write logging and caching files.`}

\n 
{`sudo`}{` `}{`chmod`}{` -`}{`R`}{` `}{`777`}{` `}{`storage`}{`\n`}{`sudo`}{` `}{`chmod`}{` -`}{`R`}{` `}{`777`}{` `}{`bootstrap`}{`/`}{`cache`}{`\n`}{`sudo`}{` `}{`chmod`}{` `}{`777`}{` `}{`config`}{`/`}{`kerberos`}{`.`}{`php`}
\n

{`We will need to install a couple of more JavaScript libraries using bower.`}

\n 
{`cd`}{` `}{`public`}{`\n`}{`sudo`}{` `}{`bower`}{` --`}{`allow`}{`-`}{`root`}{` `}{`install`}{`\n`}{`service`}{` `}{`nginx`}{` `}{`restart`}
\n

{`Once everything is setup correctly, you should be able to browse towards the ip-address of your Raspberry Pi and see the Kerberos web interface.`}

\n

{`Auto removal`}

\n

{`By default images or videos aren't removed automatically. This means that the Kerberos agent will keep writing to disk, even if there is no more space available on your SD card. When your SD card is full you'll be experiencing strange errors: a corrupt web interface, blank images or corrupt videos.`}

\n

{`To resolve this your should install a simple bash script and initiate a cronjob which continuously poll your filesystem, and start removing media when your disk is getting full.`}

\n

{`Create a bash script and copy following script.`}

\n 
{`nano /home/[user]/autoremoval.sh`}
\n

{`Copy following script (make sure the partition is correct, this is the default one for a Raspberry Pi).`}

\n 
{`partition=/dev/root`}{`\n`}{`imagedir=/etc/opt/kerberosio/capture/`}{`\n`}{`if`}{` [[ `}{`$(df -h `}{`|`}{` grep `}{`$partition`}{` `}{`|`}{` head -1 `}{`|`}{` awk -F' ' '{ print $5/1 }' `}{`|`}{` tr ['%'] [\"0\"])`}{` -gt 90 ]];`}{`\n`}{`then`}{`\n`}{`    `}{`echo`}{` `}{`\"Cleaning disk\"`}{`\n`}{`    find `}{`$imagedir`}{` -type f | sort | head -n 100 | xargs -r rm -rf;`}{`\n`}{`fi`}{`;`}
\n

{`Make the script executable.`}

\n 
{`chmod +x /home/[user]/autoremoval.sh`}
\n

{`Initiate a cronjob, and select the nano editor.`}

\n 
{`crontab -e`}
\n

{`Append following line, to execute the autoremoval.sh script every 5min.`}

\n 
{`*/5 * * * * /bin/bash /home/[user]/autoremoval.sh`}
\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-939d53c56f398d774b12365de415ce29.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-939d53c56f398d774b12365de415ce29.json index 7c2f4d0..b74d117 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-939d53c56f398d774b12365de415ce29.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-939d53c56f398d774b12365de415ce29.json @@ -1 +1 @@ -{"expireTime":9007200861747672000,"key":"gatsby-plugin-mdx-entire-payload-3f46f8be7d96a570b06cff8183b407d1-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Get Started","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":14,"offset":172},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":14,"offset":172},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed Kerberos Open Source, you will have access to the web application. This web application allows you to administrate the machinery.","position":{"start":{"line":10,"column":1,"offset":174},"end":{"line":10,"column":152,"offset":325},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":174},"end":{"line":10,"column":152,"offset":325},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Welcome page","position":{"start":{"line":12,"column":4,"offset":330},"end":{"line":12,"column":16,"offset":342},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":327},"end":{"line":12,"column":16,"offset":342},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The first time you open a browser, and navigate to the web application (ip address of your device), you will land on the welcome page. This page will guide you through some basic steps and set simple configurations such as username and password.","position":{"start":{"line":14,"column":1,"offset":344},"end":{"line":14,"column":246,"offset":589},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":344},"end":{"line":14,"column":246,"offset":589},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-welcome.png","alt":"OpenSource","position":{"start":{"line":16,"column":1,"offset":591},"end":{"line":16,"column":78,"offset":668},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":591},"end":{"line":16,"column":78,"offset":668},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Login page","position":{"start":{"line":18,"column":4,"offset":673},"end":{"line":18,"column":14,"offset":683},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":670},"end":{"line":18,"column":14,"offset":683},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When you've finished the welcome page, you will be redirected to the login page from now one. Use the credentials you have defined during the configuration of the welcome page. By default the username is ","position":{"start":{"line":20,"column":1,"offset":685},"end":{"line":20,"column":205,"offset":889},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":20,"column":207,"offset":891},"end":{"line":20,"column":211,"offset":895},"indent":[]}}],"position":{"start":{"line":20,"column":205,"offset":889},"end":{"line":20,"column":213,"offset":897},"indent":[]}},{"type":"text","value":", and the password is ","position":{"start":{"line":20,"column":213,"offset":897},"end":{"line":20,"column":235,"offset":919},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":20,"column":237,"offset":921},"end":{"line":20,"column":241,"offset":925},"indent":[]}}],"position":{"start":{"line":20,"column":235,"offset":919},"end":{"line":20,"column":243,"offset":927},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":20,"column":243,"offset":927},"end":{"line":20,"column":244,"offset":928},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":685},"end":{"line":20,"column":244,"offset":928},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-login.png","alt":"OpenSource","position":{"start":{"line":22,"column":1,"offset":930},"end":{"line":22,"column":76,"offset":1005},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":930},"end":{"line":22,"column":76,"offset":1005},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Dashboard","position":{"start":{"line":24,"column":4,"offset":1010},"end":{"line":24,"column":13,"offset":1019},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1007},"end":{"line":24,"column":13,"offset":1019},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After you have signed in successfully, you will land on the dashboard page. This page will give you an overview of some simple statistics. Such as the the activity per day, per hour, etc.","position":{"start":{"line":26,"column":1,"offset":1021},"end":{"line":26,"column":188,"offset":1208},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1021},"end":{"line":26,"column":188,"offset":1208},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-dashboard.png","alt":"OpenSource","position":{"start":{"line":28,"column":1,"offset":1210},"end":{"line":28,"column":80,"offset":1289},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1210},"end":{"line":28,"column":80,"offset":1289},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Media","position":{"start":{"line":30,"column":4,"offset":1294},"end":{"line":30,"column":9,"offset":1299},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1291},"end":{"line":30,"column":9,"offset":1299},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By selecting a specific day from the left navigation, or choosing the date picker on the top, you will be shown all the relevant media for that specific day. Both videos and images are listed and grouped (if they are within a specific time span). By scrolling down, more media items will be shown.","position":{"start":{"line":32,"column":1,"offset":1301},"end":{"line":32,"column":298,"offset":1598},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1301},"end":{"line":32,"column":298,"offset":1598},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can use the timeslider at the top of the page for browsing through the day. The white (no activity) to gray (low activity) to red (high activity), will give you an indications of the amount of recordings for that specific hour.","position":{"start":{"line":34,"column":1,"offset":1600},"end":{"line":34,"column":232,"offset":1831},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":1600},"end":{"line":34,"column":232,"offset":1831},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-media.png","alt":"OpenSource","position":{"start":{"line":36,"column":1,"offset":1833},"end":{"line":36,"column":76,"offset":1908},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":1833},"end":{"line":36,"column":76,"offset":1908},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-media-detail.png","alt":"OpenSource","position":{"start":{"line":38,"column":1,"offset":1910},"end":{"line":38,"column":83,"offset":1992},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1910},"end":{"line":38,"column":83,"offset":1992},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Settings","position":{"start":{"line":41,"column":4,"offset":1998},"end":{"line":41,"column":12,"offset":2006},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":1995},"end":{"line":41,"column":12,"offset":2006},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before being able to record anything, you will need to specify your capture device. A capture device is what we call: a camera. This camera can be a USB, RPi or IP camera. By default the RPi camera is selected, so if you are planning to use a IP camera make sure to change it on the settings page.","position":{"start":{"line":43,"column":1,"offset":2008},"end":{"line":43,"column":298,"offset":2305},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2008},"end":{"line":43,"column":298,"offset":2305},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-settings.png","alt":"OpenSource","position":{"start":{"line":45,"column":1,"offset":2307},"end":{"line":45,"column":79,"offset":2385},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2307},"end":{"line":45,"column":79,"offset":2385},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Region of interest","position":{"start":{"line":47,"column":5,"offset":2391},"end":{"line":47,"column":23,"offset":2409},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2387},"end":{"line":47,"column":23,"offset":2409},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Besides selecting the capture device, you will have different options to make the detection more intelligent, such as defining a regions of interest, or an activation timeline (when Kerberos Open Source should be active).","position":{"start":{"line":49,"column":1,"offset":2411},"end":{"line":49,"column":222,"offset":2632},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":2411},"end":{"line":49,"column":222,"offset":2632},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-motion.png","alt":"OpenSource","position":{"start":{"line":51,"column":1,"offset":2634},"end":{"line":51,"column":77,"offset":2710},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2634},"end":{"line":51,"column":77,"offset":2710},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Storage","position":{"start":{"line":53,"column":5,"offset":2716},"end":{"line":53,"column":12,"offset":2723},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2712},"end":{"line":53,"column":12,"offset":2723},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Storing your recordings on your device is fine, on the other hand you might want to make it available remotely. By giving your ","position":{"start":{"line":55,"column":1,"offset":2725},"end":{"line":55,"column":128,"offset":2852},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":55,"column":129,"offset":2853},"end":{"line":55,"column":143,"offset":2867},"indent":[]}}],"position":{"start":{"line":55,"column":128,"offset":2852},"end":{"line":55,"column":152,"offset":2876},"indent":[]}},{"type":"text","value":" credentials in the storage section, your recordings will be synced to our cloud solution.","position":{"start":{"line":55,"column":152,"offset":2876},"end":{"line":55,"column":242,"offset":2966},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2725},"end":{"line":55,"column":242,"offset":2966},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-cloud.png","alt":"OpenSource","position":{"start":{"line":57,"column":1,"offset":2968},"end":{"line":57,"column":76,"offset":3043},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2968},"end":{"line":57,"column":76,"offset":3043},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"System","position":{"start":{"line":59,"column":4,"offset":3048},"end":{"line":59,"column":10,"offset":3054},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":3045},"end":{"line":59,"column":10,"offset":3054},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This page will gave you overall information of Kerberos Open Source. It will give you information (logging) about the system, shows you some system information, the number of recordings on the system and more.","position":{"start":{"line":61,"column":1,"offset":3056},"end":{"line":61,"column":210,"offset":3265},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3056},"end":{"line":61,"column":210,"offset":3265},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-system.png","alt":"OpenSource","position":{"start":{"line":63,"column":1,"offset":3267},"end":{"line":63,"column":77,"offset":3343},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3267},"end":{"line":63,"column":77,"offset":3343},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":66,"column":1,"offset":3346},"end":{"line":66,"column":31,"offset":3376},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":66,"column":31,"offset":3376}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Get Started`}

\n

{`Once you've installed Kerberos Open Source, you will have access to the web application. This web application allows you to administrate the machinery.`}

\n

{`Welcome page`}

\n

{`The first time you open a browser, and navigate to the web application (ip address of your device), you will land on the welcome page. This page will guide you through some basic steps and set simple configurations such as username and password.`}

\n

\"OpenSource\"

\n

{`Login page`}

\n

{`When you've finished the welcome page, you will be redirected to the login page from now one. Use the credentials you have defined during the configuration of the welcome page. By default the username is `}{`root`}{`, and the password is `}{`root`}{`.`}

\n

\"OpenSource\"

\n

{`Dashboard`}

\n

{`After you have signed in successfully, you will land on the dashboard page. This page will give you an overview of some simple statistics. Such as the the activity per day, per hour, etc.`}

\n

\"OpenSource\"

\n

{`Media`}

\n

{`By selecting a specific day from the left navigation, or choosing the date picker on the top, you will be shown all the relevant media for that specific day. Both videos and images are listed and grouped (if they are within a specific time span). By scrolling down, more media items will be shown.`}

\n

{`You can use the timeslider at the top of the page for browsing through the day. The white (no activity) to gray (low activity) to red (high activity), will give you an indications of the amount of recordings for that specific hour.`}

\n

\"OpenSource\"

\n

\"OpenSource\"

\n

{`Settings`}

\n

{`Before being able to record anything, you will need to specify your capture device. A capture device is what we call: a camera. This camera can be a USB, RPi or IP camera. By default the RPi camera is selected, so if you are planning to use a IP camera make sure to change it on the settings page.`}

\n

\"OpenSource\"

\n

{`Region of interest`}

\n

{`Besides selecting the capture device, you will have different options to make the detection more intelligent, such as defining a regions of interest, or an activation timeline (when Kerberos Open Source should be active).`}

\n

\"OpenSource\"

\n

{`Storage`}

\n

{`Storing your recordings on your device is fine, on the other hand you might want to make it available remotely. By giving your `}{`Kerberos Cloud`}{` credentials in the storage section, your recordings will be synced to our cloud solution.`}

\n

\"OpenSource\"

\n

{`System`}

\n

{`This page will gave you overall information of Kerberos Open Source. It will give you information (logging) about the system, shows you some system information, the number of recordings on the system and more.`}

\n

\"OpenSource\"

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750177000,"key":"gatsby-plugin-mdx-entire-payload-3f46f8be7d96a570b06cff8183b407d1-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Get Started","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":14,"offset":172},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":14,"offset":172},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed Kerberos Open Source, you will have access to the web application. This web application allows you to administrate the machinery.","position":{"start":{"line":10,"column":1,"offset":174},"end":{"line":10,"column":152,"offset":325},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":174},"end":{"line":10,"column":152,"offset":325},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Welcome page","position":{"start":{"line":12,"column":4,"offset":330},"end":{"line":12,"column":16,"offset":342},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":327},"end":{"line":12,"column":16,"offset":342},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The first time you open a browser, and navigate to the web application (ip address of your device), you will land on the welcome page. This page will guide you through some basic steps and set simple configurations such as username and password.","position":{"start":{"line":14,"column":1,"offset":344},"end":{"line":14,"column":246,"offset":589},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":344},"end":{"line":14,"column":246,"offset":589},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-welcome.png","alt":"OpenSource","position":{"start":{"line":16,"column":1,"offset":591},"end":{"line":16,"column":78,"offset":668},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":591},"end":{"line":16,"column":78,"offset":668},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Login page","position":{"start":{"line":18,"column":4,"offset":673},"end":{"line":18,"column":14,"offset":683},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":670},"end":{"line":18,"column":14,"offset":683},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When you've finished the welcome page, you will be redirected to the login page from now one. Use the credentials you have defined during the configuration of the welcome page. By default the username is ","position":{"start":{"line":20,"column":1,"offset":685},"end":{"line":20,"column":205,"offset":889},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":20,"column":207,"offset":891},"end":{"line":20,"column":211,"offset":895},"indent":[]}}],"position":{"start":{"line":20,"column":205,"offset":889},"end":{"line":20,"column":213,"offset":897},"indent":[]}},{"type":"text","value":", and the password is ","position":{"start":{"line":20,"column":213,"offset":897},"end":{"line":20,"column":235,"offset":919},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":20,"column":237,"offset":921},"end":{"line":20,"column":241,"offset":925},"indent":[]}}],"position":{"start":{"line":20,"column":235,"offset":919},"end":{"line":20,"column":243,"offset":927},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":20,"column":243,"offset":927},"end":{"line":20,"column":244,"offset":928},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":685},"end":{"line":20,"column":244,"offset":928},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-login.png","alt":"OpenSource","position":{"start":{"line":22,"column":1,"offset":930},"end":{"line":22,"column":76,"offset":1005},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":930},"end":{"line":22,"column":76,"offset":1005},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Dashboard","position":{"start":{"line":24,"column":4,"offset":1010},"end":{"line":24,"column":13,"offset":1019},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1007},"end":{"line":24,"column":13,"offset":1019},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After you have signed in successfully, you will land on the dashboard page. This page will give you an overview of some simple statistics. Such as the the activity per day, per hour, etc.","position":{"start":{"line":26,"column":1,"offset":1021},"end":{"line":26,"column":188,"offset":1208},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1021},"end":{"line":26,"column":188,"offset":1208},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-dashboard.png","alt":"OpenSource","position":{"start":{"line":28,"column":1,"offset":1210},"end":{"line":28,"column":80,"offset":1289},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1210},"end":{"line":28,"column":80,"offset":1289},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Media","position":{"start":{"line":30,"column":4,"offset":1294},"end":{"line":30,"column":9,"offset":1299},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1291},"end":{"line":30,"column":9,"offset":1299},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By selecting a specific day from the left navigation, or choosing the date picker on the top, you will be shown all the relevant media for that specific day. Both videos and images are listed and grouped (if they are within a specific time span). By scrolling down, more media items will be shown.","position":{"start":{"line":32,"column":1,"offset":1301},"end":{"line":32,"column":298,"offset":1598},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1301},"end":{"line":32,"column":298,"offset":1598},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can use the timeslider at the top of the page for browsing through the day. The white (no activity) to gray (low activity) to red (high activity), will give you an indications of the amount of recordings for that specific hour.","position":{"start":{"line":34,"column":1,"offset":1600},"end":{"line":34,"column":232,"offset":1831},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":1600},"end":{"line":34,"column":232,"offset":1831},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-media.png","alt":"OpenSource","position":{"start":{"line":36,"column":1,"offset":1833},"end":{"line":36,"column":76,"offset":1908},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":1833},"end":{"line":36,"column":76,"offset":1908},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-media-detail.png","alt":"OpenSource","position":{"start":{"line":38,"column":1,"offset":1910},"end":{"line":38,"column":83,"offset":1992},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1910},"end":{"line":38,"column":83,"offset":1992},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Settings","position":{"start":{"line":41,"column":4,"offset":1998},"end":{"line":41,"column":12,"offset":2006},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":1995},"end":{"line":41,"column":12,"offset":2006},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before being able to record anything, you will need to specify your capture device. A capture device is what we call: a camera. This camera can be a USB, RPi or IP camera. By default the RPi camera is selected, so if you are planning to use a IP camera make sure to change it on the settings page.","position":{"start":{"line":43,"column":1,"offset":2008},"end":{"line":43,"column":298,"offset":2305},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2008},"end":{"line":43,"column":298,"offset":2305},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-settings.png","alt":"OpenSource","position":{"start":{"line":45,"column":1,"offset":2307},"end":{"line":45,"column":79,"offset":2385},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2307},"end":{"line":45,"column":79,"offset":2385},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Region of interest","position":{"start":{"line":47,"column":5,"offset":2391},"end":{"line":47,"column":23,"offset":2409},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2387},"end":{"line":47,"column":23,"offset":2409},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Besides selecting the capture device, you will have different options to make the detection more intelligent, such as defining a regions of interest, or an activation timeline (when Kerberos Open Source should be active).","position":{"start":{"line":49,"column":1,"offset":2411},"end":{"line":49,"column":222,"offset":2632},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":2411},"end":{"line":49,"column":222,"offset":2632},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-motion.png","alt":"OpenSource","position":{"start":{"line":51,"column":1,"offset":2634},"end":{"line":51,"column":77,"offset":2710},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2634},"end":{"line":51,"column":77,"offset":2710},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Storage","position":{"start":{"line":53,"column":5,"offset":2716},"end":{"line":53,"column":12,"offset":2723},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2712},"end":{"line":53,"column":12,"offset":2723},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Storing your recordings on your device is fine, on the other hand you might want to make it available remotely. By giving your ","position":{"start":{"line":55,"column":1,"offset":2725},"end":{"line":55,"column":128,"offset":2852},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":55,"column":129,"offset":2853},"end":{"line":55,"column":143,"offset":2867},"indent":[]}}],"position":{"start":{"line":55,"column":128,"offset":2852},"end":{"line":55,"column":152,"offset":2876},"indent":[]}},{"type":"text","value":" credentials in the storage section, your recordings will be synced to our cloud solution.","position":{"start":{"line":55,"column":152,"offset":2876},"end":{"line":55,"column":242,"offset":2966},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2725},"end":{"line":55,"column":242,"offset":2966},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-cloud.png","alt":"OpenSource","position":{"start":{"line":57,"column":1,"offset":2968},"end":{"line":57,"column":76,"offset":3043},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2968},"end":{"line":57,"column":76,"offset":3043},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"System","position":{"start":{"line":59,"column":4,"offset":3048},"end":{"line":59,"column":10,"offset":3054},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":3045},"end":{"line":59,"column":10,"offset":3054},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This page will gave you overall information of Kerberos Open Source. It will give you information (logging) about the system, shows you some system information, the number of recordings on the system and more.","position":{"start":{"line":61,"column":1,"offset":3056},"end":{"line":61,"column":210,"offset":3265},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3056},"end":{"line":61,"column":210,"offset":3265},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-system.png","alt":"OpenSource","position":{"start":{"line":63,"column":1,"offset":3267},"end":{"line":63,"column":77,"offset":3343},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3267},"end":{"line":63,"column":77,"offset":3343},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":66,"column":1,"offset":3346},"end":{"line":66,"column":31,"offset":3376},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":66,"column":31,"offset":3376}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Get Started`}

\n

{`Once you've installed Kerberos Open Source, you will have access to the web application. This web application allows you to administrate the machinery.`}

\n

{`Welcome page`}

\n

{`The first time you open a browser, and navigate to the web application (ip address of your device), you will land on the welcome page. This page will guide you through some basic steps and set simple configurations such as username and password.`}

\n

\"OpenSource\"

\n

{`Login page`}

\n

{`When you've finished the welcome page, you will be redirected to the login page from now one. Use the credentials you have defined during the configuration of the welcome page. By default the username is `}{`root`}{`, and the password is `}{`root`}{`.`}

\n

\"OpenSource\"

\n

{`Dashboard`}

\n

{`After you have signed in successfully, you will land on the dashboard page. This page will give you an overview of some simple statistics. Such as the the activity per day, per hour, etc.`}

\n

\"OpenSource\"

\n

{`Media`}

\n

{`By selecting a specific day from the left navigation, or choosing the date picker on the top, you will be shown all the relevant media for that specific day. Both videos and images are listed and grouped (if they are within a specific time span). By scrolling down, more media items will be shown.`}

\n

{`You can use the timeslider at the top of the page for browsing through the day. The white (no activity) to gray (low activity) to red (high activity), will give you an indications of the amount of recordings for that specific hour.`}

\n

\"OpenSource\"

\n

\"OpenSource\"

\n

{`Settings`}

\n

{`Before being able to record anything, you will need to specify your capture device. A capture device is what we call: a camera. This camera can be a USB, RPi or IP camera. By default the RPi camera is selected, so if you are planning to use a IP camera make sure to change it on the settings page.`}

\n

\"OpenSource\"

\n

{`Region of interest`}

\n

{`Besides selecting the capture device, you will have different options to make the detection more intelligent, such as defining a regions of interest, or an activation timeline (when Kerberos Open Source should be active).`}

\n

\"OpenSource\"

\n

{`Storage`}

\n

{`Storing your recordings on your device is fine, on the other hand you might want to make it available remotely. By giving your `}{`Kerberos Cloud`}{` credentials in the storage section, your recordings will be synced to our cloud solution.`}

\n

\"OpenSource\"

\n

{`System`}

\n

{`This page will gave you overall information of Kerberos Open Source. It will give you information (logging) about the system, shows you some system information, the number of recordings on the system and more.`}

\n

\"OpenSource\"

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-946e8dd182bb57a7730010aa613d0702.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-946e8dd182bb57a7730010aa613d0702.json new file mode 100644 index 0000000..00dc079 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-946e8dd182bb57a7730010aa613d0702.json @@ -0,0 +1 @@ +{"expireTime":9007200861829555000,"key":"gatsby-plugin-mdx-entire-payload-f887b44dce8c523728c8c18985e85447-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. These storage provider could be in the cloud such as AWS S3, GCP storage and Azure Blob storemm, or can be localated on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":612,"offset":1265},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":612,"offset":1265},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":20,"column":4,"offset":1270},"end":{"line":20,"column":18,"offset":1284},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1267},"end":{"line":20,"column":18,"offset":1284},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":22,"column":1,"offset":1286},"end":{"line":22,"column":291,"offset":1576},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":22,"column":292,"offset":1577},"end":{"line":22,"column":309,"offset":1594},"indent":[]}}],"position":{"start":{"line":22,"column":291,"offset":1576},"end":{"line":22,"column":318,"offset":1603},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":22,"column":318,"offset":1603},"end":{"line":22,"column":319,"offset":1604},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1286},"end":{"line":22,"column":319,"offset":1604},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":24,"column":1,"offset":1606},"end":{"line":24,"column":56,"offset":1661},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1606},"end":{"line":24,"column":56,"offset":1661},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":26,"column":4,"offset":1666},"end":{"line":26,"column":20,"offset":1682},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1663},"end":{"line":26,"column":20,"offset":1682},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":28,"column":1,"offset":1684},"end":{"line":28,"column":253,"offset":1936},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1684},"end":{"line":28,"column":253,"offset":1936},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":30,"column":6,"offset":1943},"end":{"line":30,"column":35,"offset":1972},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1942},"end":{"line":30,"column":70,"offset":2007},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1942},"end":{"line":30,"column":70,"offset":2007},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1938},"end":{"line":30,"column":70,"offset":2007},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":31,"column":6,"offset":2013},"end":{"line":31,"column":29,"offset":2036},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2012},"end":{"line":31,"column":83,"offset":2090},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2012},"end":{"line":31,"column":83,"offset":2090},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":2008},"end":{"line":31,"column":83,"offset":2090},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":32,"column":6,"offset":2096},"end":{"line":32,"column":28,"offset":2118},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2095},"end":{"line":32,"column":57,"offset":2147},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2095},"end":{"line":32,"column":57,"offset":2147},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2091},"end":{"line":32,"column":57,"offset":2147},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":33,"column":6,"offset":2153},"end":{"line":33,"column":11,"offset":2158},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2152},"end":{"line":33,"column":29,"offset":2176},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2152},"end":{"line":33,"column":29,"offset":2176},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2148},"end":{"line":33,"column":29,"offset":2176},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1938},"end":{"line":33,"column":29,"offset":2176},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":35,"column":1,"offset":2178},"end":{"line":35,"column":190,"offset":2367},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2178},"end":{"line":35,"column":190,"offset":2367},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":37,"column":1,"offset":2369},"end":{"line":37,"column":99,"offset":2467},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2369},"end":{"line":37,"column":99,"offset":2467},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":39,"column":1,"offset":2469},"end":{"line":39,"column":220,"offset":2688},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2469},"end":{"line":39,"column":220,"offset":2688},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":41,"column":1,"offset":2690},"end":{"line":41,"column":98,"offset":2787},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2690},"end":{"line":41,"column":98,"offset":2787},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":43,"column":5,"offset":2793},"end":{"line":43,"column":11,"offset":2799},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2789},"end":{"line":43,"column":11,"offset":2799},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":45,"column":1,"offset":2801},"end":{"line":45,"column":303,"offset":3103},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2801},"end":{"line":45,"column":303,"offset":3103},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":47,"column":6,"offset":3110},"end":{"line":47,"column":18,"offset":3122},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3109},"end":{"line":47,"column":46,"offset":3150},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3109},"end":{"line":47,"column":46,"offset":3150},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3105},"end":{"line":47,"column":46,"offset":3150},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":48,"column":6,"offset":3156},"end":{"line":48,"column":29,"offset":3179},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3155},"end":{"line":48,"column":59,"offset":3209},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3155},"end":{"line":48,"column":59,"offset":3209},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":3151},"end":{"line":48,"column":59,"offset":3209},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3105},"end":{"line":48,"column":59,"offset":3209},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":50,"column":1,"offset":3211},"end":{"line":50,"column":368,"offset":3578},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3211},"end":{"line":50,"column":368,"offset":3578},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":52,"column":1,"offset":3580},"end":{"line":52,"column":66,"offset":3645},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3580},"end":{"line":52,"column":66,"offset":3645},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":54,"column":5,"offset":3651},"end":{"line":54,"column":21,"offset":3667},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3647},"end":{"line":54,"column":21,"offset":3667},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":56,"column":1,"offset":3669},"end":{"line":56,"column":237,"offset":3905},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3669},"end":{"line":56,"column":237,"offset":3905},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":58,"column":1,"offset":3907},"end":{"line":58,"column":105,"offset":4011},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3907},"end":{"line":58,"column":105,"offset":4011},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":60,"column":1,"offset":4013},"end":{"line":60,"column":45,"offset":4057},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4013},"end":{"line":60,"column":45,"offset":4057},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":62,"column":3,"offset":4061},"end":{"line":62,"column":380,"offset":4438},"indent":[]}}],"position":{"start":{"line":62,"column":3,"offset":4061},"end":{"line":62,"column":380,"offset":4438},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4059},"end":{"line":63,"column":1,"offset":4439},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":64,"column":3,"offset":4442},"end":{"line":65,"column":49,"offset":4756},"indent":[2]}}],"position":{"start":{"line":64,"column":3,"offset":4442},"end":{"line":65,"column":49,"offset":4756},"indent":[2]}}],"position":{"start":{"line":64,"column":1,"offset":4440},"end":{"line":65,"column":49,"offset":4756},"indent":[1]}}],"position":{"start":{"line":62,"column":1,"offset":4059},"end":{"line":65,"column":49,"offset":4756},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":67,"column":5,"offset":4762},"end":{"line":67,"column":13,"offset":4770},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":4758},"end":{"line":67,"column":13,"offset":4770},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":69,"column":1,"offset":4772},"end":{"line":69,"column":156,"offset":4927},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":69,"column":156,"offset":4927},"end":{"line":69,"column":177,"offset":4948},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":69,"column":177,"offset":4948},"end":{"line":69,"column":188,"offset":4959},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":69,"column":188,"offset":4959},"end":{"line":69,"column":193,"offset":4964},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":69,"column":193,"offset":4964},"end":{"line":69,"column":379,"offset":5150},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4772},"end":{"line":69,"column":379,"offset":5150},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":71,"column":1,"offset":5152},"end":{"line":71,"column":68,"offset":5219},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":5152},"end":{"line":71,"column":68,"offset":5219},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":73,"column":4,"offset":5224},"end":{"line":73,"column":13,"offset":5233},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5221},"end":{"line":73,"column":13,"offset":5233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":75,"column":1,"offset":5235},"end":{"line":75,"column":44,"offset":5278},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":75,"column":46,"offset":5280},"end":{"line":75,"column":68,"offset":5302},"indent":[]}}],"position":{"start":{"line":75,"column":44,"offset":5278},"end":{"line":75,"column":70,"offset":5304},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":75,"column":70,"offset":5304},"end":{"line":75,"column":106,"offset":5340},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":75,"column":108,"offset":5342},"end":{"line":75,"column":129,"offset":5363},"indent":[]}}],"position":{"start":{"line":75,"column":106,"offset":5340},"end":{"line":75,"column":131,"offset":5365},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":75,"column":131,"offset":5365},"end":{"line":75,"column":159,"offset":5393},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5235},"end":{"line":75,"column":159,"offset":5393},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":78,"column":1,"offset":5396},"end":{"line":78,"column":31,"offset":5426},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":78,"column":31,"offset":5426}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. These storage provider could be in the cloud such as AWS S3, GCP storage and Azure Blob storemm, or can be localated on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-9862e1c1aadef115e2d6922feb5c7423.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-9862e1c1aadef115e2d6922feb5c7423.json index 7ccd13c..49ef819 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-9862e1c1aadef115e2d6922feb5c7423.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-9862e1c1aadef115e2d6922feb5c7423.json @@ -1 +1 @@ -{"expireTime":9007200861747685000,"key":"gatsby-plugin-mdx-entire-payload-b3f9eb4b1fad4fde093eeca2444dee0f-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source comes with different installation flavours. So you might think, why? The reason is simple, depending on the use case one option is better than another. A short list of recommendations:","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":207,"offset":441},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":207,"offset":441},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Plug and play","position":{"start":{"line":14,"column":5,"offset":447},"end":{"line":14,"column":18,"offset":460},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":443},"end":{"line":14,"column":18,"offset":460},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation#kios","children":[{"type":"text","value":"KiOS","position":{"start":{"line":15,"column":5,"offset":465},"end":{"line":15,"column":9,"offset":469},"indent":[]}}],"position":{"start":{"line":15,"column":4,"offset":464},"end":{"line":15,"column":41,"offset":501},"indent":[]}},{"type":"text","value":": You have a Raspberry Pi, and you only want to run a Kerberos agent on it.","position":{"start":{"line":15,"column":41,"offset":501},"end":{"line":15,"column":116,"offset":576},"indent":[]}}],"position":{"start":{"line":15,"column":4,"offset":464},"end":{"line":15,"column":116,"offset":576},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":461},"end":{"line":15,"column":116,"offset":576},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation#docker","children":[{"type":"text","value":"Docker","position":{"start":{"line":16,"column":5,"offset":581},"end":{"line":16,"column":11,"offset":587},"indent":[]}}],"position":{"start":{"line":16,"column":4,"offset":580},"end":{"line":16,"column":45,"offset":621},"indent":[]}},{"type":"text","value":": You have a lot of IP cameras, and/or don't want to mess with dependencies.","position":{"start":{"line":16,"column":45,"offset":621},"end":{"line":16,"column":121,"offset":697},"indent":[]}}],"position":{"start":{"line":16,"column":4,"offset":580},"end":{"line":16,"column":121,"offset":697},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":577},"end":{"line":16,"column":121,"offset":697},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation#balena","children":[{"type":"text","value":"Balena","position":{"start":{"line":17,"column":5,"offset":702},"end":{"line":17,"column":11,"offset":708},"indent":[]}}],"position":{"start":{"line":17,"column":4,"offset":701},"end":{"line":17,"column":45,"offset":742},"indent":[]}},{"type":"text","value":": Runnning the Kerberos Docker container on top of Balena.","position":{"start":{"line":17,"column":45,"offset":742},"end":{"line":17,"column":103,"offset":800},"indent":[]}}],"position":{"start":{"line":17,"column":4,"offset":701},"end":{"line":17,"column":103,"offset":800},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":698},"end":{"line":17,"column":103,"offset":800},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":461},"end":{"line":17,"column":103,"offset":800},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Advanced","position":{"start":{"line":19,"column":5,"offset":806},"end":{"line":19,"column":13,"offset":814},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":802},"end":{"line":19,"column":13,"offset":814},"indent":[]}},{"type":"list","ordered":true,"start":4,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation-advanced#raspbian","children":[{"type":"text","value":"Raspbian","position":{"start":{"line":20,"column":5,"offset":819},"end":{"line":20,"column":13,"offset":827},"indent":[]}}],"position":{"start":{"line":20,"column":4,"offset":818},"end":{"line":20,"column":58,"offset":872},"indent":[]}},{"type":"text","value":": You have a Raspberry Pi, but you want other services running next to the Kerberos agent.","position":{"start":{"line":20,"column":58,"offset":872},"end":{"line":20,"column":148,"offset":962},"indent":[]}}],"position":{"start":{"line":20,"column":4,"offset":818},"end":{"line":20,"column":148,"offset":962},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":815},"end":{"line":20,"column":148,"offset":962},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation-advanced#generic","children":[{"type":"text","value":"Generic","position":{"start":{"line":21,"column":5,"offset":967},"end":{"line":21,"column":12,"offset":974},"indent":[]}}],"position":{"start":{"line":21,"column":4,"offset":966},"end":{"line":21,"column":56,"offset":1018},"indent":[]}},{"type":"text","value":": You want to develop/extend Kerberos with your own features, or you want to run a Kerberos agent on a not supported OS/architecure.","position":{"start":{"line":21,"column":56,"offset":1018},"end":{"line":21,"column":188,"offset":1150},"indent":[]}}],"position":{"start":{"line":21,"column":4,"offset":966},"end":{"line":21,"column":188,"offset":1150},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":963},"end":{"line":21,"column":188,"offset":1150},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":815},"end":{"line":21,"column":188,"offset":1150},"indent":[1]}},{"type":"thematicBreak","position":{"start":{"line":23,"column":1,"offset":1152},"end":{"line":23,"column":4,"offset":1155},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Plug and play","position":{"start":{"line":25,"column":3,"offset":1159},"end":{"line":25,"column":16,"offset":1172},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1157},"end":{"line":25,"column":16,"offset":1172},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Following installation methods aim for the simplicity of installing Kerberos Open Source. With almost no efforts you can have Kerberos Open Source running.","position":{"start":{"line":27,"column":1,"offset":1174},"end":{"line":27,"column":156,"offset":1329},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1174},"end":{"line":27,"column":156,"offset":1329},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"KiOS","position":{"start":{"line":29,"column":4,"offset":1334},"end":{"line":29,"column":8,"offset":1338},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1331},"end":{"line":29,"column":8,"offset":1338},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"KiOS (Kerberos Operating System) is our custom linux OS, which runs the Kerberos agent out-of-the-box (read plug-and-play). It's an OS designed for the Raspberry Pi (all version are supported), which you can flash to an SD card.","position":{"start":{"line":31,"column":1,"offset":1340},"end":{"line":31,"column":229,"offset":1568},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1340},"end":{"line":31,"column":229,"offset":1568},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"It can be installed using our own installer, which comes with a nice interface that handles the flashing and network configuration for you, or you can handle the flashing yourself by using Etcher.","position":{"start":{"line":33,"column":1,"offset":1570},"end":{"line":33,"column":197,"offset":1766},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1570},"end":{"line":33,"column":197,"offset":1766},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Github","position":{"start":{"line":35,"column":5,"offset":1772},"end":{"line":35,"column":11,"offset":1778},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1768},"end":{"line":35,"column":11,"offset":1778},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"KiOS is compiled using Buildroot, the project can be found on ","position":{"start":{"line":37,"column":1,"offset":1780},"end":{"line":37,"column":63,"offset":1842},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/kios","children":[{"type":"text","value":"following Github repo","position":{"start":{"line":37,"column":64,"offset":1843},"end":{"line":37,"column":85,"offset":1864},"indent":[]}}],"position":{"start":{"line":37,"column":63,"offset":1842},"end":{"line":37,"column":123,"offset":1902},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":37,"column":123,"offset":1902},"end":{"line":37,"column":124,"offset":1903},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1780},"end":{"line":37,"column":124,"offset":1903},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Open Source installer","position":{"start":{"line":39,"column":5,"offset":1909},"end":{"line":39,"column":35,"offset":1939},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":1905},"end":{"line":39,"column":35,"offset":1939},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Installing the Kerberos agent to your Raspberry Pi, has never been so easy. By using our cross-platform installer, you can run a fully configured video surveillance system within 3 minutes. Indeed, we also think that's awesome!","position":{"start":{"line":41,"column":1,"offset":1941},"end":{"line":41,"column":228,"offset":2168},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":1941},"end":{"line":41,"column":228,"offset":2168},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kios-install.gif","alt":"access kerberos installer","position":{"start":{"line":43,"column":1,"offset":2170},"end":{"line":43,"column":67,"offset":2236},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2170},"end":{"line":43,"column":67,"offset":2236},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Download the correct installer for your OS below:","position":{"start":{"line":45,"column":1,"offset":2238},"end":{"line":45,"column":50,"offset":2287},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2238},"end":{"line":45,"column":50,"offset":2287},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://github.com/kerberos-io/etcher/releases","children":[{"type":"text","value":"https://github.com/kerberos-io/etcher/releases","position":{"start":{"line":47,"column":3,"offset":2291},"end":{"line":47,"column":49,"offset":2337},"indent":[]}}],"position":{"start":{"line":47,"column":3,"offset":2291},"end":{"line":47,"column":49,"offset":2337},"indent":[]}}],"position":{"start":{"line":47,"column":3,"offset":2291},"end":{"line":47,"column":49,"offset":2337},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2289},"end":{"line":47,"column":49,"offset":2337},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Etcher","position":{"start":{"line":49,"column":5,"offset":2343},"end":{"line":49,"column":11,"offset":2349},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":2339},"end":{"line":49,"column":11,"offset":2349},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you love Etcher, or the Kerberos installer is not working as expected, you can also flash the Kerberos agent to your SD card manually. It goes as following:","position":{"start":{"line":51,"column":1,"offset":2351},"end":{"line":51,"column":160,"offset":2510},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2351},"end":{"line":51,"column":160,"offset":2510},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Download ","position":{"start":{"line":53,"column":4,"offset":2515},"end":{"line":53,"column":13,"offset":2524},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/kios/releases","children":[{"type":"text","value":"the KiOS image","position":{"start":{"line":53,"column":14,"offset":2525},"end":{"line":53,"column":28,"offset":2539},"indent":[]}}],"position":{"start":{"line":53,"column":13,"offset":2524},"end":{"line":53,"column":75,"offset":2586},"indent":[]}},{"type":"text","value":",","position":{"start":{"line":53,"column":75,"offset":2586},"end":{"line":53,"column":76,"offset":2587},"indent":[]}}],"position":{"start":{"line":53,"column":4,"offset":2515},"end":{"line":53,"column":76,"offset":2587},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2512},"end":{"line":53,"column":76,"offset":2587},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"flash it to your SD card with Etcher,","position":{"start":{"line":54,"column":4,"offset":2591},"end":{"line":54,"column":41,"offset":2628},"indent":[]}}],"position":{"start":{"line":54,"column":4,"offset":2591},"end":{"line":54,"column":41,"offset":2628},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":2588},"end":{"line":54,"column":41,"offset":2628},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"and edit some configuration files at the boot directory.","position":{"start":{"line":55,"column":4,"offset":2632},"end":{"line":55,"column":60,"offset":2688},"indent":[]}}],"position":{"start":{"line":55,"column":4,"offset":2632},"end":{"line":55,"column":60,"offset":2688},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2629},"end":{"line":55,"column":60,"offset":2688},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2512},"end":{"line":55,"column":60,"offset":2688},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://www.balena.io/etcher/","children":[{"type":"image","title":null,"url":"../../public/images/etcher-install.png","alt":"use etcher for kios","position":{"start":{"line":57,"column":2,"offset":2691},"end":{"line":57,"column":64,"offset":2753},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2690},"end":{"line":57,"column":96,"offset":2785},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2690},"end":{"line":57,"column":96,"offset":2785},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have download the KiOS image (make sure you downloaded the right image) and flashed it to an SD card, put it back into your working station. Navigate to the SD card and creating following files.","position":{"start":{"line":59,"column":1,"offset":2787},"end":{"line":59,"column":204,"offset":2990},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":2787},"end":{"line":59,"column":204,"offset":2990},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Connecting to WiFi","position":{"start":{"line":61,"column":6,"offset":2997},"end":{"line":61,"column":24,"offset":3015},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":2992},"end":{"line":61,"column":24,"offset":3015},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to connect your Raspberry Pi to a WiFi connection, you will need to create a file ","position":{"start":{"line":63,"column":1,"offset":3017},"end":{"line":63,"column":95,"offset":3111},"indent":[]}},{"type":"inlineCode","value":"wireless.conf","position":{"start":{"line":63,"column":95,"offset":3111},"end":{"line":63,"column":110,"offset":3126},"indent":[]}},{"type":"text","value":" on your SD card, with following contents. Change the SSID and password properties to your own WiFi credentials.","position":{"start":{"line":63,"column":110,"offset":3126},"end":{"line":63,"column":222,"offset":3238},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3017},"end":{"line":63,"column":222,"offset":3238},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"update_config=1\nctrl_interface=/var/run/wpa_supplicant\nnetwork={\n scan_ssid=1\n ssid=\"\"\n psk=\"\"\n}","position":{"start":{"line":65,"column":1,"offset":3240},"end":{"line":73,"column":4,"offset":3349},"indent":[1,1,1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Setup a static IP-address","position":{"start":{"line":75,"column":6,"offset":3356},"end":{"line":75,"column":31,"offset":3381},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3351},"end":{"line":75,"column":31,"offset":3381},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to assign a static ip-address to your Raspberry Pi, create a file ","position":{"start":{"line":77,"column":1,"offset":3383},"end":{"line":77,"column":79,"offset":3461},"indent":[]}},{"type":"inlineCode","value":"static_ip.conf","position":{"start":{"line":77,"column":79,"offset":3461},"end":{"line":77,"column":95,"offset":3477},"indent":[]}},{"type":"text","value":" on your SD card, with following contents:","position":{"start":{"line":77,"column":95,"offset":3477},"end":{"line":77,"column":137,"offset":3519},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3383},"end":{"line":77,"column":137,"offset":3519},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"#####################################################################\n# Enter the IP-address you want to have, followed by the subnet mask\n# e.g. 192.168.0.10/24\nstatic_ip=\"\"\n#####################################################################\n# Enter the Gateway and DNS, this will be your router in most cases\n# e.g. 192.168.0.1\nstatic_gw=\"\"\nstatic_dns=\"\"","position":{"start":{"line":79,"column":1,"offset":3521},"end":{"line":89,"column":4,"offset":3889},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Power on the Raspberry Pi","position":{"start":{"line":91,"column":5,"offset":3895},"end":{"line":91,"column":30,"offset":3920},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":3891},"end":{"line":91,"column":30,"offset":3920},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've finished the installation using either the KiOS installer or Etcher, you can put the SD card into your Raspberry Pi and turn it on. Please note that the first time you boot KiOS it can take about 2 mins before the system is operational. When KiOS is ready you can open your favorite browser and type in the IP address of your Raspberry Pi. This will open the Kerberos agent's front-end, which you can access with the username: root and password: root.","position":{"start":{"line":93,"column":1,"offset":3922},"end":{"line":93,"column":464,"offset":4385},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":3922},"end":{"line":93,"column":464,"offset":4385},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/access.png","alt":"access kerberos interface","position":{"start":{"line":95,"column":1,"offset":4387},"end":{"line":95,"column":61,"offset":4447},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4387},"end":{"line":95,"column":61,"offset":4447},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Access the Raspberry Pi","position":{"start":{"line":97,"column":5,"offset":4453},"end":{"line":97,"column":28,"offset":4476},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4449},"end":{"line":97,"column":28,"offset":4476},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can access the KiOS system with attaching your Raspberry Pi to a HDMI monitor or by using ","position":{"start":{"line":99,"column":1,"offset":4478},"end":{"line":99,"column":95,"offset":4572},"indent":[]}},{"type":"inlineCode","value":"ssh","position":{"start":{"line":99,"column":95,"offset":4572},"end":{"line":99,"column":100,"offset":4577},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":99,"column":100,"offset":4577},"end":{"line":99,"column":101,"offset":4578},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4478},"end":{"line":99,"column":101,"offset":4578},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"$ ssh root@192.168.0.12\nWelcome to kios-79e30bbb!\n[root@kios-79e30bbb ~]#","position":{"start":{"line":101,"column":1,"offset":4580},"end":{"line":105,"column":4,"offset":4663},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Note that by default no root password is set, you can define a password in the ","position":{"start":{"line":107,"column":1,"offset":4665},"end":{"line":107,"column":80,"offset":4744},"indent":[]}},{"type":"inlineCode","value":"/data/etc/kios.conf","position":{"start":{"line":107,"column":80,"offset":4744},"end":{"line":107,"column":101,"offset":4765},"indent":[]}},{"type":"text","value":" file. Once you added a password, make sure to reboot the OS.","position":{"start":{"line":107,"column":101,"offset":4765},"end":{"line":107,"column":162,"offset":4826},"indent":[]}}],"position":{"start":{"line":107,"column":1,"offset":4665},"end":{"line":107,"column":162,"offset":4826},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"[root@kios-79e30bbb ~]# nano /data/etc/kios.conf\n[root@kios-79e30bbb ~]# reboot","position":{"start":{"line":109,"column":1,"offset":4828},"end":{"line":112,"column":4,"offset":4917},"indent":[1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Docker","position":{"start":{"line":114,"column":4,"offset":4922},"end":{"line":114,"column":10,"offset":4928},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":4919},"end":{"line":114,"column":10,"offset":4928},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A Docker image (amd64, armv7, arm64) is available on ","position":{"start":{"line":116,"column":1,"offset":4930},"end":{"line":116,"column":54,"offset":4983},"indent":[]}},{"type":"link","title":null,"url":"https://hub.docker.com/u/kerberos","children":[{"type":"text","value":"the Docker hub","position":{"start":{"line":116,"column":55,"offset":4984},"end":{"line":116,"column":69,"offset":4998},"indent":[]}}],"position":{"start":{"line":116,"column":54,"offset":4983},"end":{"line":116,"column":105,"offset":5034},"indent":[]}},{"type":"text","value":", which contains all the necessary software to setup the Kerberos agent in a matter of seconds. Before you can run this image, make sure you have Docker installed. Afterwards you can use Docker, to get the Kerberos agent up and running. All Docker images can be found on ","position":{"start":{"line":116,"column":105,"offset":5034},"end":{"line":116,"column":376,"offset":5305},"indent":[]}},{"type":"link","title":null,"url":"https://hub.docker.com/u/kerberos","children":[{"type":"text","value":"the Docker hub","position":{"start":{"line":116,"column":377,"offset":5306},"end":{"line":116,"column":391,"offset":5320},"indent":[]}}],"position":{"start":{"line":116,"column":376,"offset":5305},"end":{"line":116,"column":427,"offset":5356},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":116,"column":427,"offset":5356},"end":{"line":116,"column":428,"offset":5357},"indent":[]}}],"position":{"start":{"line":116,"column":1,"offset":4930},"end":{"line":116,"column":428,"offset":5357},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This installation guide assumes you already have a good understanding of Docker. If you want to learn more about Kerberos.io on Docker, have a look at these tutorials.","position":{"start":{"line":118,"column":1,"offset":5359},"end":{"line":118,"column":168,"offset":5526},"indent":[]}}],"position":{"start":{"line":118,"column":1,"offset":5359},"end":{"line":118,"column":168,"offset":5526},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://medium.com/@cedricverst/kerberos-io-the-road-to-docker-8e048a480241","children":[{"type":"text","value":"Kerberos.io — the road to Docker","position":{"start":{"line":119,"column":4,"offset":5530},"end":{"line":119,"column":36,"offset":5562},"indent":[]}}],"position":{"start":{"line":119,"column":3,"offset":5529},"end":{"line":119,"column":114,"offset":5640},"indent":[]}}],"position":{"start":{"line":119,"column":3,"offset":5529},"end":{"line":119,"column":114,"offset":5640},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":5527},"end":{"line":119,"column":114,"offset":5640},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://medium.com/@cedricverst/kerberos-io-on-docker-19b25fa7efd1","children":[{"type":"text","value":"Kerberos.io on Docker","position":{"start":{"line":120,"column":4,"offset":5644},"end":{"line":120,"column":25,"offset":5665},"indent":[]}}],"position":{"start":{"line":120,"column":3,"offset":5643},"end":{"line":120,"column":94,"offset":5734},"indent":[]}}],"position":{"start":{"line":120,"column":3,"offset":5643},"end":{"line":120,"column":94,"offset":5734},"indent":[]}}],"position":{"start":{"line":120,"column":1,"offset":5641},"end":{"line":120,"column":94,"offset":5734},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":5527},"end":{"line":120,"column":94,"offset":5734},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":123,"column":5,"offset":5741},"end":{"line":123,"column":18,"offset":5754},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":5737},"end":{"line":123,"column":18,"offset":5754},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"Docker or Docker Desktop (Linux, OS or Windows)","position":{"start":{"line":125,"column":3,"offset":5758},"end":{"line":125,"column":50,"offset":5805},"indent":[]}}],"position":{"start":{"line":125,"column":3,"offset":5758},"end":{"line":125,"column":50,"offset":5805},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":5756},"end":{"line":125,"column":50,"offset":5805},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Github","position":{"start":{"line":127,"column":5,"offset":5811},"end":{"line":127,"column":11,"offset":5817},"indent":[]}}],"position":{"start":{"line":127,"column":1,"offset":5807},"end":{"line":127,"column":11,"offset":5817},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"All technical information, such as Dockerfile, can be found on ","position":{"start":{"line":129,"column":1,"offset":5819},"end":{"line":129,"column":64,"offset":5882},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/docker","children":[{"type":"text","value":"following Github repo","position":{"start":{"line":129,"column":65,"offset":5883},"end":{"line":129,"column":86,"offset":5904},"indent":[]}}],"position":{"start":{"line":129,"column":64,"offset":5882},"end":{"line":129,"column":126,"offset":5944},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":129,"column":126,"offset":5944},"end":{"line":129,"column":127,"offset":5945},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":5819},"end":{"line":129,"column":127,"offset":5945},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Download docker image","position":{"start":{"line":131,"column":5,"offset":5951},"end":{"line":131,"column":26,"offset":5972},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":5947},"end":{"line":131,"column":26,"offset":5972},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before you are able to run the Kerberos agent inside a container, you will need to pull the docker image from the Docker hub.","position":{"start":{"line":133,"column":1,"offset":5974},"end":{"line":133,"column":126,"offset":6099},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":5974},"end":{"line":133,"column":126,"offset":6099},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"docker pull kerberos/kerberos","position":{"start":{"line":135,"column":1,"offset":6101},"end":{"line":137,"column":4,"offset":6140},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"When you pulled succesfully you can run your first Kerberos container as following. This will run Kerberos agent and expose the web interface on port 80, and the livestream on port 8889.","position":{"start":{"line":139,"column":1,"offset":6142},"end":{"line":139,"column":187,"offset":6328},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":6142},"end":{"line":139,"column":187,"offset":6328},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"docker run --name camera1 -p 80:80 -p 8889:8889 -d kerberos/kerberos","position":{"start":{"line":141,"column":1,"offset":6330},"end":{"line":143,"column":4,"offset":6408},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"To add more containers, you can change the name parameter and assign another port to expose the web interface and livestream (ports are unique on a OS).","position":{"start":{"line":145,"column":1,"offset":6410},"end":{"line":145,"column":153,"offset":6562},"indent":[]}}],"position":{"start":{"line":145,"column":1,"offset":6410},"end":{"line":145,"column":153,"offset":6562},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"docker run --name camera2 -p 81:80 -p 8890:8889 -d kerberos/kerberos\ndocker run --name camera3 -p 82:80 -p 8891:8889 -d kerberos/kerberos","position":{"start":{"line":147,"column":1,"offset":6564},"end":{"line":150,"column":4,"offset":6711},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"When the containers are created, you can open your browser and browse to your different containers.","position":{"start":{"line":152,"column":1,"offset":6713},"end":{"line":152,"column":100,"offset":6812},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":6713},"end":{"line":152,"column":100,"offset":6812},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"http://localhost:80\nhttp://localhost:81\nhttp://localhost:82","position":{"start":{"line":153,"column":1,"offset":6813},"end":{"line":157,"column":4,"offset":6882},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Volumes","position":{"start":{"line":159,"column":5,"offset":6888},"end":{"line":159,"column":12,"offset":6895},"indent":[]}}],"position":{"start":{"line":159,"column":1,"offset":6884},"end":{"line":159,"column":12,"offset":6895},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Instead of just running the Kerberos container, you can also persist your configuration by assigning volumes. An example of mounting volumes looks like this; an overview of ","position":{"start":{"line":161,"column":1,"offset":6897},"end":{"line":161,"column":174,"offset":7070},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/docker/blob/master/Dockerfile#L171-L177","children":[{"type":"text","value":"the different volumes can be found here","position":{"start":{"line":161,"column":175,"offset":7071},"end":{"line":161,"column":214,"offset":7110},"indent":[]}}],"position":{"start":{"line":161,"column":174,"offset":7070},"end":{"line":161,"column":287,"offset":7183},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":161,"column":287,"offset":7183},"end":{"line":161,"column":288,"offset":7184},"indent":[]}}],"position":{"start":{"line":161,"column":1,"offset":6897},"end":{"line":161,"column":288,"offset":7184},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"preload configuration,","position":{"start":{"line":163,"column":3,"offset":7188},"end":{"line":163,"column":25,"offset":7210},"indent":[]}}],"position":{"start":{"line":163,"column":3,"offset":7188},"end":{"line":163,"column":25,"offset":7210},"indent":[]}}],"position":{"start":{"line":163,"column":1,"offset":7186},"end":{"line":163,"column":25,"offset":7210},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"or centralise the images/videos on your working station.","position":{"start":{"line":164,"column":3,"offset":7213},"end":{"line":164,"column":59,"offset":7269},"indent":[]}}],"position":{"start":{"line":164,"column":3,"offset":7213},"end":{"line":164,"column":59,"offset":7269},"indent":[]}}],"position":{"start":{"line":164,"column":1,"offset":7211},"end":{"line":164,"column":59,"offset":7269},"indent":[]}}],"position":{"start":{"line":163,"column":1,"offset":7186},"end":{"line":164,"column":59,"offset":7269},"indent":[1]}},{"type":"code","lang":"ts","meta":null,"value":"docker run --name kerberos-camera1 \\\n-p 80:80 -p 8889:8889 \\\n-v ~/config:/etc/opt/kerberosio/config \\\n-v ~/capture:/etc/opt/kerberosio/capture \\\n-v ~/logs:/etc/opt/kerberosio/logs \\\n-v ~/webconfig:/var/www/web/config \\\n-d kerberos/kerberos","position":{"start":{"line":166,"column":1,"offset":7271},"end":{"line":174,"column":4,"offset":7520},"indent":[1,1,1,1,1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Balena","position":{"start":{"line":176,"column":4,"offset":7525},"end":{"line":176,"column":10,"offset":7531},"indent":[]}}],"position":{"start":{"line":176,"column":1,"offset":7522},"end":{"line":176,"column":10,"offset":7531},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Running Kerberos inside a Docker container is great, it makes it possible to run Kerberos everywhere; basically on any OS. You can deploy Kerberos easily to the many different IoT boards we nowadays have available. The challenge with all these IoT boards is that they have different system architecures, however thanks to Docker (and its multi architecture builds), we can ship Kerberos to any of them. If you have a Raspberry Pi, you have two options: ","position":{"start":{"line":178,"column":1,"offset":7533},"end":{"line":178,"column":454,"offset":7986},"indent":[]}},{"type":"link","title":null,"url":"/opensource/installation#docker","children":[{"type":"text","value":"Docker","position":{"start":{"line":178,"column":455,"offset":7987},"end":{"line":178,"column":461,"offset":7993},"indent":[]}}],"position":{"start":{"line":178,"column":454,"offset":7986},"end":{"line":178,"column":495,"offset":8027},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":178,"column":495,"offset":8027},"end":{"line":178,"column":500,"offset":8032},"indent":[]}},{"type":"link","title":null,"url":"/opensource/installation#kios","children":[{"type":"text","value":"KiOS","position":{"start":{"line":178,"column":501,"offset":8033},"end":{"line":178,"column":505,"offset":8037},"indent":[]}}],"position":{"start":{"line":178,"column":500,"offset":8032},"end":{"line":178,"column":537,"offset":8069},"indent":[]}},{"type":"text","value":". If you have any other board, then ","position":{"start":{"line":178,"column":537,"offset":8069},"end":{"line":178,"column":573,"offset":8105},"indent":[]}},{"type":"link","title":null,"url":"/opensource/installation#docker","children":[{"type":"text","value":"Docker","position":{"start":{"line":178,"column":574,"offset":8106},"end":{"line":178,"column":580,"offset":8112},"indent":[]}}],"position":{"start":{"line":178,"column":573,"offset":8105},"end":{"line":178,"column":614,"offset":8146},"indent":[]}},{"type":"text","value":" is the way to go.","position":{"start":{"line":178,"column":614,"offset":8146},"end":{"line":178,"column":632,"offset":8164},"indent":[]}}],"position":{"start":{"line":178,"column":1,"offset":7533},"end":{"line":178,"column":632,"offset":8164},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've deployed the Kerberos Docker container, you can start monitoring your video surveillances cameras, however it doesn't have to stop here. Probably you also want remote access to your IoT board, and maybe some other cool stuff like system control, a VPN, a public url? This is where ","position":{"start":{"line":180,"column":1,"offset":8166},"end":{"line":180,"column":294,"offset":8459},"indent":[]}},{"type":"link","title":null,"url":"https://balena.io","children":[{"type":"text","value":"Balena.io","position":{"start":{"line":180,"column":295,"offset":8460},"end":{"line":180,"column":304,"offset":8469},"indent":[]}}],"position":{"start":{"line":180,"column":294,"offset":8459},"end":{"line":180,"column":324,"offset":8489},"indent":[]}},{"type":"text","value":" comes in.","position":{"start":{"line":180,"column":324,"offset":8489},"end":{"line":180,"column":334,"offset":8499},"indent":[]}}],"position":{"start":{"line":180,"column":1,"offset":8166},"end":{"line":180,"column":334,"offset":8499},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before getting into the details, you can ","position":{"start":{"line":182,"column":1,"offset":8501},"end":{"line":182,"column":42,"offset":8542},"indent":[]}},{"type":"link","title":null,"url":"https://medium.com/@cedricverst/kerberos-io-on-balenacloud-7d5a5dd68992","children":[{"type":"text","value":"find a more detailed tutorial at this blog","position":{"start":{"line":182,"column":43,"offset":8543},"end":{"line":182,"column":85,"offset":8585},"indent":[]}}],"position":{"start":{"line":182,"column":42,"offset":8542},"end":{"line":182,"column":159,"offset":8659},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":182,"column":159,"offset":8659},"end":{"line":182,"column":160,"offset":8660},"indent":[]}}],"position":{"start":{"line":182,"column":1,"offset":8501},"end":{"line":182,"column":160,"offset":8660},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1. Create a Balena account","position":{"start":{"line":184,"column":5,"offset":8666},"end":{"line":184,"column":31,"offset":8692},"indent":[]}}],"position":{"start":{"line":184,"column":1,"offset":8662},"end":{"line":184,"column":31,"offset":8692},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before moving on, make sure you have registered on ","position":{"start":{"line":186,"column":1,"offset":8694},"end":{"line":186,"column":52,"offset":8745},"indent":[]}},{"type":"link","title":null,"url":"https://www.balena.io","children":[{"type":"text","value":"Balena","position":{"start":{"line":186,"column":53,"offset":8746},"end":{"line":186,"column":59,"offset":8752},"indent":[]}}],"position":{"start":{"line":186,"column":52,"offset":8745},"end":{"line":186,"column":83,"offset":8776},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":186,"column":83,"offset":8776},"end":{"line":186,"column":84,"offset":8777},"indent":[]}}],"position":{"start":{"line":186,"column":1,"offset":8694},"end":{"line":186,"column":84,"offset":8777},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-balena-signup.png","alt":"Signup balena","position":{"start":{"line":188,"column":1,"offset":8779},"end":{"line":188,"column":87,"offset":8865},"indent":[]}}],"position":{"start":{"line":188,"column":1,"offset":8779},"end":{"line":188,"column":87,"offset":8865},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2. Create a device and flash","position":{"start":{"line":190,"column":5,"offset":8871},"end":{"line":190,"column":33,"offset":8899},"indent":[]}}],"position":{"start":{"line":190,"column":1,"offset":8867},"end":{"line":190,"column":33,"offset":8899},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After you signed up, you can create an application for a specific IoT board (e.g. Raspberry Pi 3). Once created you will be able to download the balena OS image, which you can flash to your SD card using ","position":{"start":{"line":192,"column":1,"offset":8901},"end":{"line":192,"column":205,"offset":9105},"indent":[]}},{"type":"link","title":null,"url":"https://www.balena.io/etcher/","children":[{"type":"text","value":"Etcher","position":{"start":{"line":192,"column":206,"offset":9106},"end":{"line":192,"column":212,"offset":9112},"indent":[]}}],"position":{"start":{"line":192,"column":205,"offset":9105},"end":{"line":192,"column":244,"offset":9144},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":192,"column":244,"offset":9144},"end":{"line":192,"column":245,"offset":9145},"indent":[]}}],"position":{"start":{"line":192,"column":1,"offset":8901},"end":{"line":192,"column":245,"offset":9145},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-balena-create.png","alt":"Create device balena","position":{"start":{"line":194,"column":1,"offset":9147},"end":{"line":194,"column":94,"offset":9240},"indent":[]}}],"position":{"start":{"line":194,"column":1,"offset":9147},"end":{"line":194,"column":94,"offset":9240},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"3. Connect","position":{"start":{"line":196,"column":5,"offset":9246},"end":{"line":196,"column":15,"offset":9256},"indent":[]}}],"position":{"start":{"line":196,"column":1,"offset":9242},"end":{"line":196,"column":15,"offset":9256},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've flashed the balena OS, turned on your IoT board, a new device should come up on the Balena dashboard (below the application you've created). At this point you will be able to connect to your device using the ","position":{"start":{"line":198,"column":1,"offset":9258},"end":{"line":198,"column":221,"offset":9478},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"balena-cli","position":{"start":{"line":198,"column":223,"offset":9480},"end":{"line":198,"column":233,"offset":9490},"indent":[]}}],"position":{"start":{"line":198,"column":221,"offset":9478},"end":{"line":198,"column":235,"offset":9492},"indent":[]}},{"type":"text","value":" ","position":{"start":{"line":198,"column":235,"offset":9492},"end":{"line":198,"column":236,"offset":9493},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/balena-io/balena-cli/blob/master/INSTALL.md#executable-installer","children":[{"type":"text","value":"read more about the installation here","position":{"start":{"line":198,"column":237,"offset":9494},"end":{"line":198,"column":274,"offset":9531},"indent":[]}}],"position":{"start":{"line":198,"column":236,"offset":9493},"end":{"line":198,"column":360,"offset":9617},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":198,"column":360,"offset":9617},"end":{"line":198,"column":361,"offset":9618},"indent":[]}}],"position":{"start":{"line":198,"column":1,"offset":9258},"end":{"line":198,"column":361,"offset":9618},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"First connect the ","position":{"start":{"line":200,"column":1,"offset":9620},"end":{"line":200,"column":19,"offset":9638},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"balena-cli","position":{"start":{"line":200,"column":21,"offset":9640},"end":{"line":200,"column":31,"offset":9650},"indent":[]}}],"position":{"start":{"line":200,"column":19,"offset":9638},"end":{"line":200,"column":33,"offset":9652},"indent":[]}},{"type":"text","value":" to your account by executing following command. Choose the recommended option.","position":{"start":{"line":200,"column":33,"offset":9652},"end":{"line":200,"column":112,"offset":9731},"indent":[]}}],"position":{"start":{"line":200,"column":1,"offset":9620},"end":{"line":200,"column":112,"offset":9731},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"balena login","position":{"start":{"line":202,"column":1,"offset":9733},"end":{"line":202,"column":17,"offset":9749},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After succesfully logged in you should be able to list your devices.","position":{"start":{"line":204,"column":1,"offset":9751},"end":{"line":204,"column":69,"offset":9819},"indent":[]}}],"position":{"start":{"line":204,"column":1,"offset":9751},"end":{"line":204,"column":69,"offset":9819},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"balena devices","position":{"start":{"line":206,"column":1,"offset":9821},"end":{"line":206,"column":19,"offset":9839},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"4. Write","position":{"start":{"line":208,"column":5,"offset":9845},"end":{"line":208,"column":13,"offset":9853},"indent":[]}}],"position":{"start":{"line":208,"column":1,"offset":9841},"end":{"line":208,"column":13,"offset":9853},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Finally, we can push our Kerberos Docker container to our application (and devices). To do this we need to create two files.","position":{"start":{"line":210,"column":1,"offset":9855},"end":{"line":210,"column":125,"offset":9979},"indent":[]}}],"position":{"start":{"line":210,"column":1,"offset":9855},"end":{"line":210,"column":125,"offset":9979},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Create a new directory and the Dockerfile.","position":{"start":{"line":212,"column":4,"offset":9984},"end":{"line":212,"column":46,"offset":10026},"indent":[]}}],"position":{"start":{"line":212,"column":4,"offset":9984},"end":{"line":212,"column":46,"offset":10026},"indent":[]}}],"position":{"start":{"line":212,"column":1,"offset":9981},"end":{"line":212,"column":46,"offset":10026},"indent":[]}}],"position":{"start":{"line":212,"column":1,"offset":9981},"end":{"line":212,"column":46,"offset":10026},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The first file is named ","position":{"start":{"line":214,"column":1,"offset":10028},"end":{"line":214,"column":25,"offset":10052},"indent":[]}},{"type":"inlineCode","value":"Dockerfile","position":{"start":{"line":214,"column":25,"offset":10052},"end":{"line":214,"column":37,"offset":10064},"indent":[]}},{"type":"text","value":" this file will contain a base image which references to our Kerberos image, which ","position":{"start":{"line":214,"column":37,"offset":10064},"end":{"line":214,"column":120,"offset":10147},"indent":[]}},{"type":"link","title":null,"url":"https://hub.docker.com/repository/docker/kerberos/kerberos/tags?page=1","children":[{"type":"text","value":"you can find here","position":{"start":{"line":214,"column":121,"offset":10148},"end":{"line":214,"column":138,"offset":10165},"indent":[]}}],"position":{"start":{"line":214,"column":120,"offset":10147},"end":{"line":214,"column":211,"offset":10238},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":214,"column":211,"offset":10238},"end":{"line":214,"column":212,"offset":10239},"indent":[]}}],"position":{"start":{"line":214,"column":1,"offset":10028},"end":{"line":214,"column":212,"offset":10239},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"mkdir kerberosbalena\ncd kerberosbalena\necho 'FROM kerberos/kerberos@sha256:70a8b2791c8605ca6f8442b3d7892bb9bfc0789ab2f9f68911e247f7af50caed\nCMD [\"bash\", \"/run.sh\"]' > Dockerfile","position":{"start":{"line":216,"column":1,"offset":10241},"end":{"line":219,"column":42,"offset":10434},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Please note that we specified a sha256 tag, you have to make sure you use the right sha256 tag for your architecure. In the example above we use the sha256 tag for a armv7 architecture (Raspberry Pi3).","position":{"start":{"line":221,"column":1,"offset":10436},"end":{"line":221,"column":202,"offset":10637},"indent":[]}}],"position":{"start":{"line":221,"column":1,"offset":10436},"end":{"line":221,"column":202,"offset":10637},"indent":[]}},{"type":"list","ordered":true,"start":2,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Create a Docker compose file.","position":{"start":{"line":223,"column":4,"offset":10642},"end":{"line":223,"column":33,"offset":10671},"indent":[]}}],"position":{"start":{"line":223,"column":4,"offset":10642},"end":{"line":223,"column":33,"offset":10671},"indent":[]}}],"position":{"start":{"line":223,"column":1,"offset":10639},"end":{"line":223,"column":33,"offset":10671},"indent":[]}}],"position":{"start":{"line":223,"column":1,"offset":10639},"end":{"line":223,"column":33,"offset":10671},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Docker compose file is optional, but can be very useful. It can be used to deploy multi container application (e.g. a webserver + database). As Kerberos has everything in one single container, this is not needed.","position":{"start":{"line":225,"column":1,"offset":10673},"end":{"line":225,"column":217,"offset":10889},"indent":[]}}],"position":{"start":{"line":225,"column":1,"offset":10673},"end":{"line":225,"column":217,"offset":10889},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"We will use the `docker-compose.yml to mount volumes, so that when we restart our container all our configurations and recordings stay persisted.","position":{"start":{"line":227,"column":1,"offset":10891},"end":{"line":227,"column":146,"offset":11036},"indent":[]}}],"position":{"start":{"line":227,"column":1,"offset":10891},"end":{"line":227,"column":146,"offset":11036},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Create a new file named ","position":{"start":{"line":229,"column":1,"offset":11038},"end":{"line":229,"column":25,"offset":11062},"indent":[]}},{"type":"inlineCode","value":"docker-compose.yml","position":{"start":{"line":229,"column":25,"offset":11062},"end":{"line":229,"column":45,"offset":11082},"indent":[]}},{"type":"text","value":", and copy-paste following content.","position":{"start":{"line":229,"column":45,"offset":11082},"end":{"line":229,"column":80,"offset":11117},"indent":[]}}],"position":{"start":{"line":229,"column":1,"offset":11038},"end":{"line":229,"column":80,"offset":11117},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"version: '2.1'\nnetworks: {}\nvolumes:\n config: {}\n capture: {}\n logs: {}\n web: {}\nservices:\n main:\n build:\n context: .\n privileged: true\n tty: true\n restart: always\n network_mode: host\n volumes:\n - 'config:/etc/opt/kerberosio/config'\n - 'capture:/etc/opt/kerberosio/capture'\n - 'logs:/etc/opt/kerberosio/logs'\n - 'web:/var/www/web/config'\n labels:\n io.balena.features.kernel-modules: '1'\n io.balena.features.firmware: '1'\n io.balena.features.dbus: '1'\n io.balena.features.supervisor-api: '1'\n io.balena.features.resin-api: '1'\n io.balena.features.balena-socket: '1'","position":{"start":{"line":231,"column":1,"offset":11119},"end":{"line":257,"column":48,"offset":11872},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"5. Push","position":{"start":{"line":259,"column":5,"offset":11878},"end":{"line":259,"column":12,"offset":11885},"indent":[]}}],"position":{"start":{"line":259,"column":1,"offset":11874},"end":{"line":259,"column":12,"offset":11885},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Now we created our two files, we can publish the Kerberos container to balena (our application), by executing the push command (replace by the name of your application).","position":{"start":{"line":261,"column":1,"offset":11887},"end":{"line":261,"column":189,"offset":12075},"indent":[]}}],"position":{"start":{"line":261,"column":1,"offset":11887},"end":{"line":261,"column":189,"offset":12075},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"balena push ","position":{"start":{"line":263,"column":1,"offset":12077},"end":{"line":263,"column":35,"offset":12111},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once finished you should see following message, and on the dashboard you should see your devices updating (Yes you can add multiple devices to an application). You're ready ;)","position":{"start":{"line":265,"column":1,"offset":12113},"end":{"line":265,"column":176,"offset":12288},"indent":[]}}],"position":{"start":{"line":265,"column":1,"offset":12113},"end":{"line":265,"column":176,"offset":12288},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-balena-push.png","alt":"Push to balena","position":{"start":{"line":267,"column":1,"offset":12290},"end":{"line":267,"column":86,"offset":12375},"indent":[]}}],"position":{"start":{"line":267,"column":1,"offset":12290},"end":{"line":267,"column":86,"offset":12375},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":270,"column":1,"offset":12378},"end":{"line":270,"column":31,"offset":12408},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":270,"column":31,"offset":12408}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Installation`}

\n

{`Kerberos Open Source comes with different installation flavours. So you might think, why? The reason is simple, depending on the use case one option is better than another. A short list of recommendations:`}

\n

{`Plug and play`}

\n
    \n
  1. {`KiOS`}{`: You have a Raspberry Pi, and you only want to run a Kerberos agent on it.`}
    2. \n
  2. {`Docker`}{`: You have a lot of IP cameras, and/or don't want to mess with dependencies.`}
    3. \n
  3. {`Balena`}{`: Runnning the Kerberos Docker container on top of Balena.`}
    4. \n
\n

{`Advanced`}

\n
    \n
  1. {`Raspbian`}{`: You have a Raspberry Pi, but you want other services running next to the Kerberos agent.`}
    2. \n
  2. {`Generic`}{`: You want to develop/extend Kerberos with your own features, or you want to run a Kerberos agent on a not supported OS/architecure.`}
    3. \n
\n
\n

{`Plug and play`}

\n

{`Following installation methods aim for the simplicity of installing Kerberos Open Source. With almost no efforts you can have Kerberos Open Source running.`}

\n

{`KiOS`}

\n

{`KiOS (Kerberos Operating System) is our custom linux OS, which runs the Kerberos agent out-of-the-box (read plug-and-play). It's an OS designed for the Raspberry Pi (all version are supported), which you can flash to an SD card.`}

\n

{`It can be installed using our own installer, which comes with a nice interface that handles the flashing and network configuration for you, or you can handle the flashing yourself by using Etcher.`}

\n

{`Github`}

\n

{`KiOS is compiled using Buildroot, the project can be found on `}{`following Github repo`}{`.`}

\n

{`Kerberos Open Source installer`}

\n

{`Installing the Kerberos agent to your Raspberry Pi, has never been so easy. By using our cross-platform installer, you can run a fully configured video surveillance system within 3 minutes. Indeed, we also think that's awesome!`}

\n

\"access

\n

{`Download the correct installer for your OS below:`}

\n
\n

{`https://github.com/kerberos-io/etcher/releases`}

\n
\n

{`Etcher`}

\n

{`If you love Etcher, or the Kerberos installer is not working as expected, you can also flash the Kerberos agent to your SD card manually. It goes as following:`}

\n
    \n
  1. {`Download `}{`the KiOS image`}{`,`}
    2. \n
  2. {`flash it to your SD card with Etcher,`}
    3. \n
  3. {`and edit some configuration files at the boot directory.`}
    4. \n
\n

\"use

\n

{`Once you have download the KiOS image (make sure you downloaded the right image) and flashed it to an SD card, put it back into your working station. Navigate to the SD card and creating following files.`}

\n

{`Connecting to WiFi`}

\n

{`If you want to connect your Raspberry Pi to a WiFi connection, you will need to create a file `}{`wireless.conf`}{` on your SD card, with following contents. Change the SSID and password properties to your own WiFi credentials.`}

\n 
{`update_config`}{`=`}{`1`}{`\n`}{`ctrl_interface`}{`=/`}{`var`}{`/`}{`run`}{`/wpa_supplicant`}{`\n`}{`network`}{`={`}{`\n`}{`  `}{`scan_ssid`}{`=`}{`1`}{`\n`}{`  `}{`ssid`}{`=`}{`\"\"`}{`\n`}{`  `}{`psk`}{`=`}{`\"\"`}{`\n`}{`}`}
\n

{`Setup a static IP-address`}

\n

{`If you want to assign a static ip-address to your Raspberry Pi, create a file `}{`static_ip.conf`}{` on your SD card, with following contents:`}

\n 
{`#####################################################################`}{`\n`}{`# `}{`Enter`}{` `}{`the`}{` `}{`IP`}{`-`}{`address`}{` `}{`you`}{` `}{`want`}{` `}{`to`}{` `}{`have`}{`, `}{`followed`}{` `}{`by`}{` `}{`the`}{` `}{`subnet`}{` `}{`mask`}{`\n`}{`# `}{`e`}{`.`}{`g`}{`. `}{`192.168`}{`.`}{`0.10`}{`/`}{`24`}{`\n`}{`static_ip`}{`=`}{`\"\"`}{`\n`}{`#####################################################################`}{`\n`}{`# `}{`Enter`}{` `}{`the`}{` `}{`Gateway`}{` `}{`and`}{` `}{`DNS`}{`, `}{`this`}{` `}{`will`}{` `}{`be`}{` `}{`your`}{` `}{`router`}{` `}{`in`}{` `}{`most`}{` `}{`cases`}{`\n`}{`# `}{`e`}{`.`}{`g`}{`. `}{`192.168`}{`.`}{`0.1`}{`\n`}{`static_gw`}{`=`}{`\"\"`}{`\n`}{`static_dns`}{`=`}{`\"\"`}
\n

{`Power on the Raspberry Pi`}

\n

{`Once you've finished the installation using either the KiOS installer or Etcher, you can put the SD card into your Raspberry Pi and turn it on. Please note that the first time you boot KiOS it can take about 2 mins before the system is operational. When KiOS is ready you can open your favorite browser and type in the IP address of your Raspberry Pi. This will open the Kerberos agent's front-end, which you can access with the username: root and password: root.`}

\n

\"access

\n

{`Access the Raspberry Pi`}

\n

{`You can access the KiOS system with attaching your Raspberry Pi to a HDMI monitor or by using `}{`ssh`}{`.`}

\n 
{`$`}{` `}{`ssh`}{` `}{`root`}{`@`}{`192.168`}{`.`}{`0.12`}{`\n`}{`Welcome`}{` `}{`to`}{` `}{`kios`}{`-79`}{`e30bbb`}{`!`}{`\n`}{`[`}{`root`}{`@`}{`kios`}{`-79`}{`e30bbb`}{` ~]#`}
\n

{`Note that by default no root password is set, you can define a password in the `}{`/data/etc/kios.conf`}{` file. Once you added a password, make sure to reboot the OS.`}

\n 
{`[`}{`root`}{`@`}{`kios`}{`-79`}{`e30bbb`}{` ~]# `}{`nano`}{` /`}{`data`}{`/`}{`etc`}{`/`}{`kios`}{`.`}{`conf`}{`\n`}{`[`}{`root`}{`@`}{`kios`}{`-79`}{`e30bbb`}{` ~]# `}{`reboot`}
\n

{`Docker`}

\n

{`A Docker image (amd64, armv7, arm64) is available on `}{`the Docker hub`}{`, which contains all the necessary software to setup the Kerberos agent in a matter of seconds. Before you can run this image, make sure you have Docker installed. Afterwards you can use Docker, to get the Kerberos agent up and running. All Docker images can be found on `}{`the Docker hub`}{`.`}

\n

{`This installation guide assumes you already have a good understanding of Docker. If you want to learn more about Kerberos.io on Docker, have a look at these tutorials.`}

\n \n

{`Prerequisites`}

\n
\n

{`Docker or Docker Desktop (Linux, OS or Windows)`}

\n
\n

{`Github`}

\n

{`All technical information, such as Dockerfile, can be found on `}{`following Github repo`}{`.`}

\n

{`Download docker image`}

\n

{`Before you are able to run the Kerberos agent inside a container, you will need to pull the docker image from the Docker hub.`}

\n 
{`docker`}{` `}{`pull`}{` `}{`kerberos`}{`/`}{`kerberos`}
\n

{`When you pulled succesfully you can run your first Kerberos container as following. This will run Kerberos agent and expose the web interface on port 80, and the livestream on port 8889.`}

\n 
{`docker`}{` `}{`run`}{` --`}{`name`}{` `}{`camera1`}{` -`}{`p`}{` `}{`80`}{`:`}{`80`}{` -`}{`p`}{` `}{`8889`}{`:`}{`8889`}{` -`}{`d`}{` `}{`kerberos`}{`/`}{`kerberos`}
\n

{`To add more containers, you can change the name parameter and assign another port to expose the web interface and livestream (ports are unique on a OS).`}

\n 
{`docker`}{` `}{`run`}{` --`}{`name`}{` `}{`camera2`}{` -`}{`p`}{` `}{`81`}{`:`}{`80`}{` -`}{`p`}{` `}{`8890`}{`:`}{`8889`}{` -`}{`d`}{` `}{`kerberos`}{`/`}{`kerberos`}{`\n`}{`docker`}{` `}{`run`}{` --`}{`name`}{` `}{`camera3`}{` -`}{`p`}{` `}{`82`}{`:`}{`80`}{` -`}{`p`}{` `}{`8891`}{`:`}{`8889`}{` -`}{`d`}{` `}{`kerberos`}{`/`}{`kerberos`}
\n

{`When the containers are created, you can open your browser and browse to your different containers.`}

\n 
{`http:`}{`//localhost:80`}{`\n`}{`http:`}{`//localhost:81`}{`\n`}{`http:`}{`//localhost:82`}
\n

{`Volumes`}

\n

{`Instead of just running the Kerberos container, you can also persist your configuration by assigning volumes. An example of mounting volumes looks like this; an overview of `}{`the different volumes can be found here`}{`.`}

\n
    \n
  • {`preload configuration,`}
    • \n
  • {`or centralise the images/videos on your working station.`}
    • \n
\n 
{`docker`}{` `}{`run`}{` --`}{`name`}{` `}{`kerberos`}{`-`}{`camera1`}{` \\\\`}{`\n`}{`-`}{`p`}{` `}{`80`}{`:`}{`80`}{` -`}{`p`}{` `}{`8889`}{`:`}{`8889`}{` \\\\`}{`\n`}{`-`}{`v`}{` ~/config:/`}{`etc`}{`/`}{`opt`}{`/`}{`kerberosio`}{`/`}{`config`}{` \\\\`}{`\n`}{`-`}{`v`}{` ~/capture:/`}{`etc`}{`/`}{`opt`}{`/`}{`kerberosio`}{`/`}{`capture`}{` \\\\`}{`\n`}{`-`}{`v`}{` ~/logs:/`}{`etc`}{`/`}{`opt`}{`/`}{`kerberosio`}{`/`}{`logs`}{` \\\\`}{`\n`}{`-`}{`v`}{` ~/webconfig:/`}{`var`}{`/`}{`www`}{`/web/config \\\\`}{`\n`}{`-`}{`d`}{` `}{`kerberos`}{`/`}{`kerberos`}
\n

{`Balena`}

\n

{`Running Kerberos inside a Docker container is great, it makes it possible to run Kerberos everywhere; basically on any OS. You can deploy Kerberos easily to the many different IoT boards we nowadays have available. The challenge with all these IoT boards is that they have different system architecures, however thanks to Docker (and its multi architecture builds), we can ship Kerberos to any of them. If you have a Raspberry Pi, you have two options: `}{`Docker`}{` and `}{`KiOS`}{`. If you have any other board, then `}{`Docker`}{` is the way to go.`}

\n

{`Once you've deployed the Kerberos Docker container, you can start monitoring your video surveillances cameras, however it doesn't have to stop here. Probably you also want remote access to your IoT board, and maybe some other cool stuff like system control, a VPN, a public url? This is where `}{`Balena.io`}{` comes in.`}

\n

{`Before getting into the details, you can `}{`find a more detailed tutorial at this blog`}{`.`}

\n

{`1. Create a Balena account`}

\n

{`Before moving on, make sure you have registered on `}{`Balena`}{`.`}

\n

\"Signup

\n

{`2. Create a device and flash`}

\n

{`After you signed up, you can create an application for a specific IoT board (e.g. Raspberry Pi 3). Once created you will be able to download the balena OS image, which you can flash to your SD card using `}{`Etcher`}{`.`}

\n

\"Create

\n

{`3. Connect`}

\n

{`Once you've flashed the balena OS, turned on your IoT board, a new device should come up on the Balena dashboard (below the application you've created). At this point you will be able to connect to your device using the `}{`balena-cli`}{` `}{`read more about the installation here`}{`.`}

\n

{`First connect the `}{`balena-cli`}{` to your account by executing following command. Choose the recommended option.`}

\n 
{`balena login`}
\n

{`After succesfully logged in you should be able to list your devices.`}

\n 
{`balena devices`}
\n

{`4. Write`}

\n

{`Finally, we can push our Kerberos Docker container to our application (and devices). To do this we need to create two files.`}

\n
    \n
  1. {`Create a new directory and the Dockerfile.`}
    2. \n
\n

{`The first file is named `}{`Dockerfile`}{` this file will contain a base image which references to our Kerberos image, which `}{`you can find here`}{`.`}

\n 
{`mkdir kerberosbalena`}{`\n`}{`cd kerberosbalena`}{`\n`}{`echo 'FROM kerberos/kerberos@sha256:70a8b2791c8605ca6f8442b3d7892bb9bfc0789ab2f9f68911e247f7af50caed`}{`\n`}{`CMD [\"bash\", \"/run.sh\"]' > Dockerfile`}
\n

{`Please note that we specified a sha256 tag, you have to make sure you use the right sha256 tag for your architecure. In the example above we use the sha256 tag for a armv7 architecture (Raspberry Pi3).`}

\n
    \n
  1. {`Create a Docker compose file.`}
    2. \n
\n

{`The Docker compose file is optional, but can be very useful. It can be used to deploy multi container application (e.g. a webserver + database). As Kerberos has everything in one single container, this is not needed.`}

\n

{`We will use the \\`docker-compose.yml to mount volumes, so that when we restart our container all our configurations and recordings stay persisted.`}

\n

{`Create a new file named `}{`docker-compose.yml`}{`, and copy-paste following content.`}

\n 
{`version: '2.1'`}{`\n`}{`networks: {}`}{`\n`}{`volumes:`}{`\n`}{`  config: {}`}{`\n`}{`  capture: {}`}{`\n`}{`  logs: {}`}{`\n`}{`  web: {}`}{`\n`}{`services:`}{`\n`}{`  main:`}{`\n`}{`    build:`}{`\n`}{`      context: .`}{`\n`}{`    privileged: true`}{`\n`}{`    tty: true`}{`\n`}{`    restart: always`}{`\n`}{`    network_mode: host`}{`\n`}{`    volumes:`}{`\n`}{`      - 'config:/etc/opt/kerberosio/config'`}{`\n`}{`      - 'capture:/etc/opt/kerberosio/capture'`}{`\n`}{`      - 'logs:/etc/opt/kerberosio/logs'`}{`\n`}{`      - 'web:/var/www/web/config'`}{`\n`}{`    labels:`}{`\n`}{`      io.balena.features.kernel-modules: '1'`}{`\n`}{`      io.balena.features.firmware: '1'`}{`\n`}{`      io.balena.features.dbus: '1'`}{`\n`}{`      io.balena.features.supervisor-api: '1'`}{`\n`}{`      io.balena.features.resin-api: '1'`}{`\n`}{`      io.balena.features.balena-socket: '1'`}
\n

{`5. Push`}

\n

{`Now we created our two files, we can publish the Kerberos container to balena (our application), by executing the push command (replace by the name of your application).`}

\n 
{`balena push `}
\n

{`Once finished you should see following message, and on the dashboard you should see your devices updating (Yes you can add multiple devices to an application). You're ready ;)`}

\n

\"Push

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750188000,"key":"gatsby-plugin-mdx-entire-payload-b3f9eb4b1fad4fde093eeca2444dee0f-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source comes with different installation flavours. So you might think, why? The reason is simple, depending on the use case one option is better than another. A short list of recommendations:","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":207,"offset":441},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":207,"offset":441},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Plug and play","position":{"start":{"line":14,"column":5,"offset":447},"end":{"line":14,"column":18,"offset":460},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":443},"end":{"line":14,"column":18,"offset":460},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation#kios","children":[{"type":"text","value":"KiOS","position":{"start":{"line":15,"column":5,"offset":465},"end":{"line":15,"column":9,"offset":469},"indent":[]}}],"position":{"start":{"line":15,"column":4,"offset":464},"end":{"line":15,"column":41,"offset":501},"indent":[]}},{"type":"text","value":": You have a Raspberry Pi, and you only want to run a Kerberos agent on it.","position":{"start":{"line":15,"column":41,"offset":501},"end":{"line":15,"column":116,"offset":576},"indent":[]}}],"position":{"start":{"line":15,"column":4,"offset":464},"end":{"line":15,"column":116,"offset":576},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":461},"end":{"line":15,"column":116,"offset":576},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation#docker","children":[{"type":"text","value":"Docker","position":{"start":{"line":16,"column":5,"offset":581},"end":{"line":16,"column":11,"offset":587},"indent":[]}}],"position":{"start":{"line":16,"column":4,"offset":580},"end":{"line":16,"column":45,"offset":621},"indent":[]}},{"type":"text","value":": You have a lot of IP cameras, and/or don't want to mess with dependencies.","position":{"start":{"line":16,"column":45,"offset":621},"end":{"line":16,"column":121,"offset":697},"indent":[]}}],"position":{"start":{"line":16,"column":4,"offset":580},"end":{"line":16,"column":121,"offset":697},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":577},"end":{"line":16,"column":121,"offset":697},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation#balena","children":[{"type":"text","value":"Balena","position":{"start":{"line":17,"column":5,"offset":702},"end":{"line":17,"column":11,"offset":708},"indent":[]}}],"position":{"start":{"line":17,"column":4,"offset":701},"end":{"line":17,"column":45,"offset":742},"indent":[]}},{"type":"text","value":": Runnning the Kerberos Docker container on top of Balena.","position":{"start":{"line":17,"column":45,"offset":742},"end":{"line":17,"column":103,"offset":800},"indent":[]}}],"position":{"start":{"line":17,"column":4,"offset":701},"end":{"line":17,"column":103,"offset":800},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":698},"end":{"line":17,"column":103,"offset":800},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":461},"end":{"line":17,"column":103,"offset":800},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Advanced","position":{"start":{"line":19,"column":5,"offset":806},"end":{"line":19,"column":13,"offset":814},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":802},"end":{"line":19,"column":13,"offset":814},"indent":[]}},{"type":"list","ordered":true,"start":4,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation-advanced#raspbian","children":[{"type":"text","value":"Raspbian","position":{"start":{"line":20,"column":5,"offset":819},"end":{"line":20,"column":13,"offset":827},"indent":[]}}],"position":{"start":{"line":20,"column":4,"offset":818},"end":{"line":20,"column":58,"offset":872},"indent":[]}},{"type":"text","value":": You have a Raspberry Pi, but you want other services running next to the Kerberos agent.","position":{"start":{"line":20,"column":58,"offset":872},"end":{"line":20,"column":148,"offset":962},"indent":[]}}],"position":{"start":{"line":20,"column":4,"offset":818},"end":{"line":20,"column":148,"offset":962},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":815},"end":{"line":20,"column":148,"offset":962},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"/opensource/installation-advanced#generic","children":[{"type":"text","value":"Generic","position":{"start":{"line":21,"column":5,"offset":967},"end":{"line":21,"column":12,"offset":974},"indent":[]}}],"position":{"start":{"line":21,"column":4,"offset":966},"end":{"line":21,"column":56,"offset":1018},"indent":[]}},{"type":"text","value":": You want to develop/extend Kerberos with your own features, or you want to run a Kerberos agent on a not supported OS/architecure.","position":{"start":{"line":21,"column":56,"offset":1018},"end":{"line":21,"column":188,"offset":1150},"indent":[]}}],"position":{"start":{"line":21,"column":4,"offset":966},"end":{"line":21,"column":188,"offset":1150},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":963},"end":{"line":21,"column":188,"offset":1150},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":815},"end":{"line":21,"column":188,"offset":1150},"indent":[1]}},{"type":"thematicBreak","position":{"start":{"line":23,"column":1,"offset":1152},"end":{"line":23,"column":4,"offset":1155},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Plug and play","position":{"start":{"line":25,"column":3,"offset":1159},"end":{"line":25,"column":16,"offset":1172},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1157},"end":{"line":25,"column":16,"offset":1172},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Following installation methods aim for the simplicity of installing Kerberos Open Source. With almost no efforts you can have Kerberos Open Source running.","position":{"start":{"line":27,"column":1,"offset":1174},"end":{"line":27,"column":156,"offset":1329},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1174},"end":{"line":27,"column":156,"offset":1329},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"KiOS","position":{"start":{"line":29,"column":4,"offset":1334},"end":{"line":29,"column":8,"offset":1338},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1331},"end":{"line":29,"column":8,"offset":1338},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"KiOS (Kerberos Operating System) is our custom linux OS, which runs the Kerberos agent out-of-the-box (read plug-and-play). It's an OS designed for the Raspberry Pi (all version are supported), which you can flash to an SD card.","position":{"start":{"line":31,"column":1,"offset":1340},"end":{"line":31,"column":229,"offset":1568},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1340},"end":{"line":31,"column":229,"offset":1568},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"It can be installed using our own installer, which comes with a nice interface that handles the flashing and network configuration for you, or you can handle the flashing yourself by using Etcher.","position":{"start":{"line":33,"column":1,"offset":1570},"end":{"line":33,"column":197,"offset":1766},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1570},"end":{"line":33,"column":197,"offset":1766},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Github","position":{"start":{"line":35,"column":5,"offset":1772},"end":{"line":35,"column":11,"offset":1778},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1768},"end":{"line":35,"column":11,"offset":1778},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"KiOS is compiled using Buildroot, the project can be found on ","position":{"start":{"line":37,"column":1,"offset":1780},"end":{"line":37,"column":63,"offset":1842},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/kios","children":[{"type":"text","value":"following Github repo","position":{"start":{"line":37,"column":64,"offset":1843},"end":{"line":37,"column":85,"offset":1864},"indent":[]}}],"position":{"start":{"line":37,"column":63,"offset":1842},"end":{"line":37,"column":123,"offset":1902},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":37,"column":123,"offset":1902},"end":{"line":37,"column":124,"offset":1903},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1780},"end":{"line":37,"column":124,"offset":1903},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Open Source installer","position":{"start":{"line":39,"column":5,"offset":1909},"end":{"line":39,"column":35,"offset":1939},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":1905},"end":{"line":39,"column":35,"offset":1939},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Installing the Kerberos agent to your Raspberry Pi, has never been so easy. By using our cross-platform installer, you can run a fully configured video surveillance system within 3 minutes. Indeed, we also think that's awesome!","position":{"start":{"line":41,"column":1,"offset":1941},"end":{"line":41,"column":228,"offset":2168},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":1941},"end":{"line":41,"column":228,"offset":2168},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kios-install.gif","alt":"access kerberos installer","position":{"start":{"line":43,"column":1,"offset":2170},"end":{"line":43,"column":67,"offset":2236},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2170},"end":{"line":43,"column":67,"offset":2236},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Download the correct installer for your OS below:","position":{"start":{"line":45,"column":1,"offset":2238},"end":{"line":45,"column":50,"offset":2287},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2238},"end":{"line":45,"column":50,"offset":2287},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://github.com/kerberos-io/etcher/releases","children":[{"type":"text","value":"https://github.com/kerberos-io/etcher/releases","position":{"start":{"line":47,"column":3,"offset":2291},"end":{"line":47,"column":49,"offset":2337},"indent":[]}}],"position":{"start":{"line":47,"column":3,"offset":2291},"end":{"line":47,"column":49,"offset":2337},"indent":[]}}],"position":{"start":{"line":47,"column":3,"offset":2291},"end":{"line":47,"column":49,"offset":2337},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2289},"end":{"line":47,"column":49,"offset":2337},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Etcher","position":{"start":{"line":49,"column":5,"offset":2343},"end":{"line":49,"column":11,"offset":2349},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":2339},"end":{"line":49,"column":11,"offset":2349},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you love Etcher, or the Kerberos installer is not working as expected, you can also flash the Kerberos agent to your SD card manually. It goes as following:","position":{"start":{"line":51,"column":1,"offset":2351},"end":{"line":51,"column":160,"offset":2510},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2351},"end":{"line":51,"column":160,"offset":2510},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Download ","position":{"start":{"line":53,"column":4,"offset":2515},"end":{"line":53,"column":13,"offset":2524},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/kios/releases","children":[{"type":"text","value":"the KiOS image","position":{"start":{"line":53,"column":14,"offset":2525},"end":{"line":53,"column":28,"offset":2539},"indent":[]}}],"position":{"start":{"line":53,"column":13,"offset":2524},"end":{"line":53,"column":75,"offset":2586},"indent":[]}},{"type":"text","value":",","position":{"start":{"line":53,"column":75,"offset":2586},"end":{"line":53,"column":76,"offset":2587},"indent":[]}}],"position":{"start":{"line":53,"column":4,"offset":2515},"end":{"line":53,"column":76,"offset":2587},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2512},"end":{"line":53,"column":76,"offset":2587},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"flash it to your SD card with Etcher,","position":{"start":{"line":54,"column":4,"offset":2591},"end":{"line":54,"column":41,"offset":2628},"indent":[]}}],"position":{"start":{"line":54,"column":4,"offset":2591},"end":{"line":54,"column":41,"offset":2628},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":2588},"end":{"line":54,"column":41,"offset":2628},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"and edit some configuration files at the boot directory.","position":{"start":{"line":55,"column":4,"offset":2632},"end":{"line":55,"column":60,"offset":2688},"indent":[]}}],"position":{"start":{"line":55,"column":4,"offset":2632},"end":{"line":55,"column":60,"offset":2688},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2629},"end":{"line":55,"column":60,"offset":2688},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2512},"end":{"line":55,"column":60,"offset":2688},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://www.balena.io/etcher/","children":[{"type":"image","title":null,"url":"../../public/images/etcher-install.png","alt":"use etcher for kios","position":{"start":{"line":57,"column":2,"offset":2691},"end":{"line":57,"column":64,"offset":2753},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2690},"end":{"line":57,"column":96,"offset":2785},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2690},"end":{"line":57,"column":96,"offset":2785},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have download the KiOS image (make sure you downloaded the right image) and flashed it to an SD card, put it back into your working station. Navigate to the SD card and creating following files.","position":{"start":{"line":59,"column":1,"offset":2787},"end":{"line":59,"column":204,"offset":2990},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":2787},"end":{"line":59,"column":204,"offset":2990},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Connecting to WiFi","position":{"start":{"line":61,"column":6,"offset":2997},"end":{"line":61,"column":24,"offset":3015},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":2992},"end":{"line":61,"column":24,"offset":3015},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to connect your Raspberry Pi to a WiFi connection, you will need to create a file ","position":{"start":{"line":63,"column":1,"offset":3017},"end":{"line":63,"column":95,"offset":3111},"indent":[]}},{"type":"inlineCode","value":"wireless.conf","position":{"start":{"line":63,"column":95,"offset":3111},"end":{"line":63,"column":110,"offset":3126},"indent":[]}},{"type":"text","value":" on your SD card, with following contents. Change the SSID and password properties to your own WiFi credentials.","position":{"start":{"line":63,"column":110,"offset":3126},"end":{"line":63,"column":222,"offset":3238},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3017},"end":{"line":63,"column":222,"offset":3238},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"update_config=1\nctrl_interface=/var/run/wpa_supplicant\nnetwork={\n scan_ssid=1\n ssid=\"\"\n psk=\"\"\n}","position":{"start":{"line":65,"column":1,"offset":3240},"end":{"line":73,"column":4,"offset":3349},"indent":[1,1,1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Setup a static IP-address","position":{"start":{"line":75,"column":6,"offset":3356},"end":{"line":75,"column":31,"offset":3381},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3351},"end":{"line":75,"column":31,"offset":3381},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you want to assign a static ip-address to your Raspberry Pi, create a file ","position":{"start":{"line":77,"column":1,"offset":3383},"end":{"line":77,"column":79,"offset":3461},"indent":[]}},{"type":"inlineCode","value":"static_ip.conf","position":{"start":{"line":77,"column":79,"offset":3461},"end":{"line":77,"column":95,"offset":3477},"indent":[]}},{"type":"text","value":" on your SD card, with following contents:","position":{"start":{"line":77,"column":95,"offset":3477},"end":{"line":77,"column":137,"offset":3519},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3383},"end":{"line":77,"column":137,"offset":3519},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"#####################################################################\n# Enter the IP-address you want to have, followed by the subnet mask\n# e.g. 192.168.0.10/24\nstatic_ip=\"\"\n#####################################################################\n# Enter the Gateway and DNS, this will be your router in most cases\n# e.g. 192.168.0.1\nstatic_gw=\"\"\nstatic_dns=\"\"","position":{"start":{"line":79,"column":1,"offset":3521},"end":{"line":89,"column":4,"offset":3889},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Power on the Raspberry Pi","position":{"start":{"line":91,"column":5,"offset":3895},"end":{"line":91,"column":30,"offset":3920},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":3891},"end":{"line":91,"column":30,"offset":3920},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've finished the installation using either the KiOS installer or Etcher, you can put the SD card into your Raspberry Pi and turn it on. Please note that the first time you boot KiOS it can take about 2 mins before the system is operational. When KiOS is ready you can open your favorite browser and type in the IP address of your Raspberry Pi. This will open the Kerberos agent's front-end, which you can access with the username: root and password: root.","position":{"start":{"line":93,"column":1,"offset":3922},"end":{"line":93,"column":464,"offset":4385},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":3922},"end":{"line":93,"column":464,"offset":4385},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/access.png","alt":"access kerberos interface","position":{"start":{"line":95,"column":1,"offset":4387},"end":{"line":95,"column":61,"offset":4447},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4387},"end":{"line":95,"column":61,"offset":4447},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Access the Raspberry Pi","position":{"start":{"line":97,"column":5,"offset":4453},"end":{"line":97,"column":28,"offset":4476},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4449},"end":{"line":97,"column":28,"offset":4476},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can access the KiOS system with attaching your Raspberry Pi to a HDMI monitor or by using ","position":{"start":{"line":99,"column":1,"offset":4478},"end":{"line":99,"column":95,"offset":4572},"indent":[]}},{"type":"inlineCode","value":"ssh","position":{"start":{"line":99,"column":95,"offset":4572},"end":{"line":99,"column":100,"offset":4577},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":99,"column":100,"offset":4577},"end":{"line":99,"column":101,"offset":4578},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4478},"end":{"line":99,"column":101,"offset":4578},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"$ ssh root@192.168.0.12\nWelcome to kios-79e30bbb!\n[root@kios-79e30bbb ~]#","position":{"start":{"line":101,"column":1,"offset":4580},"end":{"line":105,"column":4,"offset":4663},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Note that by default no root password is set, you can define a password in the ","position":{"start":{"line":107,"column":1,"offset":4665},"end":{"line":107,"column":80,"offset":4744},"indent":[]}},{"type":"inlineCode","value":"/data/etc/kios.conf","position":{"start":{"line":107,"column":80,"offset":4744},"end":{"line":107,"column":101,"offset":4765},"indent":[]}},{"type":"text","value":" file. Once you added a password, make sure to reboot the OS.","position":{"start":{"line":107,"column":101,"offset":4765},"end":{"line":107,"column":162,"offset":4826},"indent":[]}}],"position":{"start":{"line":107,"column":1,"offset":4665},"end":{"line":107,"column":162,"offset":4826},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"[root@kios-79e30bbb ~]# nano /data/etc/kios.conf\n[root@kios-79e30bbb ~]# reboot","position":{"start":{"line":109,"column":1,"offset":4828},"end":{"line":112,"column":4,"offset":4917},"indent":[1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Docker","position":{"start":{"line":114,"column":4,"offset":4922},"end":{"line":114,"column":10,"offset":4928},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":4919},"end":{"line":114,"column":10,"offset":4928},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A Docker image (amd64, armv7, arm64) is available on ","position":{"start":{"line":116,"column":1,"offset":4930},"end":{"line":116,"column":54,"offset":4983},"indent":[]}},{"type":"link","title":null,"url":"https://hub.docker.com/u/kerberos","children":[{"type":"text","value":"the Docker hub","position":{"start":{"line":116,"column":55,"offset":4984},"end":{"line":116,"column":69,"offset":4998},"indent":[]}}],"position":{"start":{"line":116,"column":54,"offset":4983},"end":{"line":116,"column":105,"offset":5034},"indent":[]}},{"type":"text","value":", which contains all the necessary software to setup the Kerberos agent in a matter of seconds. Before you can run this image, make sure you have Docker installed. Afterwards you can use Docker, to get the Kerberos agent up and running. All Docker images can be found on ","position":{"start":{"line":116,"column":105,"offset":5034},"end":{"line":116,"column":376,"offset":5305},"indent":[]}},{"type":"link","title":null,"url":"https://hub.docker.com/u/kerberos","children":[{"type":"text","value":"the Docker hub","position":{"start":{"line":116,"column":377,"offset":5306},"end":{"line":116,"column":391,"offset":5320},"indent":[]}}],"position":{"start":{"line":116,"column":376,"offset":5305},"end":{"line":116,"column":427,"offset":5356},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":116,"column":427,"offset":5356},"end":{"line":116,"column":428,"offset":5357},"indent":[]}}],"position":{"start":{"line":116,"column":1,"offset":4930},"end":{"line":116,"column":428,"offset":5357},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This installation guide assumes you already have a good understanding of Docker. If you want to learn more about Kerberos.io on Docker, have a look at these tutorials.","position":{"start":{"line":118,"column":1,"offset":5359},"end":{"line":118,"column":168,"offset":5526},"indent":[]}}],"position":{"start":{"line":118,"column":1,"offset":5359},"end":{"line":118,"column":168,"offset":5526},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://medium.com/@cedricverst/kerberos-io-the-road-to-docker-8e048a480241","children":[{"type":"text","value":"Kerberos.io — the road to Docker","position":{"start":{"line":119,"column":4,"offset":5530},"end":{"line":119,"column":36,"offset":5562},"indent":[]}}],"position":{"start":{"line":119,"column":3,"offset":5529},"end":{"line":119,"column":114,"offset":5640},"indent":[]}}],"position":{"start":{"line":119,"column":3,"offset":5529},"end":{"line":119,"column":114,"offset":5640},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":5527},"end":{"line":119,"column":114,"offset":5640},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://medium.com/@cedricverst/kerberos-io-on-docker-19b25fa7efd1","children":[{"type":"text","value":"Kerberos.io on Docker","position":{"start":{"line":120,"column":4,"offset":5644},"end":{"line":120,"column":25,"offset":5665},"indent":[]}}],"position":{"start":{"line":120,"column":3,"offset":5643},"end":{"line":120,"column":94,"offset":5734},"indent":[]}}],"position":{"start":{"line":120,"column":3,"offset":5643},"end":{"line":120,"column":94,"offset":5734},"indent":[]}}],"position":{"start":{"line":120,"column":1,"offset":5641},"end":{"line":120,"column":94,"offset":5734},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":5527},"end":{"line":120,"column":94,"offset":5734},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":123,"column":5,"offset":5741},"end":{"line":123,"column":18,"offset":5754},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":5737},"end":{"line":123,"column":18,"offset":5754},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"Docker or Docker Desktop (Linux, OS or Windows)","position":{"start":{"line":125,"column":3,"offset":5758},"end":{"line":125,"column":50,"offset":5805},"indent":[]}}],"position":{"start":{"line":125,"column":3,"offset":5758},"end":{"line":125,"column":50,"offset":5805},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":5756},"end":{"line":125,"column":50,"offset":5805},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Github","position":{"start":{"line":127,"column":5,"offset":5811},"end":{"line":127,"column":11,"offset":5817},"indent":[]}}],"position":{"start":{"line":127,"column":1,"offset":5807},"end":{"line":127,"column":11,"offset":5817},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"All technical information, such as Dockerfile, can be found on ","position":{"start":{"line":129,"column":1,"offset":5819},"end":{"line":129,"column":64,"offset":5882},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/docker","children":[{"type":"text","value":"following Github repo","position":{"start":{"line":129,"column":65,"offset":5883},"end":{"line":129,"column":86,"offset":5904},"indent":[]}}],"position":{"start":{"line":129,"column":64,"offset":5882},"end":{"line":129,"column":126,"offset":5944},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":129,"column":126,"offset":5944},"end":{"line":129,"column":127,"offset":5945},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":5819},"end":{"line":129,"column":127,"offset":5945},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Download docker image","position":{"start":{"line":131,"column":5,"offset":5951},"end":{"line":131,"column":26,"offset":5972},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":5947},"end":{"line":131,"column":26,"offset":5972},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before you are able to run the Kerberos agent inside a container, you will need to pull the docker image from the Docker hub.","position":{"start":{"line":133,"column":1,"offset":5974},"end":{"line":133,"column":126,"offset":6099},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":5974},"end":{"line":133,"column":126,"offset":6099},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"docker pull kerberos/kerberos","position":{"start":{"line":135,"column":1,"offset":6101},"end":{"line":137,"column":4,"offset":6140},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"When you pulled succesfully you can run your first Kerberos container as following. This will run Kerberos agent and expose the web interface on port 80, and the livestream on port 8889.","position":{"start":{"line":139,"column":1,"offset":6142},"end":{"line":139,"column":187,"offset":6328},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":6142},"end":{"line":139,"column":187,"offset":6328},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"docker run --name camera1 -p 80:80 -p 8889:8889 -d kerberos/kerberos","position":{"start":{"line":141,"column":1,"offset":6330},"end":{"line":143,"column":4,"offset":6408},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"To add more containers, you can change the name parameter and assign another port to expose the web interface and livestream (ports are unique on a OS).","position":{"start":{"line":145,"column":1,"offset":6410},"end":{"line":145,"column":153,"offset":6562},"indent":[]}}],"position":{"start":{"line":145,"column":1,"offset":6410},"end":{"line":145,"column":153,"offset":6562},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"docker run --name camera2 -p 81:80 -p 8890:8889 -d kerberos/kerberos\ndocker run --name camera3 -p 82:80 -p 8891:8889 -d kerberos/kerberos","position":{"start":{"line":147,"column":1,"offset":6564},"end":{"line":150,"column":4,"offset":6711},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"When the containers are created, you can open your browser and browse to your different containers.","position":{"start":{"line":152,"column":1,"offset":6713},"end":{"line":152,"column":100,"offset":6812},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":6713},"end":{"line":152,"column":100,"offset":6812},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"http://localhost:80\nhttp://localhost:81\nhttp://localhost:82","position":{"start":{"line":153,"column":1,"offset":6813},"end":{"line":157,"column":4,"offset":6882},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Volumes","position":{"start":{"line":159,"column":5,"offset":6888},"end":{"line":159,"column":12,"offset":6895},"indent":[]}}],"position":{"start":{"line":159,"column":1,"offset":6884},"end":{"line":159,"column":12,"offset":6895},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Instead of just running the Kerberos container, you can also persist your configuration by assigning volumes. An example of mounting volumes looks like this; an overview of ","position":{"start":{"line":161,"column":1,"offset":6897},"end":{"line":161,"column":174,"offset":7070},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/docker/blob/master/Dockerfile#L171-L177","children":[{"type":"text","value":"the different volumes can be found here","position":{"start":{"line":161,"column":175,"offset":7071},"end":{"line":161,"column":214,"offset":7110},"indent":[]}}],"position":{"start":{"line":161,"column":174,"offset":7070},"end":{"line":161,"column":287,"offset":7183},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":161,"column":287,"offset":7183},"end":{"line":161,"column":288,"offset":7184},"indent":[]}}],"position":{"start":{"line":161,"column":1,"offset":6897},"end":{"line":161,"column":288,"offset":7184},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"preload configuration,","position":{"start":{"line":163,"column":3,"offset":7188},"end":{"line":163,"column":25,"offset":7210},"indent":[]}}],"position":{"start":{"line":163,"column":3,"offset":7188},"end":{"line":163,"column":25,"offset":7210},"indent":[]}}],"position":{"start":{"line":163,"column":1,"offset":7186},"end":{"line":163,"column":25,"offset":7210},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"or centralise the images/videos on your working station.","position":{"start":{"line":164,"column":3,"offset":7213},"end":{"line":164,"column":59,"offset":7269},"indent":[]}}],"position":{"start":{"line":164,"column":3,"offset":7213},"end":{"line":164,"column":59,"offset":7269},"indent":[]}}],"position":{"start":{"line":164,"column":1,"offset":7211},"end":{"line":164,"column":59,"offset":7269},"indent":[]}}],"position":{"start":{"line":163,"column":1,"offset":7186},"end":{"line":164,"column":59,"offset":7269},"indent":[1]}},{"type":"code","lang":"ts","meta":null,"value":"docker run --name kerberos-camera1 \\\n-p 80:80 -p 8889:8889 \\\n-v ~/config:/etc/opt/kerberosio/config \\\n-v ~/capture:/etc/opt/kerberosio/capture \\\n-v ~/logs:/etc/opt/kerberosio/logs \\\n-v ~/webconfig:/var/www/web/config \\\n-d kerberos/kerberos","position":{"start":{"line":166,"column":1,"offset":7271},"end":{"line":174,"column":4,"offset":7520},"indent":[1,1,1,1,1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Balena","position":{"start":{"line":176,"column":4,"offset":7525},"end":{"line":176,"column":10,"offset":7531},"indent":[]}}],"position":{"start":{"line":176,"column":1,"offset":7522},"end":{"line":176,"column":10,"offset":7531},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Running Kerberos inside a Docker container is great, it makes it possible to run Kerberos everywhere; basically on any OS. You can deploy Kerberos easily to the many different IoT boards we nowadays have available. The challenge with all these IoT boards is that they have different system architecures, however thanks to Docker (and its multi architecture builds), we can ship Kerberos to any of them. If you have a Raspberry Pi, you have two options: ","position":{"start":{"line":178,"column":1,"offset":7533},"end":{"line":178,"column":454,"offset":7986},"indent":[]}},{"type":"link","title":null,"url":"/opensource/installation#docker","children":[{"type":"text","value":"Docker","position":{"start":{"line":178,"column":455,"offset":7987},"end":{"line":178,"column":461,"offset":7993},"indent":[]}}],"position":{"start":{"line":178,"column":454,"offset":7986},"end":{"line":178,"column":495,"offset":8027},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":178,"column":495,"offset":8027},"end":{"line":178,"column":500,"offset":8032},"indent":[]}},{"type":"link","title":null,"url":"/opensource/installation#kios","children":[{"type":"text","value":"KiOS","position":{"start":{"line":178,"column":501,"offset":8033},"end":{"line":178,"column":505,"offset":8037},"indent":[]}}],"position":{"start":{"line":178,"column":500,"offset":8032},"end":{"line":178,"column":537,"offset":8069},"indent":[]}},{"type":"text","value":". If you have any other board, then ","position":{"start":{"line":178,"column":537,"offset":8069},"end":{"line":178,"column":573,"offset":8105},"indent":[]}},{"type":"link","title":null,"url":"/opensource/installation#docker","children":[{"type":"text","value":"Docker","position":{"start":{"line":178,"column":574,"offset":8106},"end":{"line":178,"column":580,"offset":8112},"indent":[]}}],"position":{"start":{"line":178,"column":573,"offset":8105},"end":{"line":178,"column":614,"offset":8146},"indent":[]}},{"type":"text","value":" is the way to go.","position":{"start":{"line":178,"column":614,"offset":8146},"end":{"line":178,"column":632,"offset":8164},"indent":[]}}],"position":{"start":{"line":178,"column":1,"offset":7533},"end":{"line":178,"column":632,"offset":8164},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've deployed the Kerberos Docker container, you can start monitoring your video surveillances cameras, however it doesn't have to stop here. Probably you also want remote access to your IoT board, and maybe some other cool stuff like system control, a VPN, a public url? This is where ","position":{"start":{"line":180,"column":1,"offset":8166},"end":{"line":180,"column":294,"offset":8459},"indent":[]}},{"type":"link","title":null,"url":"https://balena.io","children":[{"type":"text","value":"Balena.io","position":{"start":{"line":180,"column":295,"offset":8460},"end":{"line":180,"column":304,"offset":8469},"indent":[]}}],"position":{"start":{"line":180,"column":294,"offset":8459},"end":{"line":180,"column":324,"offset":8489},"indent":[]}},{"type":"text","value":" comes in.","position":{"start":{"line":180,"column":324,"offset":8489},"end":{"line":180,"column":334,"offset":8499},"indent":[]}}],"position":{"start":{"line":180,"column":1,"offset":8166},"end":{"line":180,"column":334,"offset":8499},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before getting into the details, you can ","position":{"start":{"line":182,"column":1,"offset":8501},"end":{"line":182,"column":42,"offset":8542},"indent":[]}},{"type":"link","title":null,"url":"https://medium.com/@cedricverst/kerberos-io-on-balenacloud-7d5a5dd68992","children":[{"type":"text","value":"find a more detailed tutorial at this blog","position":{"start":{"line":182,"column":43,"offset":8543},"end":{"line":182,"column":85,"offset":8585},"indent":[]}}],"position":{"start":{"line":182,"column":42,"offset":8542},"end":{"line":182,"column":159,"offset":8659},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":182,"column":159,"offset":8659},"end":{"line":182,"column":160,"offset":8660},"indent":[]}}],"position":{"start":{"line":182,"column":1,"offset":8501},"end":{"line":182,"column":160,"offset":8660},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"1. Create a Balena account","position":{"start":{"line":184,"column":5,"offset":8666},"end":{"line":184,"column":31,"offset":8692},"indent":[]}}],"position":{"start":{"line":184,"column":1,"offset":8662},"end":{"line":184,"column":31,"offset":8692},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before moving on, make sure you have registered on ","position":{"start":{"line":186,"column":1,"offset":8694},"end":{"line":186,"column":52,"offset":8745},"indent":[]}},{"type":"link","title":null,"url":"https://www.balena.io","children":[{"type":"text","value":"Balena","position":{"start":{"line":186,"column":53,"offset":8746},"end":{"line":186,"column":59,"offset":8752},"indent":[]}}],"position":{"start":{"line":186,"column":52,"offset":8745},"end":{"line":186,"column":83,"offset":8776},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":186,"column":83,"offset":8776},"end":{"line":186,"column":84,"offset":8777},"indent":[]}}],"position":{"start":{"line":186,"column":1,"offset":8694},"end":{"line":186,"column":84,"offset":8777},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-balena-signup.png","alt":"Signup balena","position":{"start":{"line":188,"column":1,"offset":8779},"end":{"line":188,"column":87,"offset":8865},"indent":[]}}],"position":{"start":{"line":188,"column":1,"offset":8779},"end":{"line":188,"column":87,"offset":8865},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"2. Create a device and flash","position":{"start":{"line":190,"column":5,"offset":8871},"end":{"line":190,"column":33,"offset":8899},"indent":[]}}],"position":{"start":{"line":190,"column":1,"offset":8867},"end":{"line":190,"column":33,"offset":8899},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After you signed up, you can create an application for a specific IoT board (e.g. Raspberry Pi 3). Once created you will be able to download the balena OS image, which you can flash to your SD card using ","position":{"start":{"line":192,"column":1,"offset":8901},"end":{"line":192,"column":205,"offset":9105},"indent":[]}},{"type":"link","title":null,"url":"https://www.balena.io/etcher/","children":[{"type":"text","value":"Etcher","position":{"start":{"line":192,"column":206,"offset":9106},"end":{"line":192,"column":212,"offset":9112},"indent":[]}}],"position":{"start":{"line":192,"column":205,"offset":9105},"end":{"line":192,"column":244,"offset":9144},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":192,"column":244,"offset":9144},"end":{"line":192,"column":245,"offset":9145},"indent":[]}}],"position":{"start":{"line":192,"column":1,"offset":8901},"end":{"line":192,"column":245,"offset":9145},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-balena-create.png","alt":"Create device balena","position":{"start":{"line":194,"column":1,"offset":9147},"end":{"line":194,"column":94,"offset":9240},"indent":[]}}],"position":{"start":{"line":194,"column":1,"offset":9147},"end":{"line":194,"column":94,"offset":9240},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"3. Connect","position":{"start":{"line":196,"column":5,"offset":9246},"end":{"line":196,"column":15,"offset":9256},"indent":[]}}],"position":{"start":{"line":196,"column":1,"offset":9242},"end":{"line":196,"column":15,"offset":9256},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've flashed the balena OS, turned on your IoT board, a new device should come up on the Balena dashboard (below the application you've created). At this point you will be able to connect to your device using the ","position":{"start":{"line":198,"column":1,"offset":9258},"end":{"line":198,"column":221,"offset":9478},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"balena-cli","position":{"start":{"line":198,"column":223,"offset":9480},"end":{"line":198,"column":233,"offset":9490},"indent":[]}}],"position":{"start":{"line":198,"column":221,"offset":9478},"end":{"line":198,"column":235,"offset":9492},"indent":[]}},{"type":"text","value":" ","position":{"start":{"line":198,"column":235,"offset":9492},"end":{"line":198,"column":236,"offset":9493},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/balena-io/balena-cli/blob/master/INSTALL.md#executable-installer","children":[{"type":"text","value":"read more about the installation here","position":{"start":{"line":198,"column":237,"offset":9494},"end":{"line":198,"column":274,"offset":9531},"indent":[]}}],"position":{"start":{"line":198,"column":236,"offset":9493},"end":{"line":198,"column":360,"offset":9617},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":198,"column":360,"offset":9617},"end":{"line":198,"column":361,"offset":9618},"indent":[]}}],"position":{"start":{"line":198,"column":1,"offset":9258},"end":{"line":198,"column":361,"offset":9618},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"First connect the ","position":{"start":{"line":200,"column":1,"offset":9620},"end":{"line":200,"column":19,"offset":9638},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"balena-cli","position":{"start":{"line":200,"column":21,"offset":9640},"end":{"line":200,"column":31,"offset":9650},"indent":[]}}],"position":{"start":{"line":200,"column":19,"offset":9638},"end":{"line":200,"column":33,"offset":9652},"indent":[]}},{"type":"text","value":" to your account by executing following command. Choose the recommended option.","position":{"start":{"line":200,"column":33,"offset":9652},"end":{"line":200,"column":112,"offset":9731},"indent":[]}}],"position":{"start":{"line":200,"column":1,"offset":9620},"end":{"line":200,"column":112,"offset":9731},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"balena login","position":{"start":{"line":202,"column":1,"offset":9733},"end":{"line":202,"column":17,"offset":9749},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After succesfully logged in you should be able to list your devices.","position":{"start":{"line":204,"column":1,"offset":9751},"end":{"line":204,"column":69,"offset":9819},"indent":[]}}],"position":{"start":{"line":204,"column":1,"offset":9751},"end":{"line":204,"column":69,"offset":9819},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"balena devices","position":{"start":{"line":206,"column":1,"offset":9821},"end":{"line":206,"column":19,"offset":9839},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"4. Write","position":{"start":{"line":208,"column":5,"offset":9845},"end":{"line":208,"column":13,"offset":9853},"indent":[]}}],"position":{"start":{"line":208,"column":1,"offset":9841},"end":{"line":208,"column":13,"offset":9853},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Finally, we can push our Kerberos Docker container to our application (and devices). To do this we need to create two files.","position":{"start":{"line":210,"column":1,"offset":9855},"end":{"line":210,"column":125,"offset":9979},"indent":[]}}],"position":{"start":{"line":210,"column":1,"offset":9855},"end":{"line":210,"column":125,"offset":9979},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Create a new directory and the Dockerfile.","position":{"start":{"line":212,"column":4,"offset":9984},"end":{"line":212,"column":46,"offset":10026},"indent":[]}}],"position":{"start":{"line":212,"column":4,"offset":9984},"end":{"line":212,"column":46,"offset":10026},"indent":[]}}],"position":{"start":{"line":212,"column":1,"offset":9981},"end":{"line":212,"column":46,"offset":10026},"indent":[]}}],"position":{"start":{"line":212,"column":1,"offset":9981},"end":{"line":212,"column":46,"offset":10026},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The first file is named ","position":{"start":{"line":214,"column":1,"offset":10028},"end":{"line":214,"column":25,"offset":10052},"indent":[]}},{"type":"inlineCode","value":"Dockerfile","position":{"start":{"line":214,"column":25,"offset":10052},"end":{"line":214,"column":37,"offset":10064},"indent":[]}},{"type":"text","value":" this file will contain a base image which references to our Kerberos image, which ","position":{"start":{"line":214,"column":37,"offset":10064},"end":{"line":214,"column":120,"offset":10147},"indent":[]}},{"type":"link","title":null,"url":"https://hub.docker.com/repository/docker/kerberos/kerberos/tags?page=1","children":[{"type":"text","value":"you can find here","position":{"start":{"line":214,"column":121,"offset":10148},"end":{"line":214,"column":138,"offset":10165},"indent":[]}}],"position":{"start":{"line":214,"column":120,"offset":10147},"end":{"line":214,"column":211,"offset":10238},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":214,"column":211,"offset":10238},"end":{"line":214,"column":212,"offset":10239},"indent":[]}}],"position":{"start":{"line":214,"column":1,"offset":10028},"end":{"line":214,"column":212,"offset":10239},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"mkdir kerberosbalena\ncd kerberosbalena\necho 'FROM kerberos/kerberos@sha256:70a8b2791c8605ca6f8442b3d7892bb9bfc0789ab2f9f68911e247f7af50caed\nCMD [\"bash\", \"/run.sh\"]' > Dockerfile","position":{"start":{"line":216,"column":1,"offset":10241},"end":{"line":219,"column":42,"offset":10434},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Please note that we specified a sha256 tag, you have to make sure you use the right sha256 tag for your architecure. In the example above we use the sha256 tag for a armv7 architecture (Raspberry Pi3).","position":{"start":{"line":221,"column":1,"offset":10436},"end":{"line":221,"column":202,"offset":10637},"indent":[]}}],"position":{"start":{"line":221,"column":1,"offset":10436},"end":{"line":221,"column":202,"offset":10637},"indent":[]}},{"type":"list","ordered":true,"start":2,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Create a Docker compose file.","position":{"start":{"line":223,"column":4,"offset":10642},"end":{"line":223,"column":33,"offset":10671},"indent":[]}}],"position":{"start":{"line":223,"column":4,"offset":10642},"end":{"line":223,"column":33,"offset":10671},"indent":[]}}],"position":{"start":{"line":223,"column":1,"offset":10639},"end":{"line":223,"column":33,"offset":10671},"indent":[]}}],"position":{"start":{"line":223,"column":1,"offset":10639},"end":{"line":223,"column":33,"offset":10671},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Docker compose file is optional, but can be very useful. It can be used to deploy multi container application (e.g. a webserver + database). As Kerberos has everything in one single container, this is not needed.","position":{"start":{"line":225,"column":1,"offset":10673},"end":{"line":225,"column":217,"offset":10889},"indent":[]}}],"position":{"start":{"line":225,"column":1,"offset":10673},"end":{"line":225,"column":217,"offset":10889},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"We will use the `docker-compose.yml to mount volumes, so that when we restart our container all our configurations and recordings stay persisted.","position":{"start":{"line":227,"column":1,"offset":10891},"end":{"line":227,"column":146,"offset":11036},"indent":[]}}],"position":{"start":{"line":227,"column":1,"offset":10891},"end":{"line":227,"column":146,"offset":11036},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Create a new file named ","position":{"start":{"line":229,"column":1,"offset":11038},"end":{"line":229,"column":25,"offset":11062},"indent":[]}},{"type":"inlineCode","value":"docker-compose.yml","position":{"start":{"line":229,"column":25,"offset":11062},"end":{"line":229,"column":45,"offset":11082},"indent":[]}},{"type":"text","value":", and copy-paste following content.","position":{"start":{"line":229,"column":45,"offset":11082},"end":{"line":229,"column":80,"offset":11117},"indent":[]}}],"position":{"start":{"line":229,"column":1,"offset":11038},"end":{"line":229,"column":80,"offset":11117},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"version: '2.1'\nnetworks: {}\nvolumes:\n config: {}\n capture: {}\n logs: {}\n web: {}\nservices:\n main:\n build:\n context: .\n privileged: true\n tty: true\n restart: always\n network_mode: host\n volumes:\n - 'config:/etc/opt/kerberosio/config'\n - 'capture:/etc/opt/kerberosio/capture'\n - 'logs:/etc/opt/kerberosio/logs'\n - 'web:/var/www/web/config'\n labels:\n io.balena.features.kernel-modules: '1'\n io.balena.features.firmware: '1'\n io.balena.features.dbus: '1'\n io.balena.features.supervisor-api: '1'\n io.balena.features.resin-api: '1'\n io.balena.features.balena-socket: '1'","position":{"start":{"line":231,"column":1,"offset":11119},"end":{"line":257,"column":48,"offset":11872},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"5. Push","position":{"start":{"line":259,"column":5,"offset":11878},"end":{"line":259,"column":12,"offset":11885},"indent":[]}}],"position":{"start":{"line":259,"column":1,"offset":11874},"end":{"line":259,"column":12,"offset":11885},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Now we created our two files, we can publish the Kerberos container to balena (our application), by executing the push command (replace by the name of your application).","position":{"start":{"line":261,"column":1,"offset":11887},"end":{"line":261,"column":189,"offset":12075},"indent":[]}}],"position":{"start":{"line":261,"column":1,"offset":11887},"end":{"line":261,"column":189,"offset":12075},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"balena push ","position":{"start":{"line":263,"column":1,"offset":12077},"end":{"line":263,"column":35,"offset":12111},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once finished you should see following message, and on the dashboard you should see your devices updating (Yes you can add multiple devices to an application). You're ready ;)","position":{"start":{"line":265,"column":1,"offset":12113},"end":{"line":265,"column":176,"offset":12288},"indent":[]}}],"position":{"start":{"line":265,"column":1,"offset":12113},"end":{"line":265,"column":176,"offset":12288},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/opensource/kerberos-opensource-balena-push.png","alt":"Push to balena","position":{"start":{"line":267,"column":1,"offset":12290},"end":{"line":267,"column":86,"offset":12375},"indent":[]}}],"position":{"start":{"line":267,"column":1,"offset":12290},"end":{"line":267,"column":86,"offset":12375},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":270,"column":1,"offset":12378},"end":{"line":270,"column":31,"offset":12408},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":270,"column":31,"offset":12408}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Installation`}

\n

{`Kerberos Open Source comes with different installation flavours. So you might think, why? The reason is simple, depending on the use case one option is better than another. A short list of recommendations:`}

\n

{`Plug and play`}

\n
    \n
  1. {`KiOS`}{`: You have a Raspberry Pi, and you only want to run a Kerberos agent on it.`}
    2. \n
  2. {`Docker`}{`: You have a lot of IP cameras, and/or don't want to mess with dependencies.`}
    3. \n
  3. {`Balena`}{`: Runnning the Kerberos Docker container on top of Balena.`}
    4. \n
\n

{`Advanced`}

\n
    \n
  1. {`Raspbian`}{`: You have a Raspberry Pi, but you want other services running next to the Kerberos agent.`}
    2. \n
  2. {`Generic`}{`: You want to develop/extend Kerberos with your own features, or you want to run a Kerberos agent on a not supported OS/architecure.`}
    3. \n
\n
\n

{`Plug and play`}

\n

{`Following installation methods aim for the simplicity of installing Kerberos Open Source. With almost no efforts you can have Kerberos Open Source running.`}

\n

{`KiOS`}

\n

{`KiOS (Kerberos Operating System) is our custom linux OS, which runs the Kerberos agent out-of-the-box (read plug-and-play). It's an OS designed for the Raspberry Pi (all version are supported), which you can flash to an SD card.`}

\n

{`It can be installed using our own installer, which comes with a nice interface that handles the flashing and network configuration for you, or you can handle the flashing yourself by using Etcher.`}

\n

{`Github`}

\n

{`KiOS is compiled using Buildroot, the project can be found on `}{`following Github repo`}{`.`}

\n

{`Kerberos Open Source installer`}

\n

{`Installing the Kerberos agent to your Raspberry Pi, has never been so easy. By using our cross-platform installer, you can run a fully configured video surveillance system within 3 minutes. Indeed, we also think that's awesome!`}

\n

\"access

\n

{`Download the correct installer for your OS below:`}

\n
\n

{`https://github.com/kerberos-io/etcher/releases`}

\n
\n

{`Etcher`}

\n

{`If you love Etcher, or the Kerberos installer is not working as expected, you can also flash the Kerberos agent to your SD card manually. It goes as following:`}

\n
    \n
  1. {`Download `}{`the KiOS image`}{`,`}
    2. \n
  2. {`flash it to your SD card with Etcher,`}
    3. \n
  3. {`and edit some configuration files at the boot directory.`}
    4. \n
\n

\"use

\n

{`Once you have download the KiOS image (make sure you downloaded the right image) and flashed it to an SD card, put it back into your working station. Navigate to the SD card and creating following files.`}

\n

{`Connecting to WiFi`}

\n

{`If you want to connect your Raspberry Pi to a WiFi connection, you will need to create a file `}{`wireless.conf`}{` on your SD card, with following contents. Change the SSID and password properties to your own WiFi credentials.`}

\n 
{`update_config`}{`=`}{`1`}{`\n`}{`ctrl_interface`}{`=/`}{`var`}{`/`}{`run`}{`/wpa_supplicant`}{`\n`}{`network`}{`={`}{`\n`}{`  `}{`scan_ssid`}{`=`}{`1`}{`\n`}{`  `}{`ssid`}{`=`}{`\"\"`}{`\n`}{`  `}{`psk`}{`=`}{`\"\"`}{`\n`}{`}`}
\n

{`Setup a static IP-address`}

\n

{`If you want to assign a static ip-address to your Raspberry Pi, create a file `}{`static_ip.conf`}{` on your SD card, with following contents:`}

\n 
{`#####################################################################`}{`\n`}{`# `}{`Enter`}{` `}{`the`}{` `}{`IP`}{`-`}{`address`}{` `}{`you`}{` `}{`want`}{` `}{`to`}{` `}{`have`}{`, `}{`followed`}{` `}{`by`}{` `}{`the`}{` `}{`subnet`}{` `}{`mask`}{`\n`}{`# `}{`e`}{`.`}{`g`}{`. `}{`192.168`}{`.`}{`0.10`}{`/`}{`24`}{`\n`}{`static_ip`}{`=`}{`\"\"`}{`\n`}{`#####################################################################`}{`\n`}{`# `}{`Enter`}{` `}{`the`}{` `}{`Gateway`}{` `}{`and`}{` `}{`DNS`}{`, `}{`this`}{` `}{`will`}{` `}{`be`}{` `}{`your`}{` `}{`router`}{` `}{`in`}{` `}{`most`}{` `}{`cases`}{`\n`}{`# `}{`e`}{`.`}{`g`}{`. `}{`192.168`}{`.`}{`0.1`}{`\n`}{`static_gw`}{`=`}{`\"\"`}{`\n`}{`static_dns`}{`=`}{`\"\"`}
\n

{`Power on the Raspberry Pi`}

\n

{`Once you've finished the installation using either the KiOS installer or Etcher, you can put the SD card into your Raspberry Pi and turn it on. Please note that the first time you boot KiOS it can take about 2 mins before the system is operational. When KiOS is ready you can open your favorite browser and type in the IP address of your Raspberry Pi. This will open the Kerberos agent's front-end, which you can access with the username: root and password: root.`}

\n

\"access

\n

{`Access the Raspberry Pi`}

\n

{`You can access the KiOS system with attaching your Raspberry Pi to a HDMI monitor or by using `}{`ssh`}{`.`}

\n 
{`$`}{` `}{`ssh`}{` `}{`root`}{`@`}{`192.168`}{`.`}{`0.12`}{`\n`}{`Welcome`}{` `}{`to`}{` `}{`kios`}{`-79`}{`e30bbb`}{`!`}{`\n`}{`[`}{`root`}{`@`}{`kios`}{`-79`}{`e30bbb`}{` ~]#`}
\n

{`Note that by default no root password is set, you can define a password in the `}{`/data/etc/kios.conf`}{` file. Once you added a password, make sure to reboot the OS.`}

\n 
{`[`}{`root`}{`@`}{`kios`}{`-79`}{`e30bbb`}{` ~]# `}{`nano`}{` /`}{`data`}{`/`}{`etc`}{`/`}{`kios`}{`.`}{`conf`}{`\n`}{`[`}{`root`}{`@`}{`kios`}{`-79`}{`e30bbb`}{` ~]# `}{`reboot`}
\n

{`Docker`}

\n

{`A Docker image (amd64, armv7, arm64) is available on `}{`the Docker hub`}{`, which contains all the necessary software to setup the Kerberos agent in a matter of seconds. Before you can run this image, make sure you have Docker installed. Afterwards you can use Docker, to get the Kerberos agent up and running. All Docker images can be found on `}{`the Docker hub`}{`.`}

\n

{`This installation guide assumes you already have a good understanding of Docker. If you want to learn more about Kerberos.io on Docker, have a look at these tutorials.`}

\n \n

{`Prerequisites`}

\n
\n

{`Docker or Docker Desktop (Linux, OS or Windows)`}

\n
\n

{`Github`}

\n

{`All technical information, such as Dockerfile, can be found on `}{`following Github repo`}{`.`}

\n

{`Download docker image`}

\n

{`Before you are able to run the Kerberos agent inside a container, you will need to pull the docker image from the Docker hub.`}

\n 
{`docker`}{` `}{`pull`}{` `}{`kerberos`}{`/`}{`kerberos`}
\n

{`When you pulled succesfully you can run your first Kerberos container as following. This will run Kerberos agent and expose the web interface on port 80, and the livestream on port 8889.`}

\n 
{`docker`}{` `}{`run`}{` --`}{`name`}{` `}{`camera1`}{` -`}{`p`}{` `}{`80`}{`:`}{`80`}{` -`}{`p`}{` `}{`8889`}{`:`}{`8889`}{` -`}{`d`}{` `}{`kerberos`}{`/`}{`kerberos`}
\n

{`To add more containers, you can change the name parameter and assign another port to expose the web interface and livestream (ports are unique on a OS).`}

\n 
{`docker`}{` `}{`run`}{` --`}{`name`}{` `}{`camera2`}{` -`}{`p`}{` `}{`81`}{`:`}{`80`}{` -`}{`p`}{` `}{`8890`}{`:`}{`8889`}{` -`}{`d`}{` `}{`kerberos`}{`/`}{`kerberos`}{`\n`}{`docker`}{` `}{`run`}{` --`}{`name`}{` `}{`camera3`}{` -`}{`p`}{` `}{`82`}{`:`}{`80`}{` -`}{`p`}{` `}{`8891`}{`:`}{`8889`}{` -`}{`d`}{` `}{`kerberos`}{`/`}{`kerberos`}
\n

{`When the containers are created, you can open your browser and browse to your different containers.`}

\n 
{`http:`}{`//localhost:80`}{`\n`}{`http:`}{`//localhost:81`}{`\n`}{`http:`}{`//localhost:82`}
\n

{`Volumes`}

\n

{`Instead of just running the Kerberos container, you can also persist your configuration by assigning volumes. An example of mounting volumes looks like this; an overview of `}{`the different volumes can be found here`}{`.`}

\n
    \n
  • {`preload configuration,`}
    • \n
  • {`or centralise the images/videos on your working station.`}
    • \n
\n 
{`docker`}{` `}{`run`}{` --`}{`name`}{` `}{`kerberos`}{`-`}{`camera1`}{` \\\\`}{`\n`}{`-`}{`p`}{` `}{`80`}{`:`}{`80`}{` -`}{`p`}{` `}{`8889`}{`:`}{`8889`}{` \\\\`}{`\n`}{`-`}{`v`}{` ~/config:/`}{`etc`}{`/`}{`opt`}{`/`}{`kerberosio`}{`/`}{`config`}{` \\\\`}{`\n`}{`-`}{`v`}{` ~/capture:/`}{`etc`}{`/`}{`opt`}{`/`}{`kerberosio`}{`/`}{`capture`}{` \\\\`}{`\n`}{`-`}{`v`}{` ~/logs:/`}{`etc`}{`/`}{`opt`}{`/`}{`kerberosio`}{`/`}{`logs`}{` \\\\`}{`\n`}{`-`}{`v`}{` ~/webconfig:/`}{`var`}{`/`}{`www`}{`/web/config \\\\`}{`\n`}{`-`}{`d`}{` `}{`kerberos`}{`/`}{`kerberos`}
\n

{`Balena`}

\n

{`Running Kerberos inside a Docker container is great, it makes it possible to run Kerberos everywhere; basically on any OS. You can deploy Kerberos easily to the many different IoT boards we nowadays have available. The challenge with all these IoT boards is that they have different system architecures, however thanks to Docker (and its multi architecture builds), we can ship Kerberos to any of them. If you have a Raspberry Pi, you have two options: `}{`Docker`}{` and `}{`KiOS`}{`. If you have any other board, then `}{`Docker`}{` is the way to go.`}

\n

{`Once you've deployed the Kerberos Docker container, you can start monitoring your video surveillances cameras, however it doesn't have to stop here. Probably you also want remote access to your IoT board, and maybe some other cool stuff like system control, a VPN, a public url? This is where `}{`Balena.io`}{` comes in.`}

\n

{`Before getting into the details, you can `}{`find a more detailed tutorial at this blog`}{`.`}

\n

{`1. Create a Balena account`}

\n

{`Before moving on, make sure you have registered on `}{`Balena`}{`.`}

\n

\"Signup

\n

{`2. Create a device and flash`}

\n

{`After you signed up, you can create an application for a specific IoT board (e.g. Raspberry Pi 3). Once created you will be able to download the balena OS image, which you can flash to your SD card using `}{`Etcher`}{`.`}

\n

\"Create

\n

{`3. Connect`}

\n

{`Once you've flashed the balena OS, turned on your IoT board, a new device should come up on the Balena dashboard (below the application you've created). At this point you will be able to connect to your device using the `}{`balena-cli`}{` `}{`read more about the installation here`}{`.`}

\n

{`First connect the `}{`balena-cli`}{` to your account by executing following command. Choose the recommended option.`}

\n 
{`balena login`}
\n

{`After succesfully logged in you should be able to list your devices.`}

\n 
{`balena devices`}
\n

{`4. Write`}

\n

{`Finally, we can push our Kerberos Docker container to our application (and devices). To do this we need to create two files.`}

\n
    \n
  1. {`Create a new directory and the Dockerfile.`}
    2. \n
\n

{`The first file is named `}{`Dockerfile`}{` this file will contain a base image which references to our Kerberos image, which `}{`you can find here`}{`.`}

\n 
{`mkdir kerberosbalena`}{`\n`}{`cd kerberosbalena`}{`\n`}{`echo 'FROM kerberos/kerberos@sha256:70a8b2791c8605ca6f8442b3d7892bb9bfc0789ab2f9f68911e247f7af50caed`}{`\n`}{`CMD [\"bash\", \"/run.sh\"]' > Dockerfile`}
\n

{`Please note that we specified a sha256 tag, you have to make sure you use the right sha256 tag for your architecure. In the example above we use the sha256 tag for a armv7 architecture (Raspberry Pi3).`}

\n
    \n
  1. {`Create a Docker compose file.`}
    2. \n
\n

{`The Docker compose file is optional, but can be very useful. It can be used to deploy multi container application (e.g. a webserver + database). As Kerberos has everything in one single container, this is not needed.`}

\n

{`We will use the \\`docker-compose.yml to mount volumes, so that when we restart our container all our configurations and recordings stay persisted.`}

\n

{`Create a new file named `}{`docker-compose.yml`}{`, and copy-paste following content.`}

\n 
{`version: '2.1'`}{`\n`}{`networks: {}`}{`\n`}{`volumes:`}{`\n`}{`  config: {}`}{`\n`}{`  capture: {}`}{`\n`}{`  logs: {}`}{`\n`}{`  web: {}`}{`\n`}{`services:`}{`\n`}{`  main:`}{`\n`}{`    build:`}{`\n`}{`      context: .`}{`\n`}{`    privileged: true`}{`\n`}{`    tty: true`}{`\n`}{`    restart: always`}{`\n`}{`    network_mode: host`}{`\n`}{`    volumes:`}{`\n`}{`      - 'config:/etc/opt/kerberosio/config'`}{`\n`}{`      - 'capture:/etc/opt/kerberosio/capture'`}{`\n`}{`      - 'logs:/etc/opt/kerberosio/logs'`}{`\n`}{`      - 'web:/var/www/web/config'`}{`\n`}{`    labels:`}{`\n`}{`      io.balena.features.kernel-modules: '1'`}{`\n`}{`      io.balena.features.firmware: '1'`}{`\n`}{`      io.balena.features.dbus: '1'`}{`\n`}{`      io.balena.features.supervisor-api: '1'`}{`\n`}{`      io.balena.features.resin-api: '1'`}{`\n`}{`      io.balena.features.balena-socket: '1'`}
\n

{`5. Push`}

\n

{`Now we created our two files, we can publish the Kerberos container to balena (our application), by executing the push command (replace by the name of your application).`}

\n 
{`balena push `}
\n

{`Once finished you should see following message, and on the dashboard you should see your devices updating (Yes you can add multiple devices to an application). You're ready ;)`}

\n

\"Push

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-9b8ea2000164402c26c38a14d8d42466.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-9b8ea2000164402c26c38a14d8d42466.json deleted file mode 100644 index d7ef960..0000000 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-9b8ea2000164402c26c38a14d8d42466.json +++ /dev/null @@ -1 +0,0 @@ -{"expireTime":9007200861747688000,"key":"gatsby-plugin-mdx-entire-payload-98c84b6de98681eaffed2ec3821e8199-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Welcome to the Kerberos Enterprise Edge installation. This is the way to go if you want to install Kerberos Enterprise on your Baremetal infrastructure or inside your Private Cloud.","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":182,"offset":416},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":182,"offset":416},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":14,"column":1,"offset":418},"end":{"line":14,"column":91,"offset":508},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":418},"end":{"line":14,"column":91,"offset":508},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before we can actual start installing the different deployments in our cluster, we need to make sure we have one available.","position":{"start":{"line":16,"column":1,"offset":510},"end":{"line":16,"column":124,"offset":633},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":510},"end":{"line":16,"column":124,"offset":633},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":18,"column":3,"offset":637},"end":{"line":18,"column":16,"offset":650},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":635},"end":{"line":18,"column":16,"offset":650},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Docker","position":{"start":{"line":20,"column":4,"offset":655},"end":{"line":20,"column":10,"offset":661},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":652},"end":{"line":20,"column":10,"offset":661},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you have a fresh Linux installation, make sure you have Docker installed. If not the case, this is how you can install it on a Ubuntu OSS.","position":{"start":{"line":22,"column":1,"offset":663},"end":{"line":22,"column":142,"offset":804},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":663},"end":{"line":22,"column":142,"offset":804},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"apt install docker.io -y","position":{"start":{"line":24,"column":1,"offset":806},"end":{"line":24,"column":29,"offset":834},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":26,"column":4,"offset":839},"end":{"line":26,"column":14,"offset":849},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":836},"end":{"line":26,"column":14,"offset":849},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After Docker being installed go ahead and install the different Kubernetes servicess and tools.","position":{"start":{"line":28,"column":1,"offset":851},"end":{"line":28,"column":96,"offset":946},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":851},"end":{"line":28,"column":96,"offset":946},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"apt update -y\napt install apt-transport-https curl -y\ncurl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add\napt-add-repository \"deb http://apt.kubernetes.io/ kubernetes-xenial main\"\napt update -y && apt install kubeadm kubelet kubectl kubernetes-cni -y","position":{"start":{"line":30,"column":1,"offset":948},"end":{"line":34,"column":75,"offset":1242},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Make sure you disable swap, this is required by Kubernetes.","position":{"start":{"line":36,"column":1,"offset":1244},"end":{"line":36,"column":60,"offset":1303},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":1244},"end":{"line":36,"column":60,"offset":1303},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"swapoff -a","position":{"start":{"line":38,"column":1,"offset":1305},"end":{"line":38,"column":15,"offset":1319},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"And if you want to make it permanent after every boot.","position":{"start":{"line":40,"column":1,"offset":1321},"end":{"line":40,"column":55,"offset":1375},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1321},"end":{"line":40,"column":55,"offset":1375},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"sudo sed -i.bak '/ swap / s/^\\(.*\\)$/#\\1/g' /etc/fstab","position":{"start":{"line":42,"column":1,"offset":1377},"end":{"line":42,"column":59,"offset":1435},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":44,"column":3,"offset":1439},"end":{"line":44,"column":15,"offset":1451},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":1437},"end":{"line":44,"column":15,"offset":1451},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before initiating a new Kubernetes cluster, make sure you have properly cleaned up previous installation (if this was the case ofc).","position":{"start":{"line":46,"column":1,"offset":1453},"end":{"line":46,"column":133,"offset":1585},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":1453},"end":{"line":46,"column":133,"offset":1585},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubeadm reset\nrm -rf $HOME/.kube","position":{"start":{"line":48,"column":1,"offset":1587},"end":{"line":49,"column":23,"offset":1627},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Initiate a new Kubernetes cluster using following command. This will use the current CIDR. If you want to use another CIDR, specify following arguments: ","position":{"start":{"line":51,"column":1,"offset":1629},"end":{"line":51,"column":154,"offset":1782},"indent":[]}},{"type":"inlineCode","value":"--pod-network-cidr=10.244.0.0/16","position":{"start":{"line":51,"column":154,"offset":1782},"end":{"line":51,"column":188,"offset":1816},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":51,"column":188,"offset":1816},"end":{"line":51,"column":189,"offset":1817},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":1629},"end":{"line":51,"column":189,"offset":1817},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubeadm init","position":{"start":{"line":53,"column":1,"offset":1819},"end":{"line":53,"column":17,"offset":1835},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once successful you should see the following. Note the ","position":{"start":{"line":55,"column":1,"offset":1837},"end":{"line":55,"column":56,"offset":1892},"indent":[]}},{"type":"inlineCode","value":"discovery token","position":{"start":{"line":55,"column":56,"offset":1892},"end":{"line":55,"column":73,"offset":1909},"indent":[]}},{"type":"text","value":" which you need to use to connect additional nodes to your cluster.","position":{"start":{"line":55,"column":73,"offset":1909},"end":{"line":55,"column":140,"offset":1976},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":1837},"end":{"line":55,"column":140,"offset":1976},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"Your Kubernetes control-plane has initialized successfully!\n\nTo start using your cluster, you need to run the following as a regular user:\n\n mkdir -p $HOME/.kube\n sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config\n sudo chown $(id -u):$(id -g) $HOME/.kube/config\n\nYou should now deploy a pod network to the cluster.\nRun \"kubectl apply -f [podnetwork].yaml\" with one of the options listed at:\n https://kubernetes.io/docs/concepts/cluster-administration/addons/\n\nThen you can join any number of worker nodes by running the following on each as root:\n\nkubeadm join 192.168.1.103:6443 --token ej7ckt.uof7o2iplqf0r2up \\\n --discovery-token-ca-cert-hash sha256:9cbcc00d34be2dbd605174802d9e52fbcdd617324c237bf58767b369fa586209","position":{"start":{"line":57,"column":1,"offset":1978},"end":{"line":72,"column":111,"offset":2753},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Now we have a Kubernetes cluster, we need to make sure we add make it available in our ","position":{"start":{"line":74,"column":1,"offset":2755},"end":{"line":74,"column":88,"offset":2842},"indent":[]}},{"type":"inlineCode","value":"kubeconfig","position":{"start":{"line":74,"column":88,"offset":2842},"end":{"line":74,"column":100,"offset":2854},"indent":[]}},{"type":"text","value":". This will allow us to query our Kubernetes cluster with the ","position":{"start":{"line":74,"column":100,"offset":2854},"end":{"line":74,"column":162,"offset":2916},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":74,"column":162,"offset":2916},"end":{"line":74,"column":171,"offset":2925},"indent":[]}},{"type":"text","value":" command.","position":{"start":{"line":74,"column":171,"offset":2925},"end":{"line":74,"column":180,"offset":2934},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":2755},"end":{"line":74,"column":180,"offset":2934},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"mkdir -p $HOME/.kube\ncp -i /etc/kubernetes/admin.conf $HOME/.kube/config\nchown $(id -u):$(id -g) $HOME/.kube/config","position":{"start":{"line":76,"column":1,"offset":2936},"end":{"line":78,"column":47,"offset":3063},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Untaint all nodes","position":{"start":{"line":80,"column":4,"offset":3068},"end":{"line":80,"column":21,"offset":3085},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":3065},"end":{"line":80,"column":21,"offset":3085},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By default, and in this example, we only have one node our master node. In a production scenario we would have additional worker nodes. By default the master nodes are marked as ","position":{"start":{"line":82,"column":1,"offset":3087},"end":{"line":82,"column":179,"offset":3265},"indent":[]}},{"type":"inlineCode","value":"tainted","position":{"start":{"line":82,"column":179,"offset":3265},"end":{"line":82,"column":188,"offset":3274},"indent":[]}},{"type":"text","value":", this means they cannot run workloads. To allow master nodes to run workloads, we need to untaint them. If we wouldn't do this our pods would never be scheduled, as we do not have worker nodes at this moment.","position":{"start":{"line":82,"column":188,"offset":3274},"end":{"line":82,"column":397,"offset":3483},"indent":[]}}],"position":{"start":{"line":82,"column":1,"offset":3087},"end":{"line":82,"column":397,"offset":3483},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl taint nodes --all node-role.kubernetes.io/master-","position":{"start":{"line":84,"column":1,"offset":3485},"end":{"line":84,"column":62,"offset":3546},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Calico","position":{"start":{"line":86,"column":4,"offset":3551},"end":{"line":86,"column":10,"offset":3557},"indent":[]}}],"position":{"start":{"line":86,"column":1,"offset":3548},"end":{"line":86,"column":10,"offset":3557},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Calico is an open source networking and network security solution for containers, virtual machines, and native host-based workloads. (","position":{"start":{"line":88,"column":1,"offset":3559},"end":{"line":88,"column":135,"offset":3693},"indent":[]}},{"type":"link","title":null,"url":"https://www.projectcalico.org/","children":[{"type":"text","value":"https://www.projectcalico.org/","position":{"start":{"line":88,"column":135,"offset":3693},"end":{"line":88,"column":165,"offset":3723},"indent":[]}}],"position":{"start":{"line":88,"column":135,"offset":3693},"end":{"line":88,"column":165,"offset":3723},"indent":[]}},{"type":"text","value":"). We will use it as our network layer in our Kubernetes cluster. You could use otthers like Flannel aswell, but we prefer Calico.","position":{"start":{"line":88,"column":165,"offset":3723},"end":{"line":88,"column":295,"offset":3853},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":3559},"end":{"line":88,"column":295,"offset":3853},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"curl https://docs.projectcalico.org/manifests/calico.yaml -O\nkubectl apply -f calico.yaml","position":{"start":{"line":90,"column":1,"offset":3855},"end":{"line":91,"column":33,"offset":3952},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":93,"column":4,"offset":3957},"end":{"line":93,"column":23,"offset":3976},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":3954},"end":{"line":93,"column":23,"offset":3976},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.","position":{"start":{"line":95,"column":1,"offset":3978},"end":{"line":95,"column":323,"offset":4300},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":3978},"end":{"line":95,"column":323,"offset":4300},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/enterprise\nkubectl create -f ./enterprise/yaml/factory/clusterrole.yaml","position":{"start":{"line":97,"column":1,"offset":4302},"end":{"line":98,"column":65,"offset":4422},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"This will make several actions, permissions, inside your cluster available. We need this to be able to create deployments from the Kerberos Enterprise web app.","position":{"start":{"line":100,"column":1,"offset":4424},"end":{"line":100,"column":160,"offset":4583},"indent":[]}}],"position":{"start":{"line":100,"column":1,"offset":4424},"end":{"line":100,"column":160,"offset":4583},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"MetalLB","position":{"start":{"line":102,"column":4,"offset":4588},"end":{"line":102,"column":11,"offset":4595},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":4585},"end":{"line":102,"column":11,"offset":4595},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In the Edge world, we do not have fancy Load balancers and Public IP from which we can benefit. To overcome this solutions such as MetalLB - Baremetal Load Balancer - have been developed (","position":{"start":{"line":104,"column":1,"offset":4597},"end":{"line":104,"column":189,"offset":4785},"indent":[]}},{"type":"link","title":null,"url":"https://metallb.universe.tf/installation/","children":[{"type":"text","value":"https://metallb.universe.tf/installation/","position":{"start":{"line":104,"column":189,"offset":4785},"end":{"line":104,"column":230,"offset":4826},"indent":[]}}],"position":{"start":{"line":104,"column":189,"offset":4785},"end":{"line":104,"column":230,"offset":4826},"indent":[]}},{"type":"text","value":"). MetalLB will dedicate an internal IP address, or IP range, which will be assigned to one or more Load Balancers.","position":{"start":{"line":104,"column":230,"offset":4826},"end":{"line":104,"column":345,"offset":4941},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":4597},"end":{"line":104,"column":345,"offset":4941},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f https://raw.githubusercontent.com/metallb/metallb/v0.9.5/manifests/namespace.yaml\nkubectl apply -f https://raw.githubusercontent.com/metallb/metallb/v0.9.5/manifests/metallb.yaml\nkubectl create secret generic -n metallb-system memberlist --from-literal=secretkey=\"$(openssl rand -base64 128)\"","position":{"start":{"line":106,"column":1,"offset":4943},"end":{"line":108,"column":118,"offset":5264},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"After installing the different MetalLB components, we need to create a ","position":{"start":{"line":110,"column":1,"offset":5266},"end":{"line":110,"column":72,"offset":5337},"indent":[]}},{"type":"inlineCode","value":"configmap.yaml","position":{"start":{"line":110,"column":72,"offset":5337},"end":{"line":110,"column":88,"offset":5353},"indent":[]}},{"type":"text","value":" file. This file contains information of how MetalLB can get and use internal IP's as LoadBalancers.","position":{"start":{"line":110,"column":88,"offset":5353},"end":{"line":110,"column":188,"offset":5453},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":5266},"end":{"line":110,"column":188,"offset":5453},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" apiVersion: v1\n kind: ConfigMap\n metadata:\n namespace: metallb-system\n name: config\n data:\n config: |\n address-pools:\n - name: default\n protocol: layer2\n addresses:\n--> - 192.168.1.200-192.168.1.210","position":{"start":{"line":112,"column":1,"offset":5455},"end":{"line":123,"column":42,"offset":5743},"indent":[1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"You can change the IP range above to match your needs. MetalLB will use this range as a referance to assign IP addresses to your LoadBalancers. Once ready you can apply the configration map.","position":{"start":{"line":125,"column":1,"offset":5745},"end":{"line":125,"column":191,"offset":5935},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":5745},"end":{"line":125,"column":191,"offset":5935},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./enterprise/yaml/metallb/configmap.yaml","position":{"start":{"line":127,"column":1,"offset":5937},"end":{"line":127,"column":62,"offset":5998},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Helm","position":{"start":{"line":129,"column":4,"offset":6003},"end":{"line":129,"column":8,"offset":6007},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":6000},"end":{"line":129,"column":8,"offset":6007},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before we can start with the real work, I know we had to do a lot of preparation, we have to install another helpful tool ","position":{"start":{"line":131,"column":1,"offset":6009},"end":{"line":131,"column":123,"offset":6131},"indent":[]}},{"type":"inlineCode","value":"Helm","position":{"start":{"line":131,"column":123,"offset":6131},"end":{"line":131,"column":129,"offset":6137},"indent":[]}},{"type":"text","value":". Helm is a package manager for Kubernetes, and really makes you life easier.","position":{"start":{"line":131,"column":129,"offset":6137},"end":{"line":131,"column":206,"offset":6214},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":6009},"end":{"line":131,"column":206,"offset":6214},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3\nchmod 700 get_helm.sh\n./get_helm.sh","position":{"start":{"line":133,"column":1,"offset":6216},"end":{"line":135,"column":18,"offset":6359},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"This will make sure helm 3 is installed.","position":{"start":{"line":137,"column":1,"offset":6361},"end":{"line":137,"column":41,"offset":6401},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":6361},"end":{"line":137,"column":41,"offset":6401},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Traefik","position":{"start":{"line":139,"column":4,"offset":6406},"end":{"line":139,"column":11,"offset":6413},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":6403},"end":{"line":139,"column":11,"offset":6413},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To access the Kerberos Enterprise web application, we will create a service in the next paragraphs. This service will expose the web application as an Ingress. Thanks to our previous installation with MetalLB and Traefik (what we will do now), we will have a neat solution for managing our hostnames and Load Balancing IPs.","position":{"start":{"line":141,"column":1,"offset":6415},"end":{"line":141,"column":324,"offset":6738},"indent":[]}}],"position":{"start":{"line":141,"column":1,"offset":6415},"end":{"line":141,"column":324,"offset":6738},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The idea is that Traefik, will have a dedicated IP address assigned from MetalLB, and will resolve the Ingress of our Kerberos Enterprise web app. Let's go ahead with installing Traefik.","position":{"start":{"line":143,"column":1,"offset":6740},"end":{"line":143,"column":187,"offset":6926},"indent":[]}}],"position":{"start":{"line":143,"column":1,"offset":6740},"end":{"line":143,"column":187,"offset":6926},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add stable https://charts.helm.sh/stable\nhelm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik","position":{"start":{"line":145,"column":1,"offset":6928},"end":{"line":146,"column":81,"offset":7063},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"MongoDB","position":{"start":{"line":148,"column":4,"offset":7068},"end":{"line":148,"column":11,"offset":7075},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":7065},"end":{"line":148,"column":11,"offset":7075},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use ","position":{"start":{"line":150,"column":1,"offset":7077},"end":{"line":150,"column":192,"offset":7268},"indent":[]}},{"type":"inlineCode","value":"helm","position":{"start":{"line":150,"column":192,"offset":7268},"end":{"line":150,"column":198,"offset":7274},"indent":[]}},{"type":"text","value":" to install a MongoDB instance inside your cluster.","position":{"start":{"line":150,"column":198,"offset":7274},"end":{"line":150,"column":249,"offset":7325},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":7077},"end":{"line":150,"column":249,"offset":7325},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before we can move into the installation of MongoDB, in contrary with the cloud installation, we will need to create a Persistent Volume (PV). For simplicity we will use ","position":{"start":{"line":152,"column":1,"offset":7327},"end":{"line":152,"column":171,"offset":7497},"indent":[]}},{"type":"inlineCode","value":"local-storage","position":{"start":{"line":152,"column":171,"offset":7497},"end":{"line":152,"column":186,"offset":7512},"indent":[]}},{"type":"text","value":", and make sure the volume is assigned to a specific node (hostname).","position":{"start":{"line":152,"column":186,"offset":7512},"end":{"line":152,"column":255,"offset":7581},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":7327},"end":{"line":152,"column":255,"offset":7581},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Create a folder on the node (VM), where you want to persist the data of MongoDB.","position":{"start":{"line":154,"column":1,"offset":7583},"end":{"line":154,"column":81,"offset":7663},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":7583},"end":{"line":154,"column":81,"offset":7663},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"mkdir /home/mongodb/","position":{"start":{"line":156,"column":1,"offset":7665},"end":{"line":156,"column":25,"offset":7689},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once done open the ","position":{"start":{"line":158,"column":1,"offset":7691},"end":{"line":158,"column":20,"offset":7710},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/mongodb/volume.yaml","position":{"start":{"line":158,"column":20,"offset":7710},"end":{"line":158,"column":59,"offset":7749},"indent":[]}},{"type":"text","value":" file and make sure to change capacity, local path (if changed) and the hostname attribute (VM/machine, on which the directory is made available).","position":{"start":{"line":158,"column":59,"offset":7749},"end":{"line":158,"column":205,"offset":7895},"indent":[]}}],"position":{"start":{"line":158,"column":1,"offset":7691},"end":{"line":158,"column":205,"offset":7895},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n capacity:\n--> storage: 10Gi\n accessModes:\n - ReadWriteOnce\n persistentVolumeReclaimPolicy: Recycle\n storageClassName: local-storage\n local:\n--> path: /home/mongodb/\n nodeAffinity:\n required:\n nodeSelectorTerms:\n - matchExpressions:\n - key: kubernetes.io/hostname\n operator: In\n values:\n--> - hostname","position":{"start":{"line":160,"column":1,"offset":7897},"end":{"line":176,"column":29,"offset":8389},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"After modified properly you can go ahead with creating the PV.","position":{"start":{"line":178,"column":1,"offset":8391},"end":{"line":178,"column":63,"offset":8453},"indent":[]}}],"position":{"start":{"line":178,"column":1,"offset":8391},"end":{"line":178,"column":63,"offset":8453},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl create -f ./enterprise/yaml/mongodb/volume.yaml","position":{"start":{"line":180,"column":1,"offset":8455},"end":{"line":180,"column":60,"offset":8514},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Have a look into the ","position":{"start":{"line":182,"column":1,"offset":8516},"end":{"line":182,"column":22,"offset":8537},"indent":[]}},{"type":"inlineCode","value":"yaml/mongodb/values.yaml","position":{"start":{"line":182,"column":22,"offset":8537},"end":{"line":182,"column":48,"offset":8563},"indent":[]}},{"type":"text","value":" file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb. If using Helm version 2, write ","position":{"start":{"line":182,"column":48,"offset":8563},"end":{"line":182,"column":236,"offset":8751},"indent":[]}},{"type":"inlineCode","value":"--name mongodb","position":{"start":{"line":182,"column":236,"offset":8751},"end":{"line":182,"column":252,"offset":8767},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":182,"column":252,"offset":8767},"end":{"line":182,"column":253,"offset":8768},"indent":[]}}],"position":{"start":{"line":182,"column":1,"offset":8516},"end":{"line":182,"column":253,"offset":8768},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm install mongodb bitnami/mongodb --values ./yaml/mongodb/values-edge.yaml","position":{"start":{"line":184,"column":1,"offset":8770},"end":{"line":185,"column":82,"offset":8912},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.","position":{"start":{"line":187,"column":1,"offset":8914},"end":{"line":187,"column":170,"offset":9083},"indent":[]}}],"position":{"start":{"line":187,"column":1,"offset":8914},"end":{"line":187,"column":170,"offset":9083},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)\necho $MONGODB_ROOT_PASSWORD","position":{"start":{"line":189,"column":1,"offset":9085},"end":{"line":190,"column":32,"offset":9261},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Enterprise Web App - The Factory","position":{"start":{"line":192,"column":4,"offset":9266},"end":{"line":192,"column":45,"offset":9307},"indent":[]}}],"position":{"start":{"line":192,"column":1,"offset":9263},"end":{"line":192,"column":45,"offset":9307},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the ","position":{"start":{"line":194,"column":1,"offset":9309},"end":{"line":194,"column":138,"offset":9446},"indent":[]}},{"type":"inlineCode","value":"Factory","position":{"start":{"line":194,"column":138,"offset":9446},"end":{"line":194,"column":147,"offset":9455},"indent":[]}},{"type":"text","value":". It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.","position":{"start":{"line":194,"column":147,"offset":9455},"end":{"line":194,"column":309,"offset":9617},"indent":[]}}],"position":{"start":{"line":194,"column":1,"offset":9309},"end":{"line":194,"column":309,"offset":9617},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the ","position":{"start":{"line":196,"column":1,"offset":9619},"end":{"line":196,"column":289,"offset":9907},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":196,"column":289,"offset":9907},"end":{"line":196,"column":298,"offset":9916},"indent":[]}},{"type":"text","value":" command.","position":{"start":{"line":196,"column":298,"offset":9916},"end":{"line":196,"column":307,"offset":9925},"indent":[]}}],"position":{"start":{"line":196,"column":1,"offset":9619},"end":{"line":196,"column":307,"offset":9925},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing the Factory web app, open the ","position":{"start":{"line":198,"column":1,"offset":9927},"end":{"line":198,"column":49,"offset":9975},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":198,"column":49,"offset":9975},"end":{"line":198,"column":92,"offset":10018},"indent":[]}},{"type":"text","value":" configuration file. At the bottom file you will find two endpoints, similar to the traefik config file. Update the domain names to your own domain, and add these to your DNS server (pointing to the same IP as the traefik EXTERNAL-IP).","position":{"start":{"line":198,"column":92,"offset":10018},"end":{"line":198,"column":327,"offset":10253},"indent":[]}}],"position":{"start":{"line":198,"column":1,"offset":9927},"end":{"line":198,"column":327,"offset":10253},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 80\n--> - host: api.factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 8081","position":{"start":{"line":200,"column":1,"offset":10255},"end":{"line":215,"column":36,"offset":10687},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":217,"column":1,"offset":10689},"end":{"line":217,"column":99,"offset":10787},"indent":[]}}],"position":{"start":{"line":217,"column":1,"offset":10689},"end":{"line":217,"column":99,"offset":10787},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":219,"column":1,"offset":10789},"end":{"line":222,"column":30,"offset":10908},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.","position":{"start":{"line":224,"column":1,"offset":10910},"end":{"line":224,"column":118,"offset":11027},"indent":[]}}],"position":{"start":{"line":224,"column":1,"offset":10910},"end":{"line":224,"column":118,"offset":11027},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":226,"column":1,"offset":11029},"end":{"line":226,"column":63,"offset":11091},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":228,"column":4,"offset":11096},"end":{"line":228,"column":26,"offset":11118},"indent":[]}}],"position":{"start":{"line":228,"column":1,"offset":11093},"end":{"line":228,"column":26,"offset":11118},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":230,"column":1,"offset":11120},"end":{"line":230,"column":94,"offset":11213},"indent":[]}}],"position":{"start":{"line":230,"column":1,"offset":11120},"end":{"line":230,"column":94,"offset":11213},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":232,"column":5,"offset":11219},"end":{"line":232,"column":12,"offset":11226},"indent":[]}}],"position":{"start":{"line":232,"column":5,"offset":11219},"end":{"line":232,"column":12,"offset":11226},"indent":[]}}],"position":{"start":{"line":232,"column":1,"offset":11215},"end":{"line":232,"column":12,"offset":11226},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":233,"column":5,"offset":11231},"end":{"line":233,"column":12,"offset":11238},"indent":[]}}],"position":{"start":{"line":233,"column":5,"offset":11231},"end":{"line":233,"column":12,"offset":11238},"indent":[]}}],"position":{"start":{"line":233,"column":1,"offset":11227},"end":{"line":233,"column":12,"offset":11238},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Factory","position":{"start":{"line":234,"column":5,"offset":11243},"end":{"line":234,"column":12,"offset":11250},"indent":[]}}],"position":{"start":{"line":234,"column":5,"offset":11243},"end":{"line":234,"column":12,"offset":11250},"indent":[]}}],"position":{"start":{"line":234,"column":1,"offset":11239},"end":{"line":234,"column":12,"offset":11250},"indent":[]}}],"position":{"start":{"line":232,"column":1,"offset":11215},"end":{"line":234,"column":12,"offset":11250},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":236,"column":1,"offset":11252},"end":{"line":236,"column":26,"offset":11277},"indent":[]}}],"position":{"start":{"line":236,"column":1,"offset":11252},"end":{"line":236,"column":26,"offset":11277},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nfactory-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-758d5c5ddd-qsfq9 1/1 Running 0 5m31s\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":238,"column":1,"offset":11279},"end":{"line":242,"column":73,"offset":11591},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":244,"column":4,"offset":11596},"end":{"line":244,"column":21,"offset":11613},"indent":[]}}],"position":{"start":{"line":244,"column":1,"offset":11593},"end":{"line":244,"column":21,"offset":11613},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain ","position":{"start":{"line":246,"column":1,"offset":11615},"end":{"line":246,"column":152,"offset":11766},"indent":[]}},{"type":"inlineCode","value":"factory.domain.com","position":{"start":{"line":246,"column":152,"offset":11766},"end":{"line":246,"column":172,"offset":11786},"indent":[]}},{"type":"text","value":" in your browser you will see the Factory login page showing up.","position":{"start":{"line":246,"column":172,"offset":11786},"end":{"line":246,"column":236,"offset":11850},"indent":[]}}],"position":{"start":{"line":246,"column":1,"offset":11615},"end":{"line":246,"column":236,"offset":11850},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Factory","position":{"start":{"line":248,"column":1,"offset":11852},"end":{"line":248,"column":71,"offset":11922},"indent":[]}}],"position":{"start":{"line":248,"column":1,"offset":11852},"end":{"line":248,"column":71,"offset":11922},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":251,"column":1,"offset":11925},"end":{"line":251,"column":31,"offset":11955},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":251,"column":31,"offset":11955}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Introduction`}

\n

{`Welcome to the Kerberos Enterprise Edge installation. This is the way to go if you want to install Kerberos Enterprise on your Baremetal infrastructure or inside your Private Cloud.`}

\n

\"architecture

\n

{`Before we can actual start installing the different deployments in our cluster, we need to make sure we have one available.`}

\n

{`Prerequisites`}

\n

{`Docker`}

\n

{`If you have a fresh Linux installation, make sure you have Docker installed. If not the case, this is how you can install it on a Ubuntu OSS.`}

\n 
{`apt install docker.io -y`}
\n

{`Kubernetes`}

\n

{`After Docker being installed go ahead and install the different Kubernetes servicess and tools.`}

\n 
{`apt update -y`}{`\n`}{`apt install apt-transport-https curl -y`}{`\n`}{`curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add`}{`\n`}{`apt-add-repository \"deb http://apt.kubernetes.io/ kubernetes-xenial main\"`}{`\n`}{`apt update -y && apt install kubeadm kubelet kubectl kubernetes-cni -y`}
\n

{`Make sure you disable swap, this is required by Kubernetes.`}

\n 
{`swapoff -a`}
\n

{`And if you want to make it permanent after every boot.`}

\n 
{`sudo sed -i.bak '/ swap / s/^\\\\(.*\\\\)$/#\\\\1/g' /etc/fstab`}
\n

{`Installation`}

\n

{`Before initiating a new Kubernetes cluster, make sure you have properly cleaned up previous installation (if this was the case ofc).`}

\n 
{`kubeadm reset`}{`\n`}{`rm -rf $HOME/.kube`}
\n

{`Initiate a new Kubernetes cluster using following command. This will use the current CIDR. If you want to use another CIDR, specify following arguments: `}{`--pod-network-cidr=10.244.0.0/16`}{`.`}

\n 
{`kubeadm init`}
\n

{`Once successful you should see the following. Note the `}{`discovery token`}{` which you need to use to connect additional nodes to your cluster.`}

\n 
{`Your Kubernetes control-plane has initialized successfully!`}{`\n`}{`\n`}{`To start using your cluster, you need to run the following as a regular user:`}{`\n`}{`\n`}{`  mkdir -p $HOME/.kube`}{`\n`}{`  sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config`}{`\n`}{`  sudo chown $(id -u):$(id -g) $HOME/.kube/config`}{`\n`}{`\n`}{`You should now deploy a pod network to the cluster.`}{`\n`}{`Run \"kubectl apply -f [podnetwork].yaml\" with one of the options listed at:`}{`\n`}{`  https://kubernetes.io/docs/concepts/cluster-administration/addons/`}{`\n`}{`\n`}{`Then you can join any number of worker nodes by running the following on each as root:`}{`\n`}{`\n`}{`kubeadm join 192.168.1.103:6443 --token ej7ckt.uof7o2iplqf0r2up \\\\`}{`\n`}{`    --discovery-token-ca-cert-hash sha256:9cbcc00d34be2dbd605174802d9e52fbcdd617324c237bf58767b369fa586209`}
\n

{`Now we have a Kubernetes cluster, we need to make sure we add make it available in our `}{`kubeconfig`}{`. This will allow us to query our Kubernetes cluster with the `}{`kubectl`}{` command.`}

\n 
{`mkdir -p $HOME/.kube`}{`\n`}{`cp -i /etc/kubernetes/admin.conf $HOME/.kube/config`}{`\n`}{`chown $(id -u):$(id -g) $HOME/.kube/config`}
\n

{`Untaint all nodes`}

\n

{`By default, and in this example, we only have one node our master node. In a production scenario we would have additional worker nodes. By default the master nodes are marked as `}{`tainted`}{`, this means they cannot run workloads. To allow master nodes to run workloads, we need to untaint them. If we wouldn't do this our pods would never be scheduled, as we do not have worker nodes at this moment.`}

\n 
{`kubectl taint nodes --all node-role.kubernetes.io/master-`}
\n

{`Calico`}

\n

{`Calico is an open source networking and network security solution for containers, virtual machines, and native host-based workloads. (`}{`https://www.projectcalico.org/`}{`). We will use it as our network layer in our Kubernetes cluster. You could use otthers like Flannel aswell, but we prefer Calico.`}

\n 
{`curl https://docs.projectcalico.org/manifests/calico.yaml -O`}{`\n`}{`kubectl apply -f calico.yaml`}
\n

{`Kerberos Enterprise`}

\n

{`Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.`}

\n 
{`git clone https://github.com/kerberos-io/enterprise`}{`\n`}{`kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml`}
\n

{`This will make several actions, permissions, inside your cluster available. We need this to be able to create deployments from the Kerberos Enterprise web app.`}

\n

{`MetalLB`}

\n

{`In the Edge world, we do not have fancy Load balancers and Public IP from which we can benefit. To overcome this solutions such as MetalLB - Baremetal Load Balancer - have been developed (`}{`https://metallb.universe.tf/installation/`}{`). MetalLB will dedicate an internal IP address, or IP range, which will be assigned to one or more Load Balancers.`}

\n 
{`kubectl apply -f https://raw.githubusercontent.com/metallb/metallb/v0.9.5/manifests/namespace.yaml`}{`\n`}{`kubectl apply -f https://raw.githubusercontent.com/metallb/metallb/v0.9.5/manifests/metallb.yaml`}{`\n`}{`kubectl create secret generic -n metallb-system memberlist --from-literal=secretkey=\"$(openssl rand -base64 128)\"`}
\n

{`After installing the different MetalLB components, we need to create a `}{`configmap.yaml`}{` file. This file contains information of how MetalLB can get and use internal IP's as LoadBalancers.`}

\n 
{`  apiVersion: v1`}{`\n`}{`  kind: ConfigMap`}{`\n`}{`  metadata:`}{`\n`}{`    namespace: metallb-system`}{`\n`}{`    name: config`}{`\n`}{`  data:`}{`\n`}{`    config: |`}{`\n`}{`      address-pools:`}{`\n`}{`      - name: default`}{`\n`}{`        protocol: layer2`}{`\n`}{`        addresses:`}{`\n`}{`-->     - 192.168.1.200-192.168.1.210`}
\n

{`You can change the IP range above to match your needs. MetalLB will use this range as a referance to assign IP addresses to your LoadBalancers. Once ready you can apply the configration map.`}

\n 
{`kubectl apply -f ./enterprise/yaml/metallb/configmap.yaml`}
\n

{`Helm`}

\n

{`Before we can start with the real work, I know we had to do a lot of preparation, we have to install another helpful tool `}{`Helm`}{`. Helm is a package manager for Kubernetes, and really makes you life easier.`}

\n 
{`curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3`}{`\n`}{`chmod 700 get_helm.sh`}{`\n`}{`./get_helm.sh`}
\n

{`This will make sure helm 3 is installed.`}

\n

{`Traefik`}

\n

{`To access the Kerberos Enterprise web application, we will create a service in the next paragraphs. This service will expose the web application as an Ingress. Thanks to our previous installation with MetalLB and Traefik (what we will do now), we will have a neat solution for managing our hostnames and Load Balancing IPs.`}

\n

{`The idea is that Traefik, will have a dedicated IP address assigned from MetalLB, and will resolve the Ingress of our Kerberos Enterprise web app. Let's go ahead with installing Traefik.`}

\n 
{`helm repo add stable https://charts.helm.sh/stable`}{`\n`}{`helm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik`}
\n

{`MongoDB`}

\n

{`When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use `}{`helm`}{` to install a MongoDB instance inside your cluster.`}

\n

{`Before we can move into the installation of MongoDB, in contrary with the cloud installation, we will need to create a Persistent Volume (PV). For simplicity we will use `}{`local-storage`}{`, and make sure the volume is assigned to a specific node (hostname).`}

\n

{`Create a folder on the node (VM), where you want to persist the data of MongoDB.`}

\n 
{`mkdir /home/mongodb/`}
\n

{`Once done open the `}{`./enterprise/yaml/mongodb/volume.yaml`}{` file and make sure to change capacity, local path (if changed) and the hostname attribute (VM/machine, on which the directory is made available).`}

\n 
{`    spec:`}{`\n`}{`      capacity:`}{`\n`}{`-->    storage: 10Gi`}{`\n`}{`      accessModes:`}{`\n`}{`      - ReadWriteOnce`}{`\n`}{`      persistentVolumeReclaimPolicy: Recycle`}{`\n`}{`      storageClassName: local-storage`}{`\n`}{`      local:`}{`\n`}{`-->    path: /home/mongodb/`}{`\n`}{`      nodeAffinity:`}{`\n`}{`        required:`}{`\n`}{`          nodeSelectorTerms:`}{`\n`}{`          - matchExpressions:`}{`\n`}{`            - key: kubernetes.io/hostname`}{`\n`}{`              operator: In`}{`\n`}{`              values:`}{`\n`}{`-->           - hostname`}
\n

{`After modified properly you can go ahead with creating the PV.`}

\n 
{`kubectl create -f ./enterprise/yaml/mongodb/volume.yaml`}
\n

{`Have a look into the `}{`yaml/mongodb/values.yaml`}{` file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb. If using Helm version 2, write `}{`--name mongodb`}{`.`}

\n 
{`helm repo add bitnami https://charts.bitnami.com/bitnami`}{`\n`}{`helm install mongodb bitnami/mongodb --values ./yaml/mongodb/values-edge.yaml`}
\n

{`Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.`}

\n 
{`export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)`}{`\n`}{`echo $MONGODB_ROOT_PASSWORD`}
\n

{`Kerberos Enterprise Web App - The Factory`}

\n

{`The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the `}{`Factory`}{`. It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.`}

\n

{`The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the `}{`kubectl`}{` command.`}

\n

{`Before installing the Factory web app, open the `}{`./enterprise/yaml/factory/deployment.yaml`}{` configuration file. At the bottom file you will find two endpoints, similar to the traefik config file. Update the domain names to your own domain, and add these to your DNS server (pointing to the same IP as the traefik EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 8081`}
\n

{`Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.`}

\n 
{`kubectl apply -f ./enterprise/yaml/factory/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Factory`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`factory-6f5c877d7c-hf77p          1/1     Running   0          2d11h`}{`\n`}{`mongodb-758d5c5ddd-qsfq9          1/1     Running   0          5m31s`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain `}{`factory.domain.com`}{` in your browser you will see the Factory login page showing up.`}

\n

\"Factory\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-9e592f757f2e017ca9175326b001a11b.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-9e592f757f2e017ca9175326b001a11b.json new file mode 100644 index 0000000..99805da --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-9e592f757f2e017ca9175326b001a11b.json @@ -0,0 +1 @@ +{"expireTime":9007200861829576000,"key":"gatsby-plugin-mdx-entire-payload-491d915e404cfb2baf4e877fc95aa26d-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be localated on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":612,"offset":1265},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":612,"offset":1265},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":20,"column":4,"offset":1270},"end":{"line":20,"column":18,"offset":1284},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1267},"end":{"line":20,"column":18,"offset":1284},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":22,"column":1,"offset":1286},"end":{"line":22,"column":291,"offset":1576},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":22,"column":292,"offset":1577},"end":{"line":22,"column":309,"offset":1594},"indent":[]}}],"position":{"start":{"line":22,"column":291,"offset":1576},"end":{"line":22,"column":318,"offset":1603},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":22,"column":318,"offset":1603},"end":{"line":22,"column":319,"offset":1604},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1286},"end":{"line":22,"column":319,"offset":1604},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":24,"column":1,"offset":1606},"end":{"line":24,"column":56,"offset":1661},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1606},"end":{"line":24,"column":56,"offset":1661},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":26,"column":4,"offset":1666},"end":{"line":26,"column":20,"offset":1682},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1663},"end":{"line":26,"column":20,"offset":1682},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":28,"column":1,"offset":1684},"end":{"line":28,"column":253,"offset":1936},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1684},"end":{"line":28,"column":253,"offset":1936},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":30,"column":6,"offset":1943},"end":{"line":30,"column":35,"offset":1972},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1942},"end":{"line":30,"column":70,"offset":2007},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1942},"end":{"line":30,"column":70,"offset":2007},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1938},"end":{"line":30,"column":70,"offset":2007},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":31,"column":6,"offset":2013},"end":{"line":31,"column":29,"offset":2036},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2012},"end":{"line":31,"column":83,"offset":2090},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2012},"end":{"line":31,"column":83,"offset":2090},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":2008},"end":{"line":31,"column":83,"offset":2090},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":32,"column":6,"offset":2096},"end":{"line":32,"column":28,"offset":2118},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2095},"end":{"line":32,"column":57,"offset":2147},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2095},"end":{"line":32,"column":57,"offset":2147},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2091},"end":{"line":32,"column":57,"offset":2147},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":33,"column":6,"offset":2153},"end":{"line":33,"column":11,"offset":2158},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2152},"end":{"line":33,"column":29,"offset":2176},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2152},"end":{"line":33,"column":29,"offset":2176},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2148},"end":{"line":33,"column":29,"offset":2176},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1938},"end":{"line":33,"column":29,"offset":2176},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":35,"column":1,"offset":2178},"end":{"line":35,"column":190,"offset":2367},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2178},"end":{"line":35,"column":190,"offset":2367},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":37,"column":1,"offset":2369},"end":{"line":37,"column":99,"offset":2467},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2369},"end":{"line":37,"column":99,"offset":2467},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":39,"column":1,"offset":2469},"end":{"line":39,"column":220,"offset":2688},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2469},"end":{"line":39,"column":220,"offset":2688},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":41,"column":1,"offset":2690},"end":{"line":41,"column":98,"offset":2787},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2690},"end":{"line":41,"column":98,"offset":2787},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":43,"column":5,"offset":2793},"end":{"line":43,"column":11,"offset":2799},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2789},"end":{"line":43,"column":11,"offset":2799},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":45,"column":1,"offset":2801},"end":{"line":45,"column":303,"offset":3103},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2801},"end":{"line":45,"column":303,"offset":3103},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":47,"column":6,"offset":3110},"end":{"line":47,"column":18,"offset":3122},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3109},"end":{"line":47,"column":46,"offset":3150},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3109},"end":{"line":47,"column":46,"offset":3150},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3105},"end":{"line":47,"column":46,"offset":3150},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":48,"column":6,"offset":3156},"end":{"line":48,"column":29,"offset":3179},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3155},"end":{"line":48,"column":59,"offset":3209},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3155},"end":{"line":48,"column":59,"offset":3209},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":3151},"end":{"line":48,"column":59,"offset":3209},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3105},"end":{"line":48,"column":59,"offset":3209},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":50,"column":1,"offset":3211},"end":{"line":50,"column":368,"offset":3578},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3211},"end":{"line":50,"column":368,"offset":3578},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":52,"column":1,"offset":3580},"end":{"line":52,"column":66,"offset":3645},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3580},"end":{"line":52,"column":66,"offset":3645},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":54,"column":5,"offset":3651},"end":{"line":54,"column":21,"offset":3667},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3647},"end":{"line":54,"column":21,"offset":3667},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":56,"column":1,"offset":3669},"end":{"line":56,"column":237,"offset":3905},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3669},"end":{"line":56,"column":237,"offset":3905},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":58,"column":1,"offset":3907},"end":{"line":58,"column":105,"offset":4011},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3907},"end":{"line":58,"column":105,"offset":4011},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":60,"column":1,"offset":4013},"end":{"line":60,"column":45,"offset":4057},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4013},"end":{"line":60,"column":45,"offset":4057},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":62,"column":3,"offset":4061},"end":{"line":62,"column":380,"offset":4438},"indent":[]}}],"position":{"start":{"line":62,"column":3,"offset":4061},"end":{"line":62,"column":380,"offset":4438},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4059},"end":{"line":63,"column":1,"offset":4439},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":64,"column":3,"offset":4442},"end":{"line":65,"column":49,"offset":4756},"indent":[2]}}],"position":{"start":{"line":64,"column":3,"offset":4442},"end":{"line":65,"column":49,"offset":4756},"indent":[2]}}],"position":{"start":{"line":64,"column":1,"offset":4440},"end":{"line":65,"column":49,"offset":4756},"indent":[1]}}],"position":{"start":{"line":62,"column":1,"offset":4059},"end":{"line":65,"column":49,"offset":4756},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":67,"column":5,"offset":4762},"end":{"line":67,"column":13,"offset":4770},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":4758},"end":{"line":67,"column":13,"offset":4770},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":69,"column":1,"offset":4772},"end":{"line":69,"column":156,"offset":4927},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":69,"column":156,"offset":4927},"end":{"line":69,"column":177,"offset":4948},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":69,"column":177,"offset":4948},"end":{"line":69,"column":188,"offset":4959},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":69,"column":188,"offset":4959},"end":{"line":69,"column":193,"offset":4964},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":69,"column":193,"offset":4964},"end":{"line":69,"column":379,"offset":5150},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4772},"end":{"line":69,"column":379,"offset":5150},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":71,"column":1,"offset":5152},"end":{"line":71,"column":68,"offset":5219},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":5152},"end":{"line":71,"column":68,"offset":5219},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":73,"column":4,"offset":5224},"end":{"line":73,"column":13,"offset":5233},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5221},"end":{"line":73,"column":13,"offset":5233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":75,"column":1,"offset":5235},"end":{"line":75,"column":44,"offset":5278},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":75,"column":46,"offset":5280},"end":{"line":75,"column":68,"offset":5302},"indent":[]}}],"position":{"start":{"line":75,"column":44,"offset":5278},"end":{"line":75,"column":70,"offset":5304},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":75,"column":70,"offset":5304},"end":{"line":75,"column":106,"offset":5340},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":75,"column":108,"offset":5342},"end":{"line":75,"column":129,"offset":5363},"indent":[]}}],"position":{"start":{"line":75,"column":106,"offset":5340},"end":{"line":75,"column":131,"offset":5365},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":75,"column":131,"offset":5365},"end":{"line":75,"column":159,"offset":5393},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5235},"end":{"line":75,"column":159,"offset":5393},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":78,"column":1,"offset":5396},"end":{"line":78,"column":31,"offset":5426},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":78,"column":31,"offset":5426}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be localated on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a4c89cefb1eec7b6088a7971d4d29ea3.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a4c89cefb1eec7b6088a7971d4d29ea3.json new file mode 100644 index 0000000..1cfd463 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a4c89cefb1eec7b6088a7971d4d29ea3.json @@ -0,0 +1 @@ +{"expireTime":9007200861750342000,"key":"gatsby-plugin-mdx-entire-payload-b597075624bcd88a07954cb22e92a5e6-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Enterprise","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.","position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}}],"position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Next to that many other vendors started working on custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, and in the end delivering a closed software solution with limited API and/or messaging capabilities.","position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":242,"offset":1019},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":242,"offset":1019},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the start.","position":{"start":{"line":18,"column":1,"offset":1021},"end":{"line":18,"column":266,"offset":1286},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1021},"end":{"line":18,"column":266,"offset":1286},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":20,"column":1,"offset":1288},"end":{"line":22,"column":11,"offset":1490},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":24,"column":4,"offset":1495},"end":{"line":24,"column":14,"offset":1505},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1492},"end":{"line":24,"column":14,"offset":1505},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.","position":{"start":{"line":26,"column":1,"offset":1507},"end":{"line":26,"column":306,"offset":1812},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1507},"end":{"line":26,"column":306,"offset":1812},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":28,"column":1,"offset":1814},"end":{"line":28,"column":91,"offset":1904},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1814},"end":{"line":28,"column":91,"offset":1904},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).","position":{"start":{"line":30,"column":1,"offset":1906},"end":{"line":30,"column":239,"offset":2144},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1906},"end":{"line":30,"column":239,"offset":2144},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.","position":{"start":{"line":32,"column":1,"offset":2146},"end":{"line":32,"column":242,"offset":2387},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2146},"end":{"line":32,"column":242,"offset":2387},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.","position":{"start":{"line":34,"column":1,"offset":2389},"end":{"line":34,"column":205,"offset":2593},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2389},"end":{"line":34,"column":205,"offset":2593},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud or on premise","position":{"start":{"line":36,"column":4,"offset":2598},"end":{"line":36,"column":23,"offset":2617},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2595},"end":{"line":36,"column":23,"offset":2617},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.","position":{"start":{"line":38,"column":1,"offset":2619},"end":{"line":38,"column":283,"offset":2901},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2619},"end":{"line":38,"column":283,"offset":2901},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":40,"column":1,"offset":2903},"end":{"line":40,"column":97,"offset":2999},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2903},"end":{"line":40,"column":97,"offset":2999},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":42,"column":4,"offset":3004},"end":{"line":42,"column":13,"offset":3013},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":3001},"end":{"line":42,"column":13,"offset":3013},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is publicly available and ","position":{"start":{"line":44,"column":1,"offset":3015},"end":{"line":44,"column":47,"offset":3061},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":44,"column":49,"offset":3063},"end":{"line":44,"column":57,"offset":3071},"indent":[]}}],"position":{"start":{"line":44,"column":47,"offset":3061},"end":{"line":44,"column":59,"offset":3073},"indent":[]}},{"type":"text","value":" require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.","position":{"start":{"line":44,"column":59,"offset":3073},"end":{"line":44,"column":174,"offset":3188},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":3015},"end":{"line":44,"column":174,"offset":3188},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":47,"column":1,"offset":3191},"end":{"line":47,"column":31,"offset":3221},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":47,"column":31,"offset":3221}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Enterprise`}

\n

{`Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.`}

\n

{`That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.`}

\n

{`Next to that many other vendors started working on custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, and in the end delivering a closed software solution with limited API and/or messaging capabilities.`}

\n

{`Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the start.`}

\n
\n
\n

\n

{`Kubernetes`}

\n

{`To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.`}

\n

\"architecture

\n

{`Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).`}

\n

{`Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.`}

\n

{`By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.`}

\n

{`Cloud or on premise`}

\n

{`You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.`}

\n

\"architecture

\n

{`Licensing`}

\n

{`Kerberos Enterprise is publicly available and `}{`does not`}{` require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a6938358bbcdac0e8e674230923be759.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a6938358bbcdac0e8e674230923be759.json new file mode 100644 index 0000000..ac3a89d --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a6938358bbcdac0e8e674230923be759.json @@ -0,0 +1 @@ +{"expireTime":9007200861824976000,"key":"gatsby-plugin-mdx-entire-payload-d7969a6ff7fe30f5f715cc9c2d597324-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import SettingsIcon from '@material-ui/icons/Settings';","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":56,"offset":214},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Get Started","position":{"start":{"line":10,"column":3,"offset":218},"end":{"line":10,"column":14,"offset":229},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":216},"end":{"line":10,"column":14,"offset":229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.","position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known ","position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":169,"offset":679},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":14,"column":169,"offset":679},"end":{"line":14,"column":178,"offset":688},"indent":[]}},{"type":"text","value":" command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.","position":{"start":{"line":14,"column":178,"offset":688},"end":{"line":14,"column":314,"offset":824},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":314,"offset":824},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":16,"column":1,"offset":826},"end":{"line":18,"column":11,"offset":1028},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Login page","position":{"start":{"line":20,"column":4,"offset":1033},"end":{"line":20,"column":14,"offset":1043},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1030},"end":{"line":20,"column":14,"offset":1043},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.","position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/login.gif","alt":"Factory","position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The default username password of the Factory web applications is:","position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"username: ","position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":13,"offset":1310},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":28,"column":15,"offset":1312},"end":{"line":28,"column":19,"offset":1316},"indent":[]}}],"position":{"start":{"line":28,"column":13,"offset":1310},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":28,"column":21,"offset":1318},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"password: ","position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":13,"offset":1331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"kerberos","position":{"start":{"line":29,"column":15,"offset":1333},"end":{"line":29,"column":23,"offset":1341},"indent":[]}}],"position":{"start":{"line":29,"column":13,"offset":1331},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1319},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":29,"column":25,"offset":1343},"indent":[1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"The username and password ","position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":29,"offset":1373},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/enterprise/blob/master/yaml/factory/deployment.yaml#L54","children":[{"type":"text","value":"can be changed in the ","position":{"start":{"line":31,"column":30,"offset":1374},"end":{"line":31,"column":52,"offset":1396},"indent":[]}},{"type":"inlineCode","value":"deploment.yaml","position":{"start":{"line":31,"column":52,"offset":1396},"end":{"line":31,"column":68,"offset":1412},"indent":[]}},{"type":"text","value":" file","position":{"start":{"line":31,"column":68,"offset":1412},"end":{"line":31,"column":73,"offset":1417},"indent":[]}}],"position":{"start":{"line":31,"column":29,"offset":1373},"end":{"line":31,"column":162,"offset":1506},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":162,"offset":1506},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1345},"end":{"line":31,"column":163,"offset":1507},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Overview","position":{"start":{"line":33,"column":4,"offset":1512},"end":{"line":33,"column":12,"offset":1520},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1509},"end":{"line":33,"column":12,"offset":1520},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: ","position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":146,"offset":1667},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Docker","position":{"start":{"line":35,"column":148,"offset":1669},"end":{"line":35,"column":154,"offset":1675},"indent":[]}}],"position":{"start":{"line":35,"column":146,"offset":1667},"end":{"line":35,"column":156,"offset":1677},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":35,"column":156,"offset":1677},"end":{"line":35,"column":161,"offset":1682},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":35,"column":163,"offset":1684},"end":{"line":35,"column":173,"offset":1694},"indent":[]}}],"position":{"start":{"line":35,"column":161,"offset":1682},"end":{"line":35,"column":175,"offset":1696},"indent":[]}},{"type":"text","value":". Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.","position":{"start":{"line":35,"column":175,"offset":1696},"end":{"line":35,"column":317,"offset":1838},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":317,"offset":1838},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.","position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/docker-Kubernetes.gif","alt":"Factory","position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":41,"column":4,"offset":2094},"end":{"line":41,"column":14,"offset":2104},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2091},"end":{"line":41,"column":14,"offset":2104},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:","position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Nodes: a list of all the nodes in your cluster.","position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":45,"column":50,"offset":2255},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Deployments: a list of all the Kerberos Enterprise agents running in your cluster.","position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":2256},"end":{"line":46,"column":85,"offset":2340},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pods: all the pods running in your cluster.","position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2341},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":47,"column":46,"offset":2386},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Nodes","position":{"start":{"line":49,"column":4,"offset":2391},"end":{"line":49,"column":9,"offset":2396},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":2388},"end":{"line":49,"column":9,"offset":2396},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.","position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-nodes.png","alt":"Factory","position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Deployments","position":{"start":{"line":55,"column":4,"offset":2700},"end":{"line":55,"column":15,"offset":2711},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2697},"end":{"line":55,"column":15,"offset":2711},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.","position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-deployments.png","alt":"Factory","position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Adding a new deployment","position":{"start":{"line":61,"column":5,"offset":3201},"end":{"line":61,"column":28,"offset":3224},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3197},"end":{"line":61,"column":28,"offset":3224},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"There are two options to add a new deployment, single deployments and bulk deployment.","position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/single-bulk-deployment.gif","alt":"Factory","position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"single deployment","position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.","position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"in bulk deployment.","position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By importing an Excel file, deployments can be created in bulk.","position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.","position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-add-bulk-deployment-excel.png","alt":"Factory","position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Configuring a deployment","position":{"start":{"line":79,"column":5,"offset":3855},"end":{"line":79,"column":29,"offset":3879},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3851},"end":{"line":79,"column":29,"offset":3879},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the ","position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":200,"offset":4080},"indent":[]}},{"type":"jsx","value":"","position":{"start":{"line":81,"column":200,"offset":4080},"end":{"line":81,"column":235,"offset":4115},"indent":[]}},{"type":"text","value":" icon. This will open a popup, allowing you to change some settings.","position":{"start":{"line":81,"column":235,"offset":4115},"end":{"line":81,"column":303,"offset":4183},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":303,"offset":4183},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/deployment-configuration.gif","alt":"Factory","position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Following settings can be changed:","position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more regions of interest,","position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":87,"column":35,"offset":4325},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Time based conditions,","position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":4326},"end":{"line":88,"column":25,"offset":4350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pre- and postrecording","position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4351},"end":{"line":89,"column":25,"offset":4375},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording","position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4376},"end":{"line":90,"column":23,"offset":4398},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Linking to ","position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":14,"offset":4412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":91,"column":15,"offset":4413},"end":{"line":91,"column":29,"offset":4427},"indent":[]}}],"position":{"start":{"line":91,"column":14,"offset":4412},"end":{"line":91,"column":38,"offset":4436},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":91,"column":38,"offset":4436},"end":{"line":91,"column":42,"offset":4440},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":91,"column":43,"offset":4441},"end":{"line":91,"column":59,"offset":4457},"indent":[]}}],"position":{"start":{"line":91,"column":42,"offset":4440},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4399},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":91,"column":83,"offset":4481},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Global configuration","position":{"start":{"line":93,"column":5,"offset":4487},"end":{"line":93,"column":25,"offset":4507},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4483},"end":{"line":93,"column":25,"offset":4507},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.","position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.","position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/global-configuration.gif","alt":"Factory Global Config","position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Upgrade or reboot a Kerberos Enterprise agent","position":{"start":{"line":101,"column":5,"offset":5046},"end":{"line":101,"column":50,"offset":5091},"indent":[]}}],"position":{"start":{"line":101,"column":1,"offset":5042},"end":{"line":101,"column":50,"offset":5091},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, ","position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":373,"offset":5465},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"a zero downtime upgrade will take place","position":{"start":{"line":103,"column":375,"offset":5467},"end":{"line":103,"column":414,"offset":5506},"indent":[]}}],"position":{"start":{"line":103,"column":373,"offset":5465},"end":{"line":103,"column":416,"offset":5508},"indent":[]}},{"type":"text","value":". Kubernetes will download the new release, create a new pod, and destroy the old one.","position":{"start":{"line":103,"column":416,"offset":5508},"end":{"line":103,"column":502,"offset":5594},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":502,"offset":5594},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.","position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}}],"position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/upgrade-reboot.gif","alt":"Upgrade and reboot","position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}}],"position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Pods","position":{"start":{"line":110,"column":4,"offset":5965},"end":{"line":110,"column":8,"offset":5969},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":5962},"end":{"line":110,"column":8,"offset":5969},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.","position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-pods.png","alt":"Factory","position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage and video management","position":{"start":{"line":117,"column":4,"offset":6482},"end":{"line":117,"column":32,"offset":6510},"indent":[]}}],"position":{"start":{"line":117,"column":1,"offset":6479},"end":{"line":117,"column":32,"offset":6510},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).","position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also ","position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":169,"offset":7035},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":121,"column":171,"offset":7037},"end":{"line":121,"column":179,"offset":7045},"indent":[]}}],"position":{"start":{"line":121,"column":169,"offset":7035},"end":{"line":121,"column":181,"offset":7047},"indent":[]}},{"type":"text","value":" have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed ","position":{"start":{"line":121,"column":181,"offset":7047},"end":{"line":121,"column":419,"offset":7285},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":121,"column":420,"offset":7286},"end":{"line":121,"column":436,"offset":7302},"indent":[]}}],"position":{"start":{"line":121,"column":419,"offset":7285},"end":{"line":121,"column":460,"offset":7326},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":121,"column":460,"offset":7326},"end":{"line":121,"column":465,"offset":7331},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":121,"column":466,"offset":7332},"end":{"line":121,"column":480,"offset":7346},"indent":[]}}],"position":{"start":{"line":121,"column":465,"offset":7331},"end":{"line":121,"column":489,"offset":7355},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":121,"column":489,"offset":7355},"end":{"line":121,"column":490,"offset":7356},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":490,"offset":7356},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":123,"column":5,"offset":7362},"end":{"line":123,"column":21,"offset":7378},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":7358},"end":{"line":123,"column":21,"offset":7378},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":125,"column":2,"offset":7381},"end":{"line":125,"column":18,"offset":7397},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":42,"offset":7421},"indent":[]}},{"type":"text","value":" is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).","position":{"start":{"line":125,"column":42,"offset":7421},"end":{"line":125,"column":328,"offset":7707},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":328,"offset":7707},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).","position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}}],"position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the ","position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":147,"offset":8189},"indent":[]}},{"type":"inlineCode","value":"cloud","position":{"start":{"line":131,"column":147,"offset":8189},"end":{"line":131,"column":154,"offset":8196},"indent":[]}},{"type":"text","value":" tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.","position":{"start":{"line":131,"column":154,"offset":8196},"end":{"line":131,"column":245,"offset":8287},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":245,"offset":8287},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Storage URI: this is the API endpoint of your Kerberos Storage instance. Typically this is in the following format: ","position":{"start":{"line":133,"column":3,"offset":8291},"end":{"line":133,"column":119,"offset":8407},"indent":[]}},{"type":"inlineCode","value":"http(s)://api.yourdomain.com/storage","position":{"start":{"line":133,"column":119,"offset":8407},"end":{"line":133,"column":157,"offset":8445},"indent":[]}},{"type":"text","value":". Where ","position":{"start":{"line":133,"column":157,"offset":8445},"end":{"line":133,"column":165,"offset":8453},"indent":[]}},{"type":"inlineCode","value":"api.yourdomain.com","position":{"start":{"line":133,"column":165,"offset":8453},"end":{"line":133,"column":185,"offset":8473},"indent":[]}},{"type":"text","value":" should match your Kerberos Storage API endpoint.","position":{"start":{"line":133,"column":185,"offset":8473},"end":{"line":133,"column":234,"offset":8522},"indent":[]}}],"position":{"start":{"line":133,"column":3,"offset":8291},"end":{"line":133,"column":234,"offset":8522},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":8289},"end":{"line":134,"column":1,"offset":8523},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Provider: the name of the provider, which you created on the Kerberos Storage providers page, to which you want to send your recordings to.","position":{"start":{"line":135,"column":3,"offset":8526},"end":{"line":135,"column":142,"offset":8665},"indent":[]}}],"position":{"start":{"line":135,"column":3,"offset":8526},"end":{"line":135,"column":142,"offset":8665},"indent":[]}}],"position":{"start":{"line":135,"column":1,"offset":8524},"end":{"line":136,"column":1,"offset":8666},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Directory: this is the subdirectory in which your files will be stored. At the time of writing this should also equal your Kerberos Cloud username, if you plan to upload to Kerberos Cloud.","position":{"start":{"line":137,"column":3,"offset":8669},"end":{"line":137,"column":191,"offset":8857},"indent":[]}}],"position":{"start":{"line":137,"column":3,"offset":8669},"end":{"line":137,"column":191,"offset":8857},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":8667},"end":{"line":138,"column":1,"offset":8858},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Access Key: this should match the access key of one of your Kerberos Storage accounts.","position":{"start":{"line":139,"column":3,"offset":8861},"end":{"line":139,"column":89,"offset":8947},"indent":[]}}],"position":{"start":{"line":139,"column":3,"offset":8861},"end":{"line":139,"column":89,"offset":8947},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":8859},"end":{"line":140,"column":1,"offset":8948},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secret Access Key: this should match the secret access key of one of your Kerberos Storage accounts.","position":{"start":{"line":141,"column":3,"offset":8951},"end":{"line":141,"column":103,"offset":9051},"indent":[]}}],"position":{"start":{"line":141,"column":3,"offset":8951},"end":{"line":141,"column":103,"offset":9051},"indent":[]}}],"position":{"start":{"line":141,"column":1,"offset":8949},"end":{"line":141,"column":103,"offset":9051},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":8289},"end":{"line":141,"column":103,"offset":9051},"indent":[1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-enterprise-storage-setup.gif","alt":"kerberos storage configuration","position":{"start":{"line":144,"column":1,"offset":9054},"end":{"line":144,"column":101,"offset":9154},"indent":[]}}],"position":{"start":{"line":144,"column":1,"offset":9054},"end":{"line":144,"column":101,"offset":9154},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":146,"column":5,"offset":9160},"end":{"line":146,"column":19,"offset":9174},"indent":[]}}],"position":{"start":{"line":146,"column":1,"offset":9156},"end":{"line":146,"column":19,"offset":9174},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more ","position":{"start":{"line":148,"column":1,"offset":9176},"end":{"line":148,"column":219,"offset":9394},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"about the features and functions here","position":{"start":{"line":148,"column":220,"offset":9395},"end":{"line":148,"column":257,"offset":9432},"indent":[]}}],"position":{"start":{"line":148,"column":219,"offset":9394},"end":{"line":148,"column":266,"offset":9441},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":148,"column":266,"offset":9441},"end":{"line":148,"column":267,"offset":9442},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":9176},"end":{"line":148,"column":267,"offset":9442},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the ","position":{"start":{"line":150,"column":1,"offset":9444},"end":{"line":150,"column":285,"offset":9728},"indent":[]}},{"type":"link","title":null,"url":"/storage/get-started","children":[{"type":"text","value":"Kerberos Storage page","position":{"start":{"line":150,"column":286,"offset":9729},"end":{"line":150,"column":307,"offset":9750},"indent":[]}}],"position":{"start":{"line":150,"column":285,"offset":9728},"end":{"line":150,"column":330,"offset":9773},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":150,"column":330,"offset":9773},"end":{"line":150,"column":331,"offset":9774},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":9444},"end":{"line":150,"column":331,"offset":9774},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.","position":{"start":{"line":152,"column":1,"offset":9776},"end":{"line":152,"column":104,"offset":9879},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":9776},"end":{"line":152,"column":104,"offset":9879},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-enterprise-to-cloud.gif","alt":"kerberos storage configuration","position":{"start":{"line":154,"column":1,"offset":9881},"end":{"line":154,"column":96,"offset":9976},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":9881},"end":{"line":154,"column":96,"offset":9976},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Region: this is the region where your recordings will be stored. Only ","position":{"start":{"line":157,"column":3,"offset":9981},"end":{"line":157,"column":73,"offset":10051},"indent":[]}},{"type":"inlineCode","value":"eu-west-1","position":{"start":{"line":157,"column":73,"offset":10051},"end":{"line":157,"column":84,"offset":10062},"indent":[]}},{"type":"text","value":" for now (will change, on the roadmap).","position":{"start":{"line":157,"column":84,"offset":10062},"end":{"line":157,"column":123,"offset":10101},"indent":[]}}],"position":{"start":{"line":157,"column":3,"offset":9981},"end":{"line":157,"column":123,"offset":10101},"indent":[]}}],"position":{"start":{"line":157,"column":1,"offset":9979},"end":{"line":158,"column":1,"offset":10102},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Bucket: the name of the Kerberos Cloud bucket. Only ","position":{"start":{"line":159,"column":3,"offset":10105},"end":{"line":159,"column":56,"offset":10158},"indent":[]}},{"type":"inlineCode","value":"kerberosaccept","position":{"start":{"line":159,"column":56,"offset":10158},"end":{"line":159,"column":72,"offset":10174},"indent":[]}},{"type":"text","value":" for now (will change, on the roadmap).","position":{"start":{"line":159,"column":72,"offset":10174},"end":{"line":159,"column":111,"offset":10213},"indent":[]}}],"position":{"start":{"line":159,"column":3,"offset":10105},"end":{"line":159,"column":111,"offset":10213},"indent":[]}}],"position":{"start":{"line":159,"column":1,"offset":10103},"end":{"line":160,"column":1,"offset":10214},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Directory: this is your personal directory, and matches your Kerberos Cloud username.","position":{"start":{"line":161,"column":3,"offset":10217},"end":{"line":161,"column":88,"offset":10302},"indent":[]}}],"position":{"start":{"line":161,"column":3,"offset":10217},"end":{"line":161,"column":88,"offset":10302},"indent":[]}}],"position":{"start":{"line":161,"column":1,"offset":10215},"end":{"line":162,"column":1,"offset":10303},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Public Key: this should match the public key of your Kerberos Cloud subscription.","position":{"start":{"line":163,"column":3,"offset":10306},"end":{"line":163,"column":84,"offset":10387},"indent":[]}}],"position":{"start":{"line":163,"column":3,"offset":10306},"end":{"line":163,"column":84,"offset":10387},"indent":[]}}],"position":{"start":{"line":163,"column":1,"offset":10304},"end":{"line":164,"column":1,"offset":10388},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secret Access Key: this should match the private key of your Kerberos Cloud subscription.","position":{"start":{"line":165,"column":3,"offset":10391},"end":{"line":165,"column":92,"offset":10480},"indent":[]}}],"position":{"start":{"line":165,"column":3,"offset":10391},"end":{"line":165,"column":92,"offset":10480},"indent":[]}}],"position":{"start":{"line":165,"column":1,"offset":10389},"end":{"line":165,"column":92,"offset":10480},"indent":[]}}],"position":{"start":{"line":157,"column":1,"offset":9979},"end":{"line":165,"column":92,"offset":10480},"indent":[1,1,1,1,1,1,1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":168,"column":1,"offset":10483},"end":{"line":168,"column":31,"offset":10513},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":168,"column":31,"offset":10513}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport SettingsIcon from '@material-ui/icons/Settings';\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Get Started`}

\n

{`Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.`}

\n

{`Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known `}{`kubectl`}{` command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.`}

\n
\n
\n

\n

{`Login page`}

\n

{`Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.`}

\n

\"Factory\"

\n

{`The default username password of the Factory web applications is:`}

\n
    \n
  • {`username: `}{`root`}
    • \n
  • {`password: `}{`kerberos`}
    • \n
\n
\n

{`The username and password `}{`can be changed in the `}{`deploment.yaml`}{` file`}{`.`}

\n
\n

{`Overview`}

\n

{`On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: `}{`Docker`}{` and `}{`Kubernetes`}{`. Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.`}

\n

{`When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.`}

\n

\"Factory\"

\n

{`Kubernetes`}

\n

{`On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:`}

\n
    \n
  • {`Nodes: a list of all the nodes in your cluster.`}
    • \n
  • {`Deployments: a list of all the Kerberos Enterprise agents running in your cluster.`}
    • \n
  • {`Pods: all the pods running in your cluster.`}
    • \n
\n

{`Nodes`}

\n

{`The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.`}

\n

\"Factory\"

\n

{`Deployments`}

\n

{`The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.`}

\n

\"Factory\"

\n

{`Adding a new deployment`}

\n

{`There are two options to add a new deployment, single deployments and bulk deployment.`}

\n

\"Factory\"

\n
    \n
  • {`single deployment`}
    • \n
\n

{`By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.`}

\n
    \n
  • {`in bulk deployment.`}
    • \n
\n

{`By importing an Excel file, deployments can be created in bulk.`}

\n

{`By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.`}

\n

\"Factory\"

\n

{`Configuring a deployment`}

\n

{`Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the `}{` icon. This will open a popup, allowing you to change some settings.`}

\n

\"Factory\"

\n

{`Following settings can be changed:`}

\n
    \n
  • {`One or more regions of interest,`}
    • \n
  • {`Time based conditions,`}
    • \n
  • {`Pre- and postrecording`}
    • \n
  • {`Continious recording`}
    • \n
  • {`Linking to `}{`Kerberos Cloud`}{` or `}{`Kerberos Storage`}
    • \n
\n

{`Global configuration`}

\n

{`Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.`}

\n

{`By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.`}

\n

\"Factory

\n

{`Upgrade or reboot a Kerberos Enterprise agent`}

\n

{`At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, `}{`a zero downtime upgrade will take place`}{`. Kubernetes will download the new release, create a new pod, and destroy the old one.`}

\n

{`At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.`}

\n

\"Upgrade

\n

{`Pods`}

\n

{`When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.`}

\n

\"Factory\"

\n

{`Storage and video management`}

\n

{`Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).`}

\n

{`Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also `}{`does not`}{` have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed `}{`Kerberos Storage`}{` and `}{`Kerberos Cloud`}{`.`}

\n

{`Kerberos Storage`}

\n

{`Kerberos Storage`}{` is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).`}

\n

{`On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).`}

\n

\"architecture

\n

{`To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the `}{`cloud`}{` tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.`}

\n
    \n
  • \n

    {`Storage URI: this is the API endpoint of your Kerberos Storage instance. Typically this is in the following format: `}{`http(s)://api.yourdomain.com/storage`}{`. Where `}{`api.yourdomain.com`}{` should match your Kerberos Storage API endpoint.`}

    \n
    • \n
  • \n

    {`Provider: the name of the provider, which you created on the Kerberos Storage providers page, to which you want to send your recordings to.`}

    \n
    • \n
  • \n

    {`Directory: this is the subdirectory in which your files will be stored. At the time of writing this should also equal your Kerberos Cloud username, if you plan to upload to Kerberos Cloud.`}

    \n
    • \n
  • \n

    {`Access Key: this should match the access key of one of your Kerberos Storage accounts.`}

    \n
    • \n
  • \n

    {`Secret Access Key: this should match the secret access key of one of your Kerberos Storage accounts.`}

    \n
    • \n
\n

\"kerberos

\n

{`Kerberos Cloud`}

\n

{`For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more `}{`about the features and functions here`}{`.`}

\n

{`You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the `}{`Kerberos Storage page`}{`.`}

\n

{`Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.`}

\n

\"kerberos

\n
    \n
  • \n

    {`Region: this is the region where your recordings will be stored. Only `}{`eu-west-1`}{` for now (will change, on the roadmap).`}

    \n
    • \n
  • \n

    {`Bucket: the name of the Kerberos Cloud bucket. Only `}{`kerberosaccept`}{` for now (will change, on the roadmap).`}

    \n
    • \n
  • \n

    {`Directory: this is your personal directory, and matches your Kerberos Cloud username.`}

    \n
    • \n
  • \n

    {`Public Key: this should match the public key of your Kerberos Cloud subscription.`}

    \n
    • \n
  • \n

    {`Secret Access Key: this should match the private key of your Kerberos Cloud subscription.`}

    \n
    • \n
\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a89b84451932065903e6bf25d9b03550.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a89b84451932065903e6bf25d9b03550.json index 0a90c1f..b2a759a 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a89b84451932065903e6bf25d9b03550.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a89b84451932065903e6bf25d9b03550.json @@ -1 +1 @@ -{"expireTime":9007200861747673000,"key":"gatsby-plugin-mdx-entire-payload-7b81f609843c42116aa94d7c916b4828-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"CC BY-NC-SA 4.0","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":18,"offset":176},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":18,"offset":176},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Summary","position":{"start":{"line":10,"column":4,"offset":181},"end":{"line":10,"column":11,"offset":188},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":178},"end":{"line":10,"column":11,"offset":188},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You are free to:","position":{"start":{"line":12,"column":1,"offset":190},"end":{"line":12,"column":17,"offset":206},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":190},"end":{"line":12,"column":17,"offset":206},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Share — copy and redistribute the material in any medium or format","position":{"start":{"line":14,"column":3,"offset":210},"end":{"line":14,"column":69,"offset":276},"indent":[]}}],"position":{"start":{"line":14,"column":3,"offset":210},"end":{"line":14,"column":69,"offset":276},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":208},"end":{"line":14,"column":69,"offset":276},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Adapt — remix, transform, and build upon the material","position":{"start":{"line":15,"column":3,"offset":279},"end":{"line":15,"column":56,"offset":332},"indent":[]}}],"position":{"start":{"line":15,"column":3,"offset":279},"end":{"line":15,"column":56,"offset":332},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":277},"end":{"line":15,"column":56,"offset":332},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":208},"end":{"line":15,"column":56,"offset":332},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"The license","position":{"start":{"line":17,"column":4,"offset":337},"end":{"line":17,"column":15,"offset":348},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":334},"end":{"line":17,"column":15,"offset":348},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License\nBy exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License (\"Public License\"). To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions.","position":{"start":{"line":19,"column":1,"offset":350},"end":{"line":20,"column":567,"offset":1003},"indent":[1]}}],"position":{"start":{"line":19,"column":1,"offset":350},"end":{"line":20,"column":567,"offset":1003},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 1 – Definitions.","position":{"start":{"line":22,"column":5,"offset":1009},"end":{"line":22,"column":29,"offset":1033},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1005},"end":{"line":22,"column":29,"offset":1033},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Adapted Material means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.\nAdapter's License means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License.\nBY-NC-SA Compatible License means a license listed at creativecommons.org/compatiblelicenses, approved by Creative Commons as essentially the equivalent of this Public License.\nCopyright and Similar Rights means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.\nEffective Technological Measures means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.\nExceptions and Limitations means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.\nLicense Elements means the license attributes listed in the name of a Creative Commons Public License. The License Elements of this Public License are Attribution, NonCommercial, and ShareAlike.\nLicensed Material means the artistic or literary work, database, or other material to which the Licensor applied this Public License.\nLicensed Rights means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.\nLicensor means the individual(s) or entity(ies) granting rights under this Public License.\nNonCommercial means not primarily intended for or directed towards commercial advantage or monetary compensation. For purposes of this Public License, the exchange of the Licensed Material for other material subject to Copyright and Similar Rights by digital file-sharing or similar means is NonCommercial provided there is no payment of monetary compensation in connection with the exchange.\nShare means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.\nSui Generis Database Rights means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.\nYou means the individual or entity exercising the Licensed Rights under this Public License. Your has a corresponding meaning.","position":{"start":{"line":24,"column":1,"offset":1035},"end":{"line":37,"column":127,"offset":4698},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1]}}],"position":{"start":{"line":24,"column":1,"offset":1035},"end":{"line":37,"column":127,"offset":4698},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 2 – Scope.","position":{"start":{"line":39,"column":5,"offset":4704},"end":{"line":39,"column":23,"offset":4722},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":4700},"end":{"line":39,"column":23,"offset":4722},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"License grant.\nSubject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to:\nreproduce and Share the Licensed Material, in whole or in part, for NonCommercial purposes only; and\nproduce, reproduce, and Share Adapted Material for NonCommercial purposes only.\nExceptions and Limitations. For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions.\nTerm. The term of this Public License is specified in Section 6(a).\nMedia and formats; technical modifications allowed. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material.\nDownstream recipients.\nOffer from the Licensor – Licensed Material. Every recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License.\nAdditional offer from the Licensor – Adapted Material. Every recipient of Adapted Material from You automatically receives an offer from the Licensor to exercise the Licensed Rights in the Adapted Material under the conditions of the Adapter’s License You apply.\nNo downstream restrictions. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, the Licensed Material if doing so restricts exercise of the Licensed Rights by any recipient of the Licensed Material.\nNo endorsement. Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated to receive attribution as provided in Section 3(a)(1)(A)(i).\nOther rights.","position":{"start":{"line":41,"column":1,"offset":4724},"end":{"line":53,"column":14,"offset":7185},"indent":[1,1,1,1,1,1,1,1,1,1,1,1]}}],"position":{"start":{"line":41,"column":1,"offset":4724},"end":{"line":53,"column":14,"offset":7185},"indent":[1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Moral rights, such as the right of integrity, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives and/or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights, but not otherwise.\nPatent and trademark rights are not licensed under this Public License.\nTo the extent possible, the Licensor waives any right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves any right to collect such royalties, including when the Licensed Material is used other than for NonCommercial purposes.","position":{"start":{"line":55,"column":1,"offset":7187},"end":{"line":57,"column":420,"offset":8052},"indent":[1,1]}}],"position":{"start":{"line":55,"column":1,"offset":7187},"end":{"line":57,"column":420,"offset":8052},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 3 – License Conditions.","position":{"start":{"line":59,"column":5,"offset":8058},"end":{"line":59,"column":36,"offset":8089},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":8054},"end":{"line":59,"column":36,"offset":8089},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Your exercise of the Licensed Rights is expressly made subject to the following conditions.","position":{"start":{"line":61,"column":1,"offset":8091},"end":{"line":61,"column":92,"offset":8182},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":8091},"end":{"line":61,"column":92,"offset":8182},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Attribution.","position":{"start":{"line":63,"column":1,"offset":8184},"end":{"line":63,"column":13,"offset":8196},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":8184},"end":{"line":63,"column":13,"offset":8196},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If You Share the Licensed Material (including in modified form), You must:","position":{"start":{"line":65,"column":1,"offset":8198},"end":{"line":65,"column":75,"offset":8272},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":8198},"end":{"line":65,"column":75,"offset":8272},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"retain the following if it is supplied by the Licensor with the Licensed Material:\nidentification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);\na copyright notice;\na notice that refers to this Public License;\na notice that refers to the disclaimer of warranties;\na URI or hyperlink to the Licensed Material to the extent reasonably practicable;\nindicate if You modified the Licensed Material and retain an indication of any previous modifications; and\nindicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.\nYou may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.\nIf requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable.\nShareAlike.\nIn addition to the conditions in Section 3(a), if You Share Adapted Material You produce, the following conditions also apply.","position":{"start":{"line":67,"column":1,"offset":8274},"end":{"line":78,"column":127,"offset":9587},"indent":[1,1,1,1,1,1,1,1,1,1,1]}}],"position":{"start":{"line":67,"column":1,"offset":8274},"end":{"line":78,"column":127,"offset":9587},"indent":[1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"The Adapter’s License You apply must be a Creative Commons license with the same License Elements, this version or later, or a BY-NC-SA Compatible License.\nYou must include the text of, or the URI or hyperlink to, the Adapter's License You apply. You may satisfy this condition in any reasonable manner based on the medium, means, and context in which You Share Adapted Material.\nYou may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, Adapted Material that restrict exercise of the rights granted under the Adapter's License You apply.","position":{"start":{"line":80,"column":1,"offset":9589},"end":{"line":82,"column":231,"offset":10199},"indent":[1,1]}}],"position":{"start":{"line":80,"column":1,"offset":9589},"end":{"line":82,"column":231,"offset":10199},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 4 – Sui Generis Database Rights.","position":{"start":{"line":84,"column":5,"offset":10205},"end":{"line":84,"column":45,"offset":10245},"indent":[]}}],"position":{"start":{"line":84,"column":1,"offset":10201},"end":{"line":84,"column":45,"offset":10245},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Where the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:","position":{"start":{"line":86,"column":1,"offset":10247},"end":{"line":86,"column":111,"offset":10357},"indent":[]}}],"position":{"start":{"line":86,"column":1,"offset":10247},"end":{"line":86,"column":111,"offset":10357},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database for NonCommercial purposes only;\nif You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Database Rights (but not its individual contents) is Adapted Material, including for purposes of Section 3(b); and\nYou must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.\nFor the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.","position":{"start":{"line":88,"column":1,"offset":10359},"end":{"line":91,"column":189,"offset":11166},"indent":[1,1,1]}}],"position":{"start":{"line":88,"column":1,"offset":10359},"end":{"line":91,"column":189,"offset":11166},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 5 – Disclaimer of Warranties and Limitation of Liability.","position":{"start":{"line":93,"column":5,"offset":11172},"end":{"line":93,"column":70,"offset":11237},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":11168},"end":{"line":93,"column":70,"offset":11237},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Unless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.\nTo the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.\nThe disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.","position":{"start":{"line":95,"column":1,"offset":11239},"end":{"line":97,"column":213,"offset":12637},"indent":[1,1]}}],"position":{"start":{"line":95,"column":1,"offset":11239},"end":{"line":97,"column":213,"offset":12637},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 6 – Term and Termination.","position":{"start":{"line":99,"column":5,"offset":12643},"end":{"line":99,"column":38,"offset":12676},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":12639},"end":{"line":99,"column":38,"offset":12676},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.\nWhere Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:","position":{"start":{"line":101,"column":1,"offset":12678},"end":{"line":102,"column":96,"offset":12990},"indent":[1]}}],"position":{"start":{"line":101,"column":1,"offset":12678},"end":{"line":102,"column":96,"offset":12990},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or\nupon express reinstatement by the Licensor.\nFor the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License.\nFor the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License.\nSections 1, 5, 6, 7, and 8 survive termination of this Public License.","position":{"start":{"line":104,"column":1,"offset":12992},"end":{"line":108,"column":71,"offset":13616},"indent":[1,1,1,1]}}],"position":{"start":{"line":104,"column":1,"offset":12992},"end":{"line":108,"column":71,"offset":13616},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 7 – Other Terms and Conditions.","position":{"start":{"line":110,"column":5,"offset":13622},"end":{"line":110,"column":44,"offset":13661},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":13618},"end":{"line":110,"column":44,"offset":13661},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed.\nAny arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.","position":{"start":{"line":112,"column":1,"offset":13663},"end":{"line":113,"column":184,"offset":13974},"indent":[1]}}],"position":{"start":{"line":112,"column":1,"offset":13663},"end":{"line":113,"column":184,"offset":13974},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 8 – Interpretation.","position":{"start":{"line":115,"column":5,"offset":13980},"end":{"line":115,"column":32,"offset":14007},"indent":[]}}],"position":{"start":{"line":115,"column":1,"offset":13976},"end":{"line":115,"column":32,"offset":14007},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.\nTo the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.\nNo term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.\nNothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.","position":{"start":{"line":117,"column":1,"offset":14009},"end":{"line":120,"column":235,"offset":14969},"indent":[1,1,1]}}],"position":{"start":{"line":117,"column":1,"offset":14009},"end":{"line":120,"column":235,"offset":14969},"indent":[1,1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":123,"column":1,"offset":14972},"end":{"line":123,"column":31,"offset":15002},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":123,"column":31,"offset":15002}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`CC BY-NC-SA 4.0`}

\n

{`Summary`}

\n

{`You are free to:`}

\n
    \n
  • {`Share — copy and redistribute the material in any medium or format`}
    • \n
  • {`Adapt — remix, transform, and build upon the material`}
    • \n
\n

{`The license`}

\n

{`Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License\nBy exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License (\"Public License\"). To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions.`}

\n

{`Section 1 – Definitions.`}

\n

{`Adapted Material means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.\nAdapter's License means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License.\nBY-NC-SA Compatible License means a license listed at creativecommons.org/compatiblelicenses, approved by Creative Commons as essentially the equivalent of this Public License.\nCopyright and Similar Rights means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.\nEffective Technological Measures means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.\nExceptions and Limitations means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.\nLicense Elements means the license attributes listed in the name of a Creative Commons Public License. The License Elements of this Public License are Attribution, NonCommercial, and ShareAlike.\nLicensed Material means the artistic or literary work, database, or other material to which the Licensor applied this Public License.\nLicensed Rights means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.\nLicensor means the individual(s) or entity(ies) granting rights under this Public License.\nNonCommercial means not primarily intended for or directed towards commercial advantage or monetary compensation. For purposes of this Public License, the exchange of the Licensed Material for other material subject to Copyright and Similar Rights by digital file-sharing or similar means is NonCommercial provided there is no payment of monetary compensation in connection with the exchange.\nShare means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.\nSui Generis Database Rights means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.\nYou means the individual or entity exercising the Licensed Rights under this Public License. Your has a corresponding meaning.`}

\n

{`Section 2 – Scope.`}

\n

{`License grant.\nSubject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to:\nreproduce and Share the Licensed Material, in whole or in part, for NonCommercial purposes only; and\nproduce, reproduce, and Share Adapted Material for NonCommercial purposes only.\nExceptions and Limitations. For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions.\nTerm. The term of this Public License is specified in Section 6(a).\nMedia and formats; technical modifications allowed. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material.\nDownstream recipients.\nOffer from the Licensor – Licensed Material. Every recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License.\nAdditional offer from the Licensor – Adapted Material. Every recipient of Adapted Material from You automatically receives an offer from the Licensor to exercise the Licensed Rights in the Adapted Material under the conditions of the Adapter’s License You apply.\nNo downstream restrictions. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, the Licensed Material if doing so restricts exercise of the Licensed Rights by any recipient of the Licensed Material.\nNo endorsement. Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated to receive attribution as provided in Section 3(a)(1)(A)(i).\nOther rights.`}

\n

{`Moral rights, such as the right of integrity, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives and/or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights, but not otherwise.\nPatent and trademark rights are not licensed under this Public License.\nTo the extent possible, the Licensor waives any right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves any right to collect such royalties, including when the Licensed Material is used other than for NonCommercial purposes.`}

\n

{`Section 3 – License Conditions.`}

\n

{`Your exercise of the Licensed Rights is expressly made subject to the following conditions.`}

\n

{`Attribution.`}

\n

{`If You Share the Licensed Material (including in modified form), You must:`}

\n

{`retain the following if it is supplied by the Licensor with the Licensed Material:\nidentification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);\na copyright notice;\na notice that refers to this Public License;\na notice that refers to the disclaimer of warranties;\na URI or hyperlink to the Licensed Material to the extent reasonably practicable;\nindicate if You modified the Licensed Material and retain an indication of any previous modifications; and\nindicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.\nYou may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.\nIf requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable.\nShareAlike.\nIn addition to the conditions in Section 3(a), if You Share Adapted Material You produce, the following conditions also apply.`}

\n

{`The Adapter’s License You apply must be a Creative Commons license with the same License Elements, this version or later, or a BY-NC-SA Compatible License.\nYou must include the text of, or the URI or hyperlink to, the Adapter's License You apply. You may satisfy this condition in any reasonable manner based on the medium, means, and context in which You Share Adapted Material.\nYou may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, Adapted Material that restrict exercise of the rights granted under the Adapter's License You apply.`}

\n

{`Section 4 – Sui Generis Database Rights.`}

\n

{`Where the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:`}

\n

{`for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database for NonCommercial purposes only;\nif You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Database Rights (but not its individual contents) is Adapted Material, including for purposes of Section 3(b); and\nYou must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.\nFor the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.`}

\n

{`Section 5 – Disclaimer of Warranties and Limitation of Liability.`}

\n

{`Unless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.\nTo the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.\nThe disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.`}

\n

{`Section 6 – Term and Termination.`}

\n

{`This Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.\nWhere Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:`}

\n

{`automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or\nupon express reinstatement by the Licensor.\nFor the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License.\nFor the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License.\nSections 1, 5, 6, 7, and 8 survive termination of this Public License.`}

\n

{`Section 7 – Other Terms and Conditions.`}

\n

{`The Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed.\nAny arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.`}

\n

{`Section 8 – Interpretation.`}

\n

{`For the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.\nTo the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.\nNo term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.\nNothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750177000,"key":"gatsby-plugin-mdx-entire-payload-7b81f609843c42116aa94d7c916b4828-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"CC BY-NC-SA 4.0","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":18,"offset":176},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":18,"offset":176},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Summary","position":{"start":{"line":10,"column":4,"offset":181},"end":{"line":10,"column":11,"offset":188},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":178},"end":{"line":10,"column":11,"offset":188},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You are free to:","position":{"start":{"line":12,"column":1,"offset":190},"end":{"line":12,"column":17,"offset":206},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":190},"end":{"line":12,"column":17,"offset":206},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Share — copy and redistribute the material in any medium or format","position":{"start":{"line":14,"column":3,"offset":210},"end":{"line":14,"column":69,"offset":276},"indent":[]}}],"position":{"start":{"line":14,"column":3,"offset":210},"end":{"line":14,"column":69,"offset":276},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":208},"end":{"line":14,"column":69,"offset":276},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Adapt — remix, transform, and build upon the material","position":{"start":{"line":15,"column":3,"offset":279},"end":{"line":15,"column":56,"offset":332},"indent":[]}}],"position":{"start":{"line":15,"column":3,"offset":279},"end":{"line":15,"column":56,"offset":332},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":277},"end":{"line":15,"column":56,"offset":332},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":208},"end":{"line":15,"column":56,"offset":332},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"The license","position":{"start":{"line":17,"column":4,"offset":337},"end":{"line":17,"column":15,"offset":348},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":334},"end":{"line":17,"column":15,"offset":348},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License\nBy exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License (\"Public License\"). To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions.","position":{"start":{"line":19,"column":1,"offset":350},"end":{"line":20,"column":567,"offset":1003},"indent":[1]}}],"position":{"start":{"line":19,"column":1,"offset":350},"end":{"line":20,"column":567,"offset":1003},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 1 – Definitions.","position":{"start":{"line":22,"column":5,"offset":1009},"end":{"line":22,"column":29,"offset":1033},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1005},"end":{"line":22,"column":29,"offset":1033},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Adapted Material means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.\nAdapter's License means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License.\nBY-NC-SA Compatible License means a license listed at creativecommons.org/compatiblelicenses, approved by Creative Commons as essentially the equivalent of this Public License.\nCopyright and Similar Rights means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.\nEffective Technological Measures means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.\nExceptions and Limitations means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.\nLicense Elements means the license attributes listed in the name of a Creative Commons Public License. The License Elements of this Public License are Attribution, NonCommercial, and ShareAlike.\nLicensed Material means the artistic or literary work, database, or other material to which the Licensor applied this Public License.\nLicensed Rights means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.\nLicensor means the individual(s) or entity(ies) granting rights under this Public License.\nNonCommercial means not primarily intended for or directed towards commercial advantage or monetary compensation. For purposes of this Public License, the exchange of the Licensed Material for other material subject to Copyright and Similar Rights by digital file-sharing or similar means is NonCommercial provided there is no payment of monetary compensation in connection with the exchange.\nShare means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.\nSui Generis Database Rights means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.\nYou means the individual or entity exercising the Licensed Rights under this Public License. Your has a corresponding meaning.","position":{"start":{"line":24,"column":1,"offset":1035},"end":{"line":37,"column":127,"offset":4698},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1]}}],"position":{"start":{"line":24,"column":1,"offset":1035},"end":{"line":37,"column":127,"offset":4698},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 2 – Scope.","position":{"start":{"line":39,"column":5,"offset":4704},"end":{"line":39,"column":23,"offset":4722},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":4700},"end":{"line":39,"column":23,"offset":4722},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"License grant.\nSubject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to:\nreproduce and Share the Licensed Material, in whole or in part, for NonCommercial purposes only; and\nproduce, reproduce, and Share Adapted Material for NonCommercial purposes only.\nExceptions and Limitations. For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions.\nTerm. The term of this Public License is specified in Section 6(a).\nMedia and formats; technical modifications allowed. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material.\nDownstream recipients.\nOffer from the Licensor – Licensed Material. Every recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License.\nAdditional offer from the Licensor – Adapted Material. Every recipient of Adapted Material from You automatically receives an offer from the Licensor to exercise the Licensed Rights in the Adapted Material under the conditions of the Adapter’s License You apply.\nNo downstream restrictions. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, the Licensed Material if doing so restricts exercise of the Licensed Rights by any recipient of the Licensed Material.\nNo endorsement. Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated to receive attribution as provided in Section 3(a)(1)(A)(i).\nOther rights.","position":{"start":{"line":41,"column":1,"offset":4724},"end":{"line":53,"column":14,"offset":7185},"indent":[1,1,1,1,1,1,1,1,1,1,1,1]}}],"position":{"start":{"line":41,"column":1,"offset":4724},"end":{"line":53,"column":14,"offset":7185},"indent":[1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Moral rights, such as the right of integrity, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives and/or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights, but not otherwise.\nPatent and trademark rights are not licensed under this Public License.\nTo the extent possible, the Licensor waives any right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves any right to collect such royalties, including when the Licensed Material is used other than for NonCommercial purposes.","position":{"start":{"line":55,"column":1,"offset":7187},"end":{"line":57,"column":420,"offset":8052},"indent":[1,1]}}],"position":{"start":{"line":55,"column":1,"offset":7187},"end":{"line":57,"column":420,"offset":8052},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 3 – License Conditions.","position":{"start":{"line":59,"column":5,"offset":8058},"end":{"line":59,"column":36,"offset":8089},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":8054},"end":{"line":59,"column":36,"offset":8089},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Your exercise of the Licensed Rights is expressly made subject to the following conditions.","position":{"start":{"line":61,"column":1,"offset":8091},"end":{"line":61,"column":92,"offset":8182},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":8091},"end":{"line":61,"column":92,"offset":8182},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Attribution.","position":{"start":{"line":63,"column":1,"offset":8184},"end":{"line":63,"column":13,"offset":8196},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":8184},"end":{"line":63,"column":13,"offset":8196},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If You Share the Licensed Material (including in modified form), You must:","position":{"start":{"line":65,"column":1,"offset":8198},"end":{"line":65,"column":75,"offset":8272},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":8198},"end":{"line":65,"column":75,"offset":8272},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"retain the following if it is supplied by the Licensor with the Licensed Material:\nidentification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);\na copyright notice;\na notice that refers to this Public License;\na notice that refers to the disclaimer of warranties;\na URI or hyperlink to the Licensed Material to the extent reasonably practicable;\nindicate if You modified the Licensed Material and retain an indication of any previous modifications; and\nindicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.\nYou may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.\nIf requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable.\nShareAlike.\nIn addition to the conditions in Section 3(a), if You Share Adapted Material You produce, the following conditions also apply.","position":{"start":{"line":67,"column":1,"offset":8274},"end":{"line":78,"column":127,"offset":9587},"indent":[1,1,1,1,1,1,1,1,1,1,1]}}],"position":{"start":{"line":67,"column":1,"offset":8274},"end":{"line":78,"column":127,"offset":9587},"indent":[1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"The Adapter’s License You apply must be a Creative Commons license with the same License Elements, this version or later, or a BY-NC-SA Compatible License.\nYou must include the text of, or the URI or hyperlink to, the Adapter's License You apply. You may satisfy this condition in any reasonable manner based on the medium, means, and context in which You Share Adapted Material.\nYou may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, Adapted Material that restrict exercise of the rights granted under the Adapter's License You apply.","position":{"start":{"line":80,"column":1,"offset":9589},"end":{"line":82,"column":231,"offset":10199},"indent":[1,1]}}],"position":{"start":{"line":80,"column":1,"offset":9589},"end":{"line":82,"column":231,"offset":10199},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 4 – Sui Generis Database Rights.","position":{"start":{"line":84,"column":5,"offset":10205},"end":{"line":84,"column":45,"offset":10245},"indent":[]}}],"position":{"start":{"line":84,"column":1,"offset":10201},"end":{"line":84,"column":45,"offset":10245},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Where the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:","position":{"start":{"line":86,"column":1,"offset":10247},"end":{"line":86,"column":111,"offset":10357},"indent":[]}}],"position":{"start":{"line":86,"column":1,"offset":10247},"end":{"line":86,"column":111,"offset":10357},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database for NonCommercial purposes only;\nif You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Database Rights (but not its individual contents) is Adapted Material, including for purposes of Section 3(b); and\nYou must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.\nFor the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.","position":{"start":{"line":88,"column":1,"offset":10359},"end":{"line":91,"column":189,"offset":11166},"indent":[1,1,1]}}],"position":{"start":{"line":88,"column":1,"offset":10359},"end":{"line":91,"column":189,"offset":11166},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 5 – Disclaimer of Warranties and Limitation of Liability.","position":{"start":{"line":93,"column":5,"offset":11172},"end":{"line":93,"column":70,"offset":11237},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":11168},"end":{"line":93,"column":70,"offset":11237},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Unless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.\nTo the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.\nThe disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.","position":{"start":{"line":95,"column":1,"offset":11239},"end":{"line":97,"column":213,"offset":12637},"indent":[1,1]}}],"position":{"start":{"line":95,"column":1,"offset":11239},"end":{"line":97,"column":213,"offset":12637},"indent":[1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 6 – Term and Termination.","position":{"start":{"line":99,"column":5,"offset":12643},"end":{"line":99,"column":38,"offset":12676},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":12639},"end":{"line":99,"column":38,"offset":12676},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.\nWhere Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:","position":{"start":{"line":101,"column":1,"offset":12678},"end":{"line":102,"column":96,"offset":12990},"indent":[1]}}],"position":{"start":{"line":101,"column":1,"offset":12678},"end":{"line":102,"column":96,"offset":12990},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or\nupon express reinstatement by the Licensor.\nFor the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License.\nFor the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License.\nSections 1, 5, 6, 7, and 8 survive termination of this Public License.","position":{"start":{"line":104,"column":1,"offset":12992},"end":{"line":108,"column":71,"offset":13616},"indent":[1,1,1,1]}}],"position":{"start":{"line":104,"column":1,"offset":12992},"end":{"line":108,"column":71,"offset":13616},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 7 – Other Terms and Conditions.","position":{"start":{"line":110,"column":5,"offset":13622},"end":{"line":110,"column":44,"offset":13661},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":13618},"end":{"line":110,"column":44,"offset":13661},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed.\nAny arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.","position":{"start":{"line":112,"column":1,"offset":13663},"end":{"line":113,"column":184,"offset":13974},"indent":[1]}}],"position":{"start":{"line":112,"column":1,"offset":13663},"end":{"line":113,"column":184,"offset":13974},"indent":[1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Section 8 – Interpretation.","position":{"start":{"line":115,"column":5,"offset":13980},"end":{"line":115,"column":32,"offset":14007},"indent":[]}}],"position":{"start":{"line":115,"column":1,"offset":13976},"end":{"line":115,"column":32,"offset":14007},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.\nTo the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.\nNo term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.\nNothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.","position":{"start":{"line":117,"column":1,"offset":14009},"end":{"line":120,"column":235,"offset":14969},"indent":[1,1,1]}}],"position":{"start":{"line":117,"column":1,"offset":14009},"end":{"line":120,"column":235,"offset":14969},"indent":[1,1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":123,"column":1,"offset":14972},"end":{"line":123,"column":31,"offset":15002},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":123,"column":31,"offset":15002}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`CC BY-NC-SA 4.0`}

\n

{`Summary`}

\n

{`You are free to:`}

\n
    \n
  • {`Share — copy and redistribute the material in any medium or format`}
    • \n
  • {`Adapt — remix, transform, and build upon the material`}
    • \n
\n

{`The license`}

\n

{`Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License\nBy exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License (\"Public License\"). To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions.`}

\n

{`Section 1 – Definitions.`}

\n

{`Adapted Material means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.\nAdapter's License means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License.\nBY-NC-SA Compatible License means a license listed at creativecommons.org/compatiblelicenses, approved by Creative Commons as essentially the equivalent of this Public License.\nCopyright and Similar Rights means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.\nEffective Technological Measures means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.\nExceptions and Limitations means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.\nLicense Elements means the license attributes listed in the name of a Creative Commons Public License. The License Elements of this Public License are Attribution, NonCommercial, and ShareAlike.\nLicensed Material means the artistic or literary work, database, or other material to which the Licensor applied this Public License.\nLicensed Rights means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.\nLicensor means the individual(s) or entity(ies) granting rights under this Public License.\nNonCommercial means not primarily intended for or directed towards commercial advantage or monetary compensation. For purposes of this Public License, the exchange of the Licensed Material for other material subject to Copyright and Similar Rights by digital file-sharing or similar means is NonCommercial provided there is no payment of monetary compensation in connection with the exchange.\nShare means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.\nSui Generis Database Rights means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.\nYou means the individual or entity exercising the Licensed Rights under this Public License. Your has a corresponding meaning.`}

\n

{`Section 2 – Scope.`}

\n

{`License grant.\nSubject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to:\nreproduce and Share the Licensed Material, in whole or in part, for NonCommercial purposes only; and\nproduce, reproduce, and Share Adapted Material for NonCommercial purposes only.\nExceptions and Limitations. For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions.\nTerm. The term of this Public License is specified in Section 6(a).\nMedia and formats; technical modifications allowed. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material.\nDownstream recipients.\nOffer from the Licensor – Licensed Material. Every recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License.\nAdditional offer from the Licensor – Adapted Material. Every recipient of Adapted Material from You automatically receives an offer from the Licensor to exercise the Licensed Rights in the Adapted Material under the conditions of the Adapter’s License You apply.\nNo downstream restrictions. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, the Licensed Material if doing so restricts exercise of the Licensed Rights by any recipient of the Licensed Material.\nNo endorsement. Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated to receive attribution as provided in Section 3(a)(1)(A)(i).\nOther rights.`}

\n

{`Moral rights, such as the right of integrity, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives and/or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights, but not otherwise.\nPatent and trademark rights are not licensed under this Public License.\nTo the extent possible, the Licensor waives any right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves any right to collect such royalties, including when the Licensed Material is used other than for NonCommercial purposes.`}

\n

{`Section 3 – License Conditions.`}

\n

{`Your exercise of the Licensed Rights is expressly made subject to the following conditions.`}

\n

{`Attribution.`}

\n

{`If You Share the Licensed Material (including in modified form), You must:`}

\n

{`retain the following if it is supplied by the Licensor with the Licensed Material:\nidentification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);\na copyright notice;\na notice that refers to this Public License;\na notice that refers to the disclaimer of warranties;\na URI or hyperlink to the Licensed Material to the extent reasonably practicable;\nindicate if You modified the Licensed Material and retain an indication of any previous modifications; and\nindicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.\nYou may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.\nIf requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable.\nShareAlike.\nIn addition to the conditions in Section 3(a), if You Share Adapted Material You produce, the following conditions also apply.`}

\n

{`The Adapter’s License You apply must be a Creative Commons license with the same License Elements, this version or later, or a BY-NC-SA Compatible License.\nYou must include the text of, or the URI or hyperlink to, the Adapter's License You apply. You may satisfy this condition in any reasonable manner based on the medium, means, and context in which You Share Adapted Material.\nYou may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, Adapted Material that restrict exercise of the rights granted under the Adapter's License You apply.`}

\n

{`Section 4 – Sui Generis Database Rights.`}

\n

{`Where the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:`}

\n

{`for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database for NonCommercial purposes only;\nif You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Database Rights (but not its individual contents) is Adapted Material, including for purposes of Section 3(b); and\nYou must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.\nFor the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.`}

\n

{`Section 5 – Disclaimer of Warranties and Limitation of Liability.`}

\n

{`Unless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.\nTo the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.\nThe disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.`}

\n

{`Section 6 – Term and Termination.`}

\n

{`This Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.\nWhere Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:`}

\n

{`automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or\nupon express reinstatement by the Licensor.\nFor the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License.\nFor the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License.\nSections 1, 5, 6, 7, and 8 survive termination of this Public License.`}

\n

{`Section 7 – Other Terms and Conditions.`}

\n

{`The Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed.\nAny arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.`}

\n

{`Section 8 – Interpretation.`}

\n

{`For the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.\nTo the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.\nNo term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.\nNothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a98e93303e64d1ec3ac2cc36607447f9.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a98e93303e64d1ec3ac2cc36607447f9.json new file mode 100644 index 0000000..f5143ca --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-a98e93303e64d1ec3ac2cc36607447f9.json @@ -0,0 +1 @@ +{"expireTime":9007200861829336000,"key":"gatsby-plugin-mdx-entire-payload-c58095b959d18a08b54bac9fbd8f8c06-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":77,"offset":412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":78,"offset":413},"end":{"line":12,"column":92,"offset":427},"indent":[]}}],"position":{"start":{"line":12,"column":77,"offset":412},"end":{"line":12,"column":101,"offset":436},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers.","position":{"start":{"line":12,"column":101,"offset":436},"end":{"line":12,"column":166,"offset":501},"indent":[]}}],"position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":166,"offset":501},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":166,"offset":501},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and be consumed by ","position":{"start":{"line":13,"column":4,"offset":505},"end":{"line":13,"column":194,"offset":695},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":13,"column":195,"offset":696},"end":{"line":13,"column":209,"offset":710},"indent":[]}}],"position":{"start":{"line":13,"column":194,"offset":695},"end":{"line":13,"column":218,"offset":719},"indent":[]}},{"type":"text","value":" in parrallel. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":13,"column":218,"offset":719},"end":{"line":13,"column":635,"offset":1136},"indent":[]}}],"position":{"start":{"line":13,"column":4,"offset":505},"end":{"line":13,"column":635,"offset":1136},"indent":[]}}],"position":{"start":{"line":13,"column":1,"offset":502},"end":{"line":13,"column":635,"offset":1136},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":13,"column":635,"offset":1136},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":15,"column":4,"offset":1141},"end":{"line":15,"column":18,"offset":1155},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":1138},"end":{"line":15,"column":18,"offset":1155},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":17,"column":1,"offset":1157},"end":{"line":17,"column":291,"offset":1447},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":17,"column":292,"offset":1448},"end":{"line":17,"column":309,"offset":1465},"indent":[]}}],"position":{"start":{"line":17,"column":291,"offset":1447},"end":{"line":17,"column":318,"offset":1474},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":17,"column":318,"offset":1474},"end":{"line":17,"column":319,"offset":1475},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":1157},"end":{"line":17,"column":319,"offset":1475},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":19,"column":1,"offset":1477},"end":{"line":19,"column":56,"offset":1532},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":1477},"end":{"line":19,"column":56,"offset":1532},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":21,"column":4,"offset":1537},"end":{"line":21,"column":20,"offset":1553},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1534},"end":{"line":21,"column":20,"offset":1553},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":23,"column":1,"offset":1555},"end":{"line":23,"column":253,"offset":1807},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1555},"end":{"line":23,"column":253,"offset":1807},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":25,"column":6,"offset":1814},"end":{"line":25,"column":35,"offset":1843},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1813},"end":{"line":25,"column":70,"offset":1878},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1813},"end":{"line":25,"column":70,"offset":1878},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1809},"end":{"line":25,"column":70,"offset":1878},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":26,"column":6,"offset":1884},"end":{"line":26,"column":29,"offset":1907},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1883},"end":{"line":26,"column":83,"offset":1961},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1883},"end":{"line":26,"column":83,"offset":1961},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1879},"end":{"line":26,"column":83,"offset":1961},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":27,"column":6,"offset":1967},"end":{"line":27,"column":28,"offset":1989},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1966},"end":{"line":27,"column":57,"offset":2018},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1966},"end":{"line":27,"column":57,"offset":2018},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1962},"end":{"line":27,"column":57,"offset":2018},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":28,"column":6,"offset":2024},"end":{"line":28,"column":11,"offset":2029},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":2023},"end":{"line":28,"column":29,"offset":2047},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":2023},"end":{"line":28,"column":29,"offset":2047},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":2019},"end":{"line":28,"column":29,"offset":2047},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1809},"end":{"line":28,"column":29,"offset":2047},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":30,"column":1,"offset":2049},"end":{"line":30,"column":190,"offset":2238},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2049},"end":{"line":30,"column":190,"offset":2238},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":32,"column":1,"offset":2240},"end":{"line":32,"column":99,"offset":2338},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2240},"end":{"line":32,"column":99,"offset":2338},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":34,"column":1,"offset":2340},"end":{"line":34,"column":220,"offset":2559},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2340},"end":{"line":34,"column":220,"offset":2559},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":36,"column":1,"offset":2561},"end":{"line":36,"column":98,"offset":2658},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2561},"end":{"line":36,"column":98,"offset":2658},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":38,"column":5,"offset":2664},"end":{"line":38,"column":11,"offset":2670},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2660},"end":{"line":38,"column":11,"offset":2670},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":40,"column":1,"offset":2672},"end":{"line":40,"column":303,"offset":2974},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2672},"end":{"line":40,"column":303,"offset":2974},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":42,"column":6,"offset":2981},"end":{"line":42,"column":18,"offset":2993},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2980},"end":{"line":42,"column":46,"offset":3021},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2980},"end":{"line":42,"column":46,"offset":3021},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2976},"end":{"line":42,"column":46,"offset":3021},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":43,"column":6,"offset":3027},"end":{"line":43,"column":29,"offset":3050},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":3026},"end":{"line":43,"column":59,"offset":3080},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":3026},"end":{"line":43,"column":59,"offset":3080},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":3022},"end":{"line":43,"column":59,"offset":3080},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2976},"end":{"line":43,"column":59,"offset":3080},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":45,"column":1,"offset":3082},"end":{"line":45,"column":368,"offset":3449},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":3082},"end":{"line":45,"column":368,"offset":3449},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":47,"column":1,"offset":3451},"end":{"line":47,"column":66,"offset":3516},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3451},"end":{"line":47,"column":66,"offset":3516},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":49,"column":5,"offset":3522},"end":{"line":49,"column":21,"offset":3538},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3518},"end":{"line":49,"column":21,"offset":3538},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":51,"column":1,"offset":3540},"end":{"line":51,"column":237,"offset":3776},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":3540},"end":{"line":51,"column":237,"offset":3776},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":53,"column":1,"offset":3778},"end":{"line":53,"column":105,"offset":3882},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":3778},"end":{"line":53,"column":105,"offset":3882},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":55,"column":1,"offset":3884},"end":{"line":55,"column":45,"offset":3928},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":3884},"end":{"line":55,"column":45,"offset":3928},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":57,"column":3,"offset":3932},"end":{"line":57,"column":380,"offset":4309},"indent":[]}}],"position":{"start":{"line":57,"column":3,"offset":3932},"end":{"line":57,"column":380,"offset":4309},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":3930},"end":{"line":58,"column":1,"offset":4310},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":59,"column":3,"offset":4313},"end":{"line":60,"column":49,"offset":4627},"indent":[2]}}],"position":{"start":{"line":59,"column":3,"offset":4313},"end":{"line":60,"column":49,"offset":4627},"indent":[2]}}],"position":{"start":{"line":59,"column":1,"offset":4311},"end":{"line":60,"column":49,"offset":4627},"indent":[1]}}],"position":{"start":{"line":57,"column":1,"offset":3930},"end":{"line":60,"column":49,"offset":4627},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":62,"column":5,"offset":4633},"end":{"line":62,"column":13,"offset":4641},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4629},"end":{"line":62,"column":13,"offset":4641},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":64,"column":1,"offset":4643},"end":{"line":64,"column":156,"offset":4798},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":64,"column":156,"offset":4798},"end":{"line":64,"column":177,"offset":4819},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":64,"column":177,"offset":4819},"end":{"line":64,"column":188,"offset":4830},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":64,"column":188,"offset":4830},"end":{"line":64,"column":193,"offset":4835},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":64,"column":193,"offset":4835},"end":{"line":64,"column":379,"offset":5021},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4643},"end":{"line":64,"column":379,"offset":5021},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":66,"column":1,"offset":5023},"end":{"line":66,"column":68,"offset":5090},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":5023},"end":{"line":66,"column":68,"offset":5090},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":68,"column":4,"offset":5095},"end":{"line":68,"column":13,"offset":5104},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":5092},"end":{"line":68,"column":13,"offset":5104},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":70,"column":1,"offset":5106},"end":{"line":70,"column":44,"offset":5149},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":70,"column":46,"offset":5151},"end":{"line":70,"column":68,"offset":5173},"indent":[]}}],"position":{"start":{"line":70,"column":44,"offset":5149},"end":{"line":70,"column":70,"offset":5175},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":70,"column":70,"offset":5175},"end":{"line":70,"column":106,"offset":5211},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":70,"column":108,"offset":5213},"end":{"line":70,"column":129,"offset":5234},"indent":[]}}],"position":{"start":{"line":70,"column":106,"offset":5211},"end":{"line":70,"column":131,"offset":5236},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":70,"column":131,"offset":5236},"end":{"line":70,"column":159,"offset":5264},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":5106},"end":{"line":70,"column":159,"offset":5264},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":73,"column":1,"offset":5267},"end":{"line":73,"column":31,"offset":5297},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":73,"column":31,"offset":5297}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n
    \n
  1. {`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers.`}
    2. \n
  2. {`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and be consumed by `}{`Kerberos Cloud`}{` in parrallel. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}
    3. \n
\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-ae9d99a0faa177a6bb344783a4104c3b.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-ae9d99a0faa177a6bb344783a4104c3b.json new file mode 100644 index 0000000..1a0ad8e --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-ae9d99a0faa177a6bb344783a4104c3b.json @@ -0,0 +1 @@ +{"expireTime":9007200861829864000,"key":"gatsby-plugin-mdx-entire-payload-5888233a78e0f544c15dc24f5ab72d2d-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":396,"offset":1049},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":396,"offset":1049},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Despite the flexible storage capabilities, Kerberos Storage is also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations. It allows you to leverage a scalable and stable system as a strong backbone for your video analytics solutions, machine learning algorithms, and more.","position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":349,"offset":1399},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":349,"offset":1399},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":22,"column":4,"offset":1404},"end":{"line":22,"column":18,"offset":1418},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1401},"end":{"line":22,"column":18,"offset":1418},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can upload your recordings to our ","position":{"start":{"line":24,"column":1,"offset":1420},"end":{"line":24,"column":90,"offset":1509},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":24,"column":91,"offset":1510},"end":{"line":24,"column":105,"offset":1524},"indent":[]}}],"position":{"start":{"line":24,"column":90,"offset":1509},"end":{"line":24,"column":114,"offset":1533},"indent":[]}},{"type":"text","value":" environment. This means that your data will be hosted and processed (metadata) in our Kerberos datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":24,"column":114,"offset":1533},"end":{"line":24,"column":274,"offset":1693},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":24,"column":275,"offset":1694},"end":{"line":24,"column":292,"offset":1711},"indent":[]}}],"position":{"start":{"line":24,"column":274,"offset":1693},"end":{"line":24,"column":301,"offset":1720},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":24,"column":301,"offset":1720},"end":{"line":24,"column":302,"offset":1721},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1420},"end":{"line":24,"column":302,"offset":1721},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":26,"column":1,"offset":1723},"end":{"line":26,"column":56,"offset":1778},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1723},"end":{"line":26,"column":56,"offset":1778},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":28,"column":4,"offset":1783},"end":{"line":28,"column":20,"offset":1799},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1780},"end":{"line":28,"column":20,"offset":1799},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":30,"column":1,"offset":1801},"end":{"line":30,"column":253,"offset":2053},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1801},"end":{"line":30,"column":253,"offset":2053},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":32,"column":6,"offset":2060},"end":{"line":32,"column":35,"offset":2089},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2059},"end":{"line":32,"column":70,"offset":2124},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2059},"end":{"line":32,"column":70,"offset":2124},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2055},"end":{"line":32,"column":70,"offset":2124},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":33,"column":6,"offset":2130},"end":{"line":33,"column":29,"offset":2153},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2129},"end":{"line":33,"column":83,"offset":2207},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2129},"end":{"line":33,"column":83,"offset":2207},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2125},"end":{"line":33,"column":83,"offset":2207},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":34,"column":6,"offset":2213},"end":{"line":34,"column":28,"offset":2235},"indent":[]}}],"position":{"start":{"line":34,"column":5,"offset":2212},"end":{"line":34,"column":57,"offset":2264},"indent":[]}}],"position":{"start":{"line":34,"column":5,"offset":2212},"end":{"line":34,"column":57,"offset":2264},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2208},"end":{"line":34,"column":57,"offset":2264},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":35,"column":6,"offset":2270},"end":{"line":35,"column":11,"offset":2275},"indent":[]}}],"position":{"start":{"line":35,"column":5,"offset":2269},"end":{"line":35,"column":29,"offset":2293},"indent":[]}}],"position":{"start":{"line":35,"column":5,"offset":2269},"end":{"line":35,"column":29,"offset":2293},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2265},"end":{"line":35,"column":29,"offset":2293},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2055},"end":{"line":35,"column":29,"offset":2293},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"When installing Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":37,"column":1,"offset":2295},"end":{"line":37,"column":189,"offset":2483},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2295},"end":{"line":37,"column":189,"offset":2483},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":39,"column":1,"offset":2485},"end":{"line":39,"column":99,"offset":2583},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2485},"end":{"line":39,"column":99,"offset":2583},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":41,"column":1,"offset":2585},"end":{"line":41,"column":220,"offset":2804},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2585},"end":{"line":41,"column":220,"offset":2804},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":43,"column":1,"offset":2806},"end":{"line":43,"column":98,"offset":2903},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2806},"end":{"line":43,"column":98,"offset":2903},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":45,"column":5,"offset":2909},"end":{"line":45,"column":11,"offset":2915},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2905},"end":{"line":45,"column":11,"offset":2915},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":47,"column":1,"offset":2917},"end":{"line":47,"column":303,"offset":3219},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2917},"end":{"line":47,"column":303,"offset":3219},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":49,"column":6,"offset":3226},"end":{"line":49,"column":18,"offset":3238},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":3225},"end":{"line":49,"column":46,"offset":3266},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":3225},"end":{"line":49,"column":46,"offset":3266},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3221},"end":{"line":49,"column":46,"offset":3266},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":50,"column":6,"offset":3272},"end":{"line":50,"column":29,"offset":3295},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":3271},"end":{"line":50,"column":59,"offset":3325},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":3271},"end":{"line":50,"column":59,"offset":3325},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3267},"end":{"line":50,"column":59,"offset":3325},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3221},"end":{"line":50,"column":59,"offset":3325},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":52,"column":1,"offset":3327},"end":{"line":52,"column":368,"offset":3694},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3327},"end":{"line":52,"column":368,"offset":3694},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":54,"column":1,"offset":3696},"end":{"line":54,"column":66,"offset":3761},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3696},"end":{"line":54,"column":66,"offset":3761},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":56,"column":5,"offset":3767},"end":{"line":56,"column":21,"offset":3783},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3763},"end":{"line":56,"column":21,"offset":3783},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":58,"column":1,"offset":3785},"end":{"line":58,"column":237,"offset":4021},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3785},"end":{"line":58,"column":237,"offset":4021},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":60,"column":1,"offset":4023},"end":{"line":60,"column":105,"offset":4127},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4023},"end":{"line":60,"column":105,"offset":4127},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":62,"column":1,"offset":4129},"end":{"line":62,"column":45,"offset":4173},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4129},"end":{"line":62,"column":45,"offset":4173},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":64,"column":3,"offset":4177},"end":{"line":64,"column":380,"offset":4554},"indent":[]}}],"position":{"start":{"line":64,"column":3,"offset":4177},"end":{"line":64,"column":380,"offset":4554},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4175},"end":{"line":65,"column":1,"offset":4555},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":66,"column":3,"offset":4558},"end":{"line":67,"column":49,"offset":4872},"indent":[2]}}],"position":{"start":{"line":66,"column":3,"offset":4558},"end":{"line":67,"column":49,"offset":4872},"indent":[2]}}],"position":{"start":{"line":66,"column":1,"offset":4556},"end":{"line":67,"column":49,"offset":4872},"indent":[1]}}],"position":{"start":{"line":64,"column":1,"offset":4175},"end":{"line":67,"column":49,"offset":4872},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":69,"column":5,"offset":4878},"end":{"line":69,"column":13,"offset":4886},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4874},"end":{"line":69,"column":13,"offset":4886},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":71,"column":1,"offset":4888},"end":{"line":71,"column":156,"offset":5043},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":71,"column":156,"offset":5043},"end":{"line":71,"column":177,"offset":5064},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":71,"column":177,"offset":5064},"end":{"line":71,"column":188,"offset":5075},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":71,"column":188,"offset":5075},"end":{"line":71,"column":193,"offset":5080},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":71,"column":193,"offset":5080},"end":{"line":71,"column":379,"offset":5266},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":4888},"end":{"line":71,"column":379,"offset":5266},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":73,"column":1,"offset":5268},"end":{"line":73,"column":68,"offset":5335},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5268},"end":{"line":73,"column":68,"offset":5335},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":75,"column":4,"offset":5340},"end":{"line":75,"column":13,"offset":5349},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5337},"end":{"line":75,"column":13,"offset":5349},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":77,"column":1,"offset":5351},"end":{"line":77,"column":44,"offset":5394},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":77,"column":46,"offset":5396},"end":{"line":77,"column":68,"offset":5418},"indent":[]}}],"position":{"start":{"line":77,"column":44,"offset":5394},"end":{"line":77,"column":70,"offset":5420},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":77,"column":70,"offset":5420},"end":{"line":77,"column":106,"offset":5456},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":77,"column":108,"offset":5458},"end":{"line":77,"column":129,"offset":5479},"indent":[]}}],"position":{"start":{"line":77,"column":106,"offset":5456},"end":{"line":77,"column":131,"offset":5481},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":77,"column":131,"offset":5481},"end":{"line":77,"column":159,"offset":5509},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":5351},"end":{"line":77,"column":159,"offset":5509},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":80,"column":1,"offset":5512},"end":{"line":80,"column":31,"offset":5542},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":80,"column":31,"offset":5542}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio.`}

\n

{`Despite the flexible storage capabilities, Kerberos Storage is also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations. It allows you to leverage a scalable and stable system as a strong backbone for your video analytics solutions, machine learning algorithms, and more.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can upload your recordings to our `}{`Kerberos Cloud`}{` environment. This means that your data will be hosted and processed (metadata) in our Kerberos datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`When installing Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-afcb7862fc8a6577ddb862105a122b6e.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-afcb7862fc8a6577ddb862105a122b6e.json new file mode 100644 index 0000000..ef0939e --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-afcb7862fc8a6577ddb862105a122b6e.json @@ -0,0 +1 @@ +{"expireTime":9007200861859584000,"key":"gatsby-plugin-mdx-entire-payload-80915ed813c3ac5f36ca82491b32f968-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":88,"offset":322},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"AWS","position":{"start":{"line":12,"column":90,"offset":324},"end":{"line":12,"column":93,"offset":327},"indent":[]}}],"position":{"start":{"line":12,"column":88,"offset":322},"end":{"line":12,"column":95,"offset":329},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":12,"column":95,"offset":329},"end":{"line":12,"column":97,"offset":331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"GCP","position":{"start":{"line":12,"column":99,"offset":333},"end":{"line":12,"column":102,"offset":336},"indent":[]}}],"position":{"start":{"line":12,"column":97,"offset":331},"end":{"line":12,"column":104,"offset":338},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":12,"column":104,"offset":338},"end":{"line":12,"column":108,"offset":342},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Azure","position":{"start":{"line":12,"column":110,"offset":344},"end":{"line":12,"column":115,"offset":349},"indent":[]}}],"position":{"start":{"line":12,"column":108,"offset":342},"end":{"line":12,"column":117,"offset":351},"indent":[]}},{"type":"text","value":"),\ncloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.","position":{"start":{"line":12,"column":117,"offset":351},"end":{"line":13,"column":90,"offset":443},"indent":[1]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":13,"column":90,"offset":443},"indent":[1]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":15,"column":1,"offset":445},"end":{"line":17,"column":11,"offset":647},"indent":[1,1]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":19,"column":3,"offset":651},"end":{"line":19,"column":15,"offset":663},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":649},"end":{"line":19,"column":15,"offset":663},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.","position":{"start":{"line":21,"column":1,"offset":665},"end":{"line":21,"column":323,"offset":987},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":665},"end":{"line":21,"column":323,"offset":987},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":23,"column":1,"offset":989},"end":{"line":25,"column":11,"offset":1191},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"First clone the configrations from our Github repo.","position":{"start":{"line":27,"column":1,"offset":1193},"end":{"line":27,"column":52,"offset":1244},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1193},"end":{"line":27,"column":52,"offset":1244},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/enterprise","position":{"start":{"line":29,"column":1,"offset":1246},"end":{"line":29,"column":56,"offset":1301},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next go into the directory and execute the first Kubernetes configuration file ","position":{"start":{"line":31,"column":1,"offset":1303},"end":{"line":31,"column":80,"offset":1382},"indent":[]}},{"type":"inlineCode","value":"clusterrole.yaml","position":{"start":{"line":31,"column":80,"offset":1382},"end":{"line":31,"column":98,"offset":1400},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":98,"offset":1400},"end":{"line":31,"column":99,"offset":1401},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1303},"end":{"line":31,"column":99,"offset":1401},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml","position":{"start":{"line":33,"column":1,"offset":1403},"end":{"line":33,"column":65,"offset":1467},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This will make several actions inside your cluster available. We need this to be able to create deployments from the factory web app.","position":{"start":{"line":35,"column":1,"offset":1469},"end":{"line":35,"column":134,"offset":1602},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1469},"end":{"line":35,"column":134,"offset":1602},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Helm","position":{"start":{"line":37,"column":4,"offset":1607},"end":{"line":37,"column":8,"offset":1611},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1604},"end":{"line":37,"column":8,"offset":1611},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next we will install a couple of dependencies which are required for Kerberos Enterprise. ","position":{"start":{"line":39,"column":1,"offset":1613},"end":{"line":39,"column":91,"offset":1703},"indent":[]}},{"type":"link","title":null,"url":"https://helm.sh/","children":[{"type":"strong","children":[{"type":"text","value":"Helm","position":{"start":{"line":39,"column":94,"offset":1706},"end":{"line":39,"column":98,"offset":1710},"indent":[]}}],"position":{"start":{"line":39,"column":92,"offset":1704},"end":{"line":39,"column":100,"offset":1712},"indent":[]}}],"position":{"start":{"line":39,"column":91,"offset":1703},"end":{"line":39,"column":119,"offset":1731},"indent":[]}},{"type":"text","value":" is a package manager for Kubernetes, it helps you setting up services more easily (this could be a MQTT broker, a database, etc).\nInstead of writing yaml files for every service we need, we use so called ","position":{"start":{"line":39,"column":119,"offset":1731},"end":{"line":40,"column":75,"offset":1936},"indent":[1]}},{"type":"strong","children":[{"type":"text","value":"Charts","position":{"start":{"line":40,"column":77,"offset":1938},"end":{"line":40,"column":83,"offset":1944},"indent":[]}}],"position":{"start":{"line":40,"column":75,"offset":1936},"end":{"line":40,"column":85,"offset":1946},"indent":[]}},{"type":"text","value":" (libraries), that you can reuse and configure the,\nwith the appropriate settings.","position":{"start":{"line":40,"column":85,"offset":1946},"end":{"line":41,"column":31,"offset":2028},"indent":[1]}}],"position":{"start":{"line":39,"column":1,"offset":1613},"end":{"line":41,"column":31,"offset":2028},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Use one of the preferred OS package managers to install the Helm client:","position":{"start":{"line":43,"column":1,"offset":2030},"end":{"line":43,"column":73,"offset":2102},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2030},"end":{"line":43,"column":73,"offset":2102},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"brew install helm\n\nchoco install kubernetes-helm\n\nscoop install helm\n\ngofish install helm","position":{"start":{"line":45,"column":1,"offset":2104},"end":{"line":51,"column":24,"offset":2209},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Traefik","position":{"start":{"line":53,"column":4,"offset":2214},"end":{"line":53,"column":11,"offset":2221},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2211},"end":{"line":53,"column":11,"offset":2221},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://containo.us/traefik/","children":[{"type":"strong","children":[{"type":"text","value":"Traefik","position":{"start":{"line":55,"column":4,"offset":2226},"end":{"line":55,"column":11,"offset":2233},"indent":[]}}],"position":{"start":{"line":55,"column":2,"offset":2224},"end":{"line":55,"column":13,"offset":2235},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2223},"end":{"line":55,"column":44,"offset":2266},"indent":[]}},{"type":"text","value":" is a reverse proxy and load balancer which allows you to expose your deployments more easily. Kerberos uses Traefik to expose it's APIs more easily.","position":{"start":{"line":55,"column":44,"offset":2266},"end":{"line":55,"column":193,"offset":2415},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2223},"end":{"line":55,"column":193,"offset":2415},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By executing following helm command, we will install traefik and link it to a specific DNS name. Open the traefik values file, ","position":{"start":{"line":57,"column":1,"offset":2417},"end":{"line":57,"column":128,"offset":2544},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/traefik/values.yaml","position":{"start":{"line":57,"column":128,"offset":2544},"end":{"line":57,"column":167,"offset":2583},"indent":[]}},{"type":"text","value":", and update the DNS name to your own domain.","position":{"start":{"line":57,"column":167,"offset":2583},"end":{"line":57,"column":212,"offset":2628},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2417},"end":{"line":57,"column":212,"offset":2628},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" dashboard:\n enabled: true\n--> domain: traefik.domain.com\n serviceType: NodePort\n rbac:\n enabled: true","position":{"start":{"line":59,"column":1,"offset":2630},"end":{"line":64,"column":26,"offset":2781},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Add Helm repository and install traefik.","position":{"start":{"line":66,"column":1,"offset":2783},"end":{"line":66,"column":41,"offset":2823},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":2783},"end":{"line":66,"column":41,"offset":2823},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add stable https://kubernetes-charts.storage.googleapis.com\nhelm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik","position":{"start":{"line":68,"column":1,"offset":2825},"end":{"line":69,"column":81,"offset":2979},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"After installation you should have an IP attached to traefik service, look for it by executing the ","position":{"start":{"line":71,"column":1,"offset":2981},"end":{"line":71,"column":100,"offset":3080},"indent":[]}},{"type":"inlineCode","value":"get service","position":{"start":{"line":71,"column":100,"offset":3080},"end":{"line":71,"column":113,"offset":3093},"indent":[]}},{"type":"text","value":" command. You will see the ip address in the ","position":{"start":{"line":71,"column":113,"offset":3093},"end":{"line":71,"column":158,"offset":3138},"indent":[]}},{"type":"inlineCode","value":"EXTERNAL-IP","position":{"start":{"line":71,"column":158,"offset":3138},"end":{"line":71,"column":171,"offset":3151},"indent":[]}},{"type":"text","value":" attribute.","position":{"start":{"line":71,"column":171,"offset":3151},"end":{"line":71,"column":182,"offset":3162},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":2981},"end":{"line":71,"column":182,"offset":3162},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl get svc\n\n NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE\n kubernetes ClusterIP 10.0.0.1 443/TCP 36h\n--> traefik LoadBalancer 10.0.27.93 40.114.168.96 443:31623/TCP,80:31804/TCP 35h\n traefik-dashboard NodePort 10.0.252.6 80:31146/TCP 35h","position":{"start":{"line":73,"column":1,"offset":3164},"end":{"line":78,"column":115,"offset":3644},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Go to your DNS provider and link the domain you've configured in the first step ","position":{"start":{"line":80,"column":1,"offset":3646},"end":{"line":80,"column":81,"offset":3726},"indent":[]}},{"type":"inlineCode","value":"traefik.domain.com","position":{"start":{"line":80,"column":81,"offset":3726},"end":{"line":80,"column":101,"offset":3746},"indent":[]}},{"type":"text","value":" to the IP address of the ","position":{"start":{"line":80,"column":101,"offset":3746},"end":{"line":80,"column":127,"offset":3772},"indent":[]}},{"type":"inlineCode","value":"EXTERNAL-IP","position":{"start":{"line":80,"column":127,"offset":3772},"end":{"line":80,"column":140,"offset":3785},"indent":[]}},{"type":"text","value":" attribute. When browsing to ","position":{"start":{"line":80,"column":140,"offset":3785},"end":{"line":80,"column":169,"offset":3814},"indent":[]}},{"type":"inlineCode","value":"traefik.domain.com","position":{"start":{"line":80,"column":169,"offset":3814},"end":{"line":80,"column":189,"offset":3834},"indent":[]}},{"type":"text","value":", you should see the traefik dashboard showing up.","position":{"start":{"line":80,"column":189,"offset":3834},"end":{"line":80,"column":239,"offset":3884},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":3646},"end":{"line":80,"column":239,"offset":3884},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Ingress-Nginx (optional, instead of Traefik)","position":{"start":{"line":82,"column":4,"offset":3889},"end":{"line":82,"column":48,"offset":3933},"indent":[]}}],"position":{"start":{"line":82,"column":1,"offset":3886},"end":{"line":82,"column":48,"offset":3933},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you don't like ","position":{"start":{"line":84,"column":1,"offset":3935},"end":{"line":84,"column":19,"offset":3953},"indent":[]}},{"type":"inlineCode","value":"Traefik","position":{"start":{"line":84,"column":19,"offset":3953},"end":{"line":84,"column":28,"offset":3962},"indent":[]}},{"type":"text","value":" but you prefer ","position":{"start":{"line":84,"column":28,"offset":3962},"end":{"line":84,"column":44,"offset":3978},"indent":[]}},{"type":"inlineCode","value":"Ingress Nginx","position":{"start":{"line":84,"column":44,"offset":3978},"end":{"line":84,"column":59,"offset":3993},"indent":[]}},{"type":"text","value":", that works as well.","position":{"start":{"line":84,"column":59,"offset":3993},"end":{"line":84,"column":80,"offset":4014},"indent":[]}}],"position":{"start":{"line":84,"column":1,"offset":3935},"end":{"line":84,"column":80,"offset":4014},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx\nhelm repo update\nhelm install ingress-nginx ingress-nginx/ingress-nginx","position":{"start":{"line":86,"column":1,"offset":4016},"end":{"line":88,"column":59,"offset":4170},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"MongoDB","position":{"start":{"line":90,"column":4,"offset":4175},"end":{"line":90,"column":11,"offset":4182},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4172},"end":{"line":90,"column":11,"offset":4182},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use ","position":{"start":{"line":92,"column":1,"offset":4184},"end":{"line":92,"column":192,"offset":4375},"indent":[]}},{"type":"inlineCode","value":"helm ","position":{"start":{"line":92,"column":192,"offset":4375},"end":{"line":92,"column":199,"offset":4382},"indent":[]}},{"type":"text","value":"to install a MongoDB instance inside your cluster.","position":{"start":{"line":92,"column":199,"offset":4382},"end":{"line":92,"column":249,"offset":4432},"indent":[]}}],"position":{"start":{"line":92,"column":1,"offset":4184},"end":{"line":92,"column":249,"offset":4432},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Have a look into the ","position":{"start":{"line":94,"column":1,"offset":4434},"end":{"line":94,"column":22,"offset":4455},"indent":[]}},{"type":"inlineCode","value":"yaml/mongodb/values.yaml","position":{"start":{"line":94,"column":22,"offset":4455},"end":{"line":94,"column":48,"offset":4481},"indent":[]}},{"type":"text","value":" file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb.","position":{"start":{"line":94,"column":48,"offset":4481},"end":{"line":94,"column":204,"offset":4637},"indent":[]}}],"position":{"start":{"line":94,"column":1,"offset":4434},"end":{"line":94,"column":204,"offset":4637},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values.yaml","position":{"start":{"line":96,"column":1,"offset":4639},"end":{"line":97,"column":88,"offset":4787},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.","position":{"start":{"line":99,"column":1,"offset":4789},"end":{"line":99,"column":170,"offset":4958},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4789},"end":{"line":99,"column":170,"offset":4958},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)\necho $MONGODB_ROOT_PASSWORD","position":{"start":{"line":101,"column":1,"offset":4960},"end":{"line":102,"column":32,"offset":5136},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Enterprise Web App - The Factory","position":{"start":{"line":104,"column":4,"offset":5141},"end":{"line":104,"column":45,"offset":5182},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":5138},"end":{"line":104,"column":45,"offset":5182},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the ","position":{"start":{"line":106,"column":1,"offset":5184},"end":{"line":106,"column":138,"offset":5321},"indent":[]}},{"type":"inlineCode","value":"Factory","position":{"start":{"line":106,"column":138,"offset":5321},"end":{"line":106,"column":147,"offset":5330},"indent":[]}},{"type":"text","value":". It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.","position":{"start":{"line":106,"column":147,"offset":5330},"end":{"line":106,"column":309,"offset":5492},"indent":[]}}],"position":{"start":{"line":106,"column":1,"offset":5184},"end":{"line":106,"column":309,"offset":5492},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the ","position":{"start":{"line":108,"column":1,"offset":5494},"end":{"line":108,"column":289,"offset":5782},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":108,"column":289,"offset":5782},"end":{"line":108,"column":298,"offset":5791},"indent":[]}},{"type":"text","value":" command.","position":{"start":{"line":108,"column":298,"offset":5791},"end":{"line":108,"column":307,"offset":5800},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":5494},"end":{"line":108,"column":307,"offset":5800},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing the Factory web app, open the ","position":{"start":{"line":110,"column":1,"offset":5802},"end":{"line":110,"column":49,"offset":5850},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":110,"column":49,"offset":5850},"end":{"line":110,"column":92,"offset":5893},"indent":[]}},{"type":"text","value":" configuration file. At the of the bottom file you will find two endpoints, similar to the Ingres file bewlwo. Update the hostnames to your own perferred domain, and add these to your DNS server or ","position":{"start":{"line":110,"column":92,"offset":5893},"end":{"line":110,"column":290,"offset":6091},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":110,"column":290,"offset":6091},"end":{"line":110,"column":302,"offset":6103},"indent":[]}},{"type":"text","value":" file (pointing to the same IP as the Traefik/Ingress nginx EXTERNAL-IP).","position":{"start":{"line":110,"column":302,"offset":6103},"end":{"line":110,"column":375,"offset":6176},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":5802},"end":{"line":110,"column":375,"offset":6176},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 80\n--> - host: api.factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 8081","position":{"start":{"line":112,"column":1,"offset":6178},"end":{"line":127,"column":36,"offset":6610},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Ingress Nginx, do not forgot to comment ","position":{"start":{"line":129,"column":1,"offset":6612},"end":{"line":129,"column":58,"offset":6669},"indent":[]}},{"type":"inlineCode","value":"Traefik","position":{"start":{"line":129,"column":58,"offset":6669},"end":{"line":129,"column":67,"offset":6678},"indent":[]}},{"type":"text","value":" and uncomment ","position":{"start":{"line":129,"column":67,"offset":6678},"end":{"line":129,"column":82,"offset":6693},"indent":[]}},{"type":"inlineCode","value":"Ingress nginx","position":{"start":{"line":129,"column":82,"offset":6693},"end":{"line":129,"column":97,"offset":6708},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":129,"column":97,"offset":6708},"end":{"line":129,"column":98,"offset":6709},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":6612},"end":{"line":129,"column":98,"offset":6709},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"apiVersion: extensions/v1beta1\nkind: Ingress\nmetadata:\n name: factory\n annotations:\n #kubernetes.io/ingress.class: traefik\n kubernetes.io/ingress.class: nginx","position":{"start":{"line":131,"column":1,"offset":6711},"end":{"line":137,"column":43,"offset":6905},"indent":[1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":139,"column":1,"offset":6907},"end":{"line":139,"column":99,"offset":7005},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":6907},"end":{"line":139,"column":99,"offset":7005},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":141,"column":1,"offset":7007},"end":{"line":144,"column":30,"offset":7126},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.","position":{"start":{"line":146,"column":1,"offset":7128},"end":{"line":146,"column":118,"offset":7245},"indent":[]}}],"position":{"start":{"line":146,"column":1,"offset":7128},"end":{"line":146,"column":118,"offset":7245},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":148,"column":1,"offset":7247},"end":{"line":148,"column":63,"offset":7309},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":150,"column":4,"offset":7314},"end":{"line":150,"column":26,"offset":7336},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":7311},"end":{"line":150,"column":26,"offset":7336},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":152,"column":1,"offset":7338},"end":{"line":152,"column":94,"offset":7431},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":7338},"end":{"line":152,"column":94,"offset":7431},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":154,"column":5,"offset":7437},"end":{"line":154,"column":12,"offset":7444},"indent":[]}}],"position":{"start":{"line":154,"column":5,"offset":7437},"end":{"line":154,"column":12,"offset":7444},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":7433},"end":{"line":154,"column":12,"offset":7444},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":155,"column":5,"offset":7449},"end":{"line":155,"column":12,"offset":7456},"indent":[]}}],"position":{"start":{"line":155,"column":5,"offset":7449},"end":{"line":155,"column":12,"offset":7456},"indent":[]}}],"position":{"start":{"line":155,"column":1,"offset":7445},"end":{"line":155,"column":12,"offset":7456},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Factory","position":{"start":{"line":156,"column":5,"offset":7461},"end":{"line":156,"column":12,"offset":7468},"indent":[]}}],"position":{"start":{"line":156,"column":5,"offset":7461},"end":{"line":156,"column":12,"offset":7468},"indent":[]}}],"position":{"start":{"line":156,"column":1,"offset":7457},"end":{"line":156,"column":12,"offset":7468},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":7433},"end":{"line":156,"column":12,"offset":7468},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":158,"column":1,"offset":7470},"end":{"line":158,"column":26,"offset":7495},"indent":[]}}],"position":{"start":{"line":158,"column":1,"offset":7470},"end":{"line":158,"column":26,"offset":7495},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nfactory-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-758d5c5ddd-qsfq9 1/1 Running 0 5m31s\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":160,"column":1,"offset":7497},"end":{"line":164,"column":73,"offset":7809},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":166,"column":4,"offset":7814},"end":{"line":166,"column":21,"offset":7831},"indent":[]}}],"position":{"start":{"line":166,"column":1,"offset":7811},"end":{"line":166,"column":21,"offset":7831},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain ","position":{"start":{"line":168,"column":1,"offset":7833},"end":{"line":168,"column":152,"offset":7984},"indent":[]}},{"type":"inlineCode","value":"factory.domain.com","position":{"start":{"line":168,"column":152,"offset":7984},"end":{"line":168,"column":172,"offset":8004},"indent":[]}},{"type":"text","value":" in your browser you will see the Factory login page showing up.","position":{"start":{"line":168,"column":172,"offset":8004},"end":{"line":168,"column":236,"offset":8068},"indent":[]}}],"position":{"start":{"line":168,"column":1,"offset":7833},"end":{"line":168,"column":236,"offset":8068},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Factory","position":{"start":{"line":170,"column":1,"offset":8070},"end":{"line":170,"column":71,"offset":8140},"indent":[]}}],"position":{"start":{"line":170,"column":1,"offset":8070},"end":{"line":170,"column":71,"offset":8140},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":173,"column":1,"offset":8143},"end":{"line":173,"column":31,"offset":8173},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":173,"column":31,"offset":8173}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Introduction`}

\n

{`Start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (`}{`AWS`}{`, `}{`GCP`}{` or `}{`Azure`}{`),\ncloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.`}

\n
\n
\n

\n

{`Installation`}

\n

{`Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.`}

\n
\n
\n

\n

{`First clone the configrations from our Github repo.`}

\n 
{`git clone https://github.com/kerberos-io/enterprise`}
\n

{`Next go into the directory and execute the first Kubernetes configuration file `}{`clusterrole.yaml`}{`.`}

\n 
{`kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml`}
\n

{`This will make several actions inside your cluster available. We need this to be able to create deployments from the factory web app.`}

\n

{`Helm`}

\n

{`Next we will install a couple of dependencies which are required for Kerberos Enterprise. `}{`Helm`}{` is a package manager for Kubernetes, it helps you setting up services more easily (this could be a MQTT broker, a database, etc).\nInstead of writing yaml files for every service we need, we use so called `}{`Charts`}{` (libraries), that you can reuse and configure the,\nwith the appropriate settings.`}

\n

{`Use one of the preferred OS package managers to install the Helm client:`}

\n 
{`brew install helm`}{`\n`}{`\n`}{`choco install kubernetes-helm`}{`\n`}{`\n`}{`scoop install helm`}{`\n`}{`\n`}{`gofish install helm`}
\n

{`Traefik`}

\n

{`Traefik`}{` is a reverse proxy and load balancer which allows you to expose your deployments more easily. Kerberos uses Traefik to expose it's APIs more easily.`}

\n

{`By executing following helm command, we will install traefik and link it to a specific DNS name. Open the traefik values file, `}{`./enterprise/yaml/traefik/values.yaml`}{`, and update the DNS name to your own domain.`}

\n 
{`    dashboard:`}{`\n`}{`      enabled: true`}{`\n`}{`-->   domain: traefik.domain.com`}{`\n`}{`      serviceType: NodePort`}{`\n`}{`    rbac:`}{`\n`}{`        enabled: true`}
\n

{`Add Helm repository and install traefik.`}

\n 
{`helm repo add stable https://kubernetes-charts.storage.googleapis.com`}{`\n`}{`helm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik`}
\n

{`After installation you should have an IP attached to traefik service, look for it by executing the `}{`get service`}{` command. You will see the ip address in the `}{`EXTERNAL-IP`}{` attribute.`}

\n 
{`kubectl get svc`}{`\n`}{`\n`}{`    NAME                        TYPE           CLUSTER-IP     EXTERNAL-IP     PORT(S)                      AGE`}{`\n`}{`    kubernetes                  ClusterIP      10.0.0.1                 443/TCP                      36h`}{`\n`}{`--> traefik                     LoadBalancer   10.0.27.93     40.114.168.96   443:31623/TCP,80:31804/TCP   35h`}{`\n`}{`    traefik-dashboard           NodePort       10.0.252.6               80:31146/TCP                 35h`}
\n

{`Go to your DNS provider and link the domain you've configured in the first step `}{`traefik.domain.com`}{` to the IP address of the `}{`EXTERNAL-IP`}{` attribute. When browsing to `}{`traefik.domain.com`}{`, you should see the traefik dashboard showing up.`}

\n

{`Ingress-Nginx (optional, instead of Traefik)`}

\n

{`If you don't like `}{`Traefik`}{` but you prefer `}{`Ingress Nginx`}{`, that works as well.`}

\n 
{`helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx`}{`\n`}{`helm repo update`}{`\n`}{`helm install ingress-nginx ingress-nginx/ingress-nginx`}
\n

{`MongoDB`}

\n

{`When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use `}{`helm `}{`to install a MongoDB instance inside your cluster.`}

\n

{`Have a look into the `}{`yaml/mongodb/values.yaml`}{` file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb.`}

\n 
{`helm repo add bitnami https://charts.bitnami.com/bitnami`}{`\n`}{`helm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values.yaml`}
\n

{`Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.`}

\n 
{`export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)`}{`\n`}{`echo $MONGODB_ROOT_PASSWORD`}
\n

{`Kerberos Enterprise Web App - The Factory`}

\n

{`The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the `}{`Factory`}{`. It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.`}

\n

{`The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the `}{`kubectl`}{` command.`}

\n

{`Before installing the Factory web app, open the `}{`./enterprise/yaml/factory/deployment.yaml`}{` configuration file. At the of the bottom file you will find two endpoints, similar to the Ingres file bewlwo. Update the hostnames to your own perferred domain, and add these to your DNS server or `}{`/etc/hosts`}{` file (pointing to the same IP as the Traefik/Ingress nginx EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 8081`}
\n

{`If you are using Ingress Nginx, do not forgot to comment `}{`Traefik`}{` and uncomment `}{`Ingress nginx`}{`.`}

\n 
{`apiVersion: extensions/v1beta1`}{`\n`}{`kind: Ingress`}{`\n`}{`metadata:`}{`\n`}{`  name: factory`}{`\n`}{`  annotations:`}{`\n`}{`    #kubernetes.io/ingress.class: traefik`}{`\n`}{`    kubernetes.io/ingress.class: nginx`}
\n

{`Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.`}

\n 
{`kubectl apply -f ./enterprise/yaml/factory/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Factory`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`factory-6f5c877d7c-hf77p          1/1     Running   0          2d11h`}{`\n`}{`mongodb-758d5c5ddd-qsfq9          1/1     Running   0          5m31s`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain `}{`factory.domain.com`}{` in your browser you will see the Factory login page showing up.`}

\n

\"Factory\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c29d8e4bac24e737afa760509ff83d73.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c29d8e4bac24e737afa760509ff83d73.json new file mode 100644 index 0000000..3fb57e0 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c29d8e4bac24e737afa760509ff83d73.json @@ -0,0 +1 @@ +{"expireTime":9007200861828558000,"key":"gatsby-plugin-mdx-entire-payload-d35f2d00190debf868507791a86bbca5-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Get Started","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":14,"offset":172},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":14,"offset":172},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed Kerberos Storage, you will have the Kerberos Storage web app running. This web app allows you to administrate Kerberos Storage. You can add storage providers, queues, accounts, and more. ","position":{"start":{"line":10,"column":1,"offset":174},"end":{"line":10,"column":210,"offset":383},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":174},"end":{"line":10,"column":210,"offset":383},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Login page","position":{"start":{"line":12,"column":4,"offset":388},"end":{"line":12,"column":14,"offset":398},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":385},"end":{"line":12,"column":14,"offset":398},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you open a browser, and navigate to the Storage web application (see installation for the url), you will land on the login page.","position":{"start":{"line":14,"column":1,"offset":400},"end":{"line":14,"column":134,"offset":533},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":400},"end":{"line":14,"column":134,"offset":533},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage-small.png","alt":"Storage","position":{"start":{"line":16,"column":1,"offset":535},"end":{"line":16,"column":77,"offset":611},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":535},"end":{"line":16,"column":77,"offset":611},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The default username password of the Storage applications is:","position":{"start":{"line":18,"column":1,"offset":613},"end":{"line":18,"column":62,"offset":674},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":613},"end":{"line":18,"column":62,"offset":674},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"username: ","position":{"start":{"line":20,"column":3,"offset":678},"end":{"line":20,"column":13,"offset":688},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":20,"column":15,"offset":690},"end":{"line":20,"column":19,"offset":694},"indent":[]}}],"position":{"start":{"line":20,"column":13,"offset":688},"end":{"line":20,"column":21,"offset":696},"indent":[]}}],"position":{"start":{"line":20,"column":3,"offset":678},"end":{"line":20,"column":21,"offset":696},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":676},"end":{"line":20,"column":21,"offset":696},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"password: ","position":{"start":{"line":21,"column":3,"offset":699},"end":{"line":21,"column":13,"offset":709},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"kerberos","position":{"start":{"line":21,"column":15,"offset":711},"end":{"line":21,"column":23,"offset":719},"indent":[]}}],"position":{"start":{"line":21,"column":13,"offset":709},"end":{"line":21,"column":25,"offset":721},"indent":[]}}],"position":{"start":{"line":21,"column":3,"offset":699},"end":{"line":21,"column":25,"offset":721},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":697},"end":{"line":21,"column":25,"offset":721},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":676},"end":{"line":21,"column":25,"offset":721},"indent":[1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"The username and password can be changed in the ","position":{"start":{"line":23,"column":3,"offset":725},"end":{"line":23,"column":51,"offset":773},"indent":[]}},{"type":"inlineCode","value":"deployment.yaml","position":{"start":{"line":23,"column":51,"offset":773},"end":{"line":23,"column":68,"offset":790},"indent":[]}},{"type":"text","value":" file.","position":{"start":{"line":23,"column":68,"offset":790},"end":{"line":23,"column":74,"offset":796},"indent":[]}}],"position":{"start":{"line":23,"column":3,"offset":725},"end":{"line":23,"column":74,"offset":796},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":723},"end":{"line":23,"column":74,"offset":796},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"License key","position":{"start":{"line":25,"column":4,"offset":801},"end":{"line":25,"column":15,"offset":812},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":798},"end":{"line":25,"column":15,"offset":812},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The first time you login you are asked for a license key, this can be obtained by sending a request to cedric@verstraeten.io. An example license key looks like this:","position":{"start":{"line":27,"column":1,"offset":814},"end":{"line":27,"column":166,"offset":979},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":814},"end":{"line":27,"column":166,"offset":979},"indent":[]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"-----BEGIN LICENSE KEY-----\nL/+DAwEBB2xpY2Vuc2UB/4QAAQIBB1BheWxvYWQBCgABCVNpZ25hdHVyZQEKAAAA\n/9z/hAFUPBAADG1haW4uTGljZW5zZf+BAwEBB0xpY2Vuc2UB/4IAAQIBB0NvbXBh\nbnkBDAABB0V4cFRpbWUBBAAAABb/ghMBCmtlcmJlcm9zaW8B/MC7ZzIAAf+AOaJ+\n8eU3OlZCphr4uJyH/PzfuDkMrqyfIsutc5kSz3rjsRtU4e6vETpHre8CPvFyx5w2\n0O8PKCIR4z1q28qJK2cvHQTK0/zf+KfYLilEcmNczLXgg+bnPvtA/bU/K8ZEwbnw\nRta3+8zId+xtYQApdmHwo/Ih/vCN579iDeunwVQA\n-----END LICENSE KEY-----","position":{"start":{"line":29,"column":3,"offset":983},"end":{"line":36,"column":26,"offset":1402},"indent":[1,1,1,1,1,1,1]}}],"position":{"start":{"line":29,"column":3,"offset":983},"end":{"line":36,"column":26,"offset":1402},"indent":[1,1,1,1,1,1,1]}}],"position":{"start":{"line":29,"column":1,"offset":981},"end":{"line":36,"column":26,"offset":1402},"indent":[1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-licensekey.png","alt":"Factory","position":{"start":{"line":38,"column":1,"offset":1404},"end":{"line":38,"column":72,"offset":1475},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":1404},"end":{"line":38,"column":72,"offset":1475},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you received a license key, and entered it into the web app you will be redirected to the login screen. Enter your credentials again, and you will be guided into the dashboard.","position":{"start":{"line":40,"column":1,"offset":1477},"end":{"line":40,"column":182,"offset":1658},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":1477},"end":{"line":40,"column":182,"offset":1658},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Providers","position":{"start":{"line":43,"column":4,"offset":1664},"end":{"line":43,"column":13,"offset":1673},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":1661},"end":{"line":43,"column":13,"offset":1673},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you signed in succesfully, you land on the providers page. Here is the place where you can add your datasources. You can choose from:","position":{"start":{"line":45,"column":1,"offset":1675},"end":{"line":45,"column":139,"offset":1813},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":1675},"end":{"line":45,"column":139,"offset":1813},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":47,"column":6,"offset":1820},"end":{"line":47,"column":35,"offset":1849},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":1819},"end":{"line":47,"column":70,"offset":1884},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":1819},"end":{"line":47,"column":70,"offset":1884},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":1815},"end":{"line":47,"column":70,"offset":1884},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":48,"column":6,"offset":1890},"end":{"line":48,"column":29,"offset":1913},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":1889},"end":{"line":48,"column":83,"offset":1967},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":1889},"end":{"line":48,"column":83,"offset":1967},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":1885},"end":{"line":48,"column":83,"offset":1967},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":49,"column":6,"offset":1973},"end":{"line":49,"column":28,"offset":1995},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":1972},"end":{"line":49,"column":57,"offset":2024},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":1972},"end":{"line":49,"column":57,"offset":2024},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":1968},"end":{"line":49,"column":57,"offset":2024},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":50,"column":6,"offset":2030},"end":{"line":50,"column":11,"offset":2035},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":2029},"end":{"line":50,"column":29,"offset":2053},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":2029},"end":{"line":50,"column":29,"offset":2053},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2025},"end":{"line":50,"column":29,"offset":2053},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":1815},"end":{"line":50,"column":29,"offset":2053},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"For each provider, the appropriate security settings has to be filled in. For example for AWS you need to define the access and secret key, for GCP you need to define the Service Account.","position":{"start":{"line":52,"column":1,"offset":2055},"end":{"line":52,"column":188,"offset":2242},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":2055},"end":{"line":52,"column":188,"offset":2242},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Additionaly a provider can be marked as temporary. This is helpful if you wish to store your recordings for a short period, and want to use it for processing purpose only. A benefit of doing this is reducing costs (if you host in the public cloud).","position":{"start":{"line":54,"column":1,"offset":2244},"end":{"line":54,"column":249,"offset":2492},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":2244},"end":{"line":54,"column":249,"offset":2492},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-providers.png","alt":"Storage","position":{"start":{"line":56,"column":1,"offset":2494},"end":{"line":56,"column":63,"offset":2556},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":2494},"end":{"line":56,"column":63,"offset":2556},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Queues","position":{"start":{"line":58,"column":4,"offset":2561},"end":{"line":58,"column":10,"offset":2567},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":2558},"end":{"line":58,"column":10,"offset":2567},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Events or messages are generated each time a recording was uploaded to Kerberos Storage. These messages can be send to one ore moore message brokers such as Apache Kafka or AWS SQS. From the interface you can setup the connection, and once configured events will flow to your predefined message brokers.","position":{"start":{"line":60,"column":1,"offset":2569},"end":{"line":60,"column":304,"offset":2872},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":2569},"end":{"line":60,"column":304,"offset":2872},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"An example or usecase what you do with Queue's is building something like our Kerberos Cloud offering. Each time a Kerberos Cloud customer is sending recordings to his/her cloud profile, it is stored through Kerberos Storage into one of our public data centers. Next to that a message is send into our private Kafka broker, which is starting a chain of processing:","position":{"start":{"line":62,"column":1,"offset":2874},"end":{"line":62,"column":365,"offset":3238},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":2874},"end":{"line":62,"column":365,"offset":3238},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Metadata storage in MongoDB,","position":{"start":{"line":64,"column":5,"offset":3244},"end":{"line":64,"column":33,"offset":3272},"indent":[]}}],"position":{"start":{"line":64,"column":5,"offset":3244},"end":{"line":64,"column":33,"offset":3272},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":3240},"end":{"line":64,"column":33,"offset":3272},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Notifications,","position":{"start":{"line":65,"column":5,"offset":3277},"end":{"line":65,"column":19,"offset":3291},"indent":[]}}],"position":{"start":{"line":65,"column":5,"offset":3277},"end":{"line":65,"column":19,"offset":3291},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":3273},"end":{"line":65,"column":19,"offset":3291},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Classification with Tensorflow,","position":{"start":{"line":66,"column":5,"offset":3296},"end":{"line":66,"column":36,"offset":3327},"indent":[]}}],"position":{"start":{"line":66,"column":5,"offset":3296},"end":{"line":66,"column":36,"offset":3327},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":3292},"end":{"line":66,"column":36,"offset":3327},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Counting algorithms,","position":{"start":{"line":67,"column":5,"offset":3332},"end":{"line":67,"column":25,"offset":3352},"indent":[]}}],"position":{"start":{"line":67,"column":5,"offset":3332},"end":{"line":67,"column":25,"offset":3352},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3328},"end":{"line":67,"column":25,"offset":3352},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"and much more.","position":{"start":{"line":68,"column":5,"offset":3357},"end":{"line":68,"column":19,"offset":3371},"indent":[]}}],"position":{"start":{"line":68,"column":5,"offset":3357},"end":{"line":68,"column":19,"offset":3371},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":3353},"end":{"line":68,"column":19,"offset":3371},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":3240},"end":{"line":68,"column":19,"offset":3371},"indent":[1,1,1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-queues.png","alt":"Storage","position":{"start":{"line":70,"column":1,"offset":3373},"end":{"line":70,"column":60,"offset":3432},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":3373},"end":{"line":70,"column":60,"offset":3432},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Accounts","position":{"start":{"line":72,"column":4,"offset":3437},"end":{"line":72,"column":12,"offset":3445},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3434},"end":{"line":72,"column":12,"offset":3445},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Accounts is the access for end users or customers. In the account section we define configurations such as:","position":{"start":{"line":74,"column":1,"offset":3447},"end":{"line":74,"column":108,"offset":3554},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":3447},"end":{"line":74,"column":108,"offset":3554},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Allowed providers,","position":{"start":{"line":75,"column":5,"offset":3559},"end":{"line":75,"column":23,"offset":3577},"indent":[]}}],"position":{"start":{"line":75,"column":5,"offset":3559},"end":{"line":75,"column":23,"offset":3577},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3555},"end":{"line":75,"column":23,"offset":3577},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Public Key,","position":{"start":{"line":76,"column":5,"offset":3582},"end":{"line":76,"column":16,"offset":3593},"indent":[]}}],"position":{"start":{"line":76,"column":5,"offset":3582},"end":{"line":76,"column":16,"offset":3593},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":3578},"end":{"line":76,"column":16,"offset":3593},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secret Key,","position":{"start":{"line":77,"column":5,"offset":3598},"end":{"line":77,"column":16,"offset":3609},"indent":[]}}],"position":{"start":{"line":77,"column":5,"offset":3598},"end":{"line":77,"column":16,"offset":3609},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3594},"end":{"line":77,"column":16,"offset":3609},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Day limit","position":{"start":{"line":78,"column":5,"offset":3614},"end":{"line":78,"column":14,"offset":3623},"indent":[]}}],"position":{"start":{"line":78,"column":5,"offset":3614},"end":{"line":78,"column":14,"offset":3623},"indent":[]}}],"position":{"start":{"line":78,"column":1,"offset":3610},"end":{"line":78,"column":14,"offset":3623},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3555},"end":{"line":78,"column":14,"offset":3623},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"An account can be generated for each individual, or a asteriks account (*) can be generated; which is more suitable if you want to seperate devices or regions of devices.\nOnce an account is created it can be used in Kerberos Enterprise (and soon Kerberos Open Source) to persist your data from your Kerberos Agent into your own datacenter, public or private cloud.","position":{"start":{"line":80,"column":1,"offset":3625},"end":{"line":81,"column":194,"offset":3989},"indent":[1]}}],"position":{"start":{"line":80,"column":1,"offset":3625},"end":{"line":81,"column":194,"offset":3989},"indent":[1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-accounts.png","alt":"Storage","position":{"start":{"line":83,"column":1,"offset":3991},"end":{"line":83,"column":62,"offset":4052},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":3991},"end":{"line":83,"column":62,"offset":4052},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Media","position":{"start":{"line":85,"column":4,"offset":4057},"end":{"line":85,"column":9,"offset":4062},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":4054},"end":{"line":85,"column":9,"offset":4062},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"All recordings send through Kerberos Storage are stored, both for auditing as for cleanup policies.","position":{"start":{"line":87,"column":1,"offset":4064},"end":{"line":87,"column":100,"offset":4163},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4064},"end":{"line":87,"column":100,"offset":4163},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-media.png","alt":"Storage","position":{"start":{"line":89,"column":1,"offset":4165},"end":{"line":89,"column":59,"offset":4223},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4165},"end":{"line":89,"column":59,"offset":4223},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cleanup","position":{"start":{"line":91,"column":4,"offset":4228},"end":{"line":91,"column":11,"offset":4235},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4225},"end":{"line":91,"column":11,"offset":4235},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Storage might need to be erased after a while because of several reasons:","position":{"start":{"line":93,"column":1,"offset":4237},"end":{"line":93,"column":74,"offset":4310},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4237},"end":{"line":93,"column":74,"offset":4310},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"maybe the data is no longer relevant","position":{"start":{"line":95,"column":3,"offset":4314},"end":{"line":95,"column":39,"offset":4350},"indent":[]}}],"position":{"start":{"line":95,"column":3,"offset":4314},"end":{"line":95,"column":39,"offset":4350},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4312},"end":{"line":95,"column":39,"offset":4350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"due to security reasions","position":{"start":{"line":96,"column":3,"offset":4353},"end":{"line":96,"column":27,"offset":4377},"indent":[]}}],"position":{"start":{"line":96,"column":3,"offset":4353},"end":{"line":96,"column":27,"offset":4377},"indent":[]}}],"position":{"start":{"line":96,"column":1,"offset":4351},"end":{"line":96,"column":27,"offset":4377},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"etc.","position":{"start":{"line":97,"column":3,"offset":4380},"end":{"line":97,"column":7,"offset":4384},"indent":[]}}],"position":{"start":{"line":97,"column":3,"offset":4380},"end":{"line":97,"column":7,"offset":4384},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4378},"end":{"line":97,"column":7,"offset":4384},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4312},"end":{"line":97,"column":7,"offset":4384},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"To make this possible Kerberos Storage comes with a configurable cleanup script, which you can run inside your Kuberneters cluster next to your Kerberos Storage deployment.","position":{"start":{"line":99,"column":1,"offset":4386},"end":{"line":99,"column":173,"offset":4558},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4386},"end":{"line":99,"column":173,"offset":4558},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":102,"column":1,"offset":4561},"end":{"line":102,"column":31,"offset":4591},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":102,"column":31,"offset":4591}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Get Started`}

\n

{`Once you've installed Kerberos Storage, you will have the Kerberos Storage web app running. This web app allows you to administrate Kerberos Storage. You can add storage providers, queues, accounts, and more. `}

\n

{`Login page`}

\n

{`Once you open a browser, and navigate to the Storage web application (see installation for the url), you will land on the login page.`}

\n

\"Storage\"

\n

{`The default username password of the Storage applications is:`}

\n
    \n
  • {`username: `}{`root`}
    • \n
  • {`password: `}{`kerberos`}
    • \n
\n
\n

{`The username and password can be changed in the `}{`deployment.yaml`}{` file.`}

\n
\n

{`License key`}

\n

{`The first time you login you are asked for a license key, this can be obtained by sending a request to cedric@verstraeten.io. An example license key looks like this:`}

\n
\n

{`-----BEGIN LICENSE KEY-----\nL/+DAwEBB2xpY2Vuc2UB/4QAAQIBB1BheWxvYWQBCgABCVNpZ25hdHVyZQEKAAAA\n/9z/hAFUPBAADG1haW4uTGljZW5zZf+BAwEBB0xpY2Vuc2UB/4IAAQIBB0NvbXBh\nbnkBDAABB0V4cFRpbWUBBAAAABb/ghMBCmtlcmJlcm9zaW8B/MC7ZzIAAf+AOaJ+\n8eU3OlZCphr4uJyH/PzfuDkMrqyfIsutc5kSz3rjsRtU4e6vETpHre8CPvFyx5w2\n0O8PKCIR4z1q28qJK2cvHQTK0/zf+KfYLilEcmNczLXgg+bnPvtA/bU/K8ZEwbnw\nRta3+8zId+xtYQApdmHwo/Ih/vCN579iDeunwVQA\n-----END LICENSE KEY-----`}

\n
\n

\"Factory\"

\n

{`Once you received a license key, and entered it into the web app you will be redirected to the login screen. Enter your credentials again, and you will be guided into the dashboard.`}

\n

{`Providers`}

\n

{`Once you signed in succesfully, you land on the providers page. Here is the place where you can add your datasources. You can choose from:`}

\n \n

{`For each provider, the appropriate security settings has to be filled in. For example for AWS you need to define the access and secret key, for GCP you need to define the Service Account.`}

\n

{`Additionaly a provider can be marked as temporary. This is helpful if you wish to store your recordings for a short period, and want to use it for processing purpose only. A benefit of doing this is reducing costs (if you host in the public cloud).`}

\n

\"Storage\"

\n

{`Queues`}

\n

{`Events or messages are generated each time a recording was uploaded to Kerberos Storage. These messages can be send to one ore moore message brokers such as Apache Kafka or AWS SQS. From the interface you can setup the connection, and once configured events will flow to your predefined message brokers.`}

\n

{`An example or usecase what you do with Queue's is building something like our Kerberos Cloud offering. Each time a Kerberos Cloud customer is sending recordings to his/her cloud profile, it is stored through Kerberos Storage into one of our public data centers. Next to that a message is send into our private Kafka broker, which is starting a chain of processing:`}

\n
    \n
  • {`Metadata storage in MongoDB,`}
    • \n
  • {`Notifications,`}
    • \n
  • {`Classification with Tensorflow,`}
    • \n
  • {`Counting algorithms,`}
    • \n
  • {`and much more.`}
    • \n
\n

\"Storage\"

\n

{`Accounts`}

\n

{`Accounts is the access for end users or customers. In the account section we define configurations such as:`}

\n
    \n
  • {`Allowed providers,`}
    • \n
  • {`Public Key,`}
    • \n
  • {`Secret Key,`}
    • \n
  • {`Day limit`}
    • \n
\n

{`An account can be generated for each individual, or a asteriks account (*) can be generated; which is more suitable if you want to seperate devices or regions of devices.\nOnce an account is created it can be used in Kerberos Enterprise (and soon Kerberos Open Source) to persist your data from your Kerberos Agent into your own datacenter, public or private cloud.`}

\n

\"Storage\"

\n

{`Media`}

\n

{`All recordings send through Kerberos Storage are stored, both for auditing as for cleanup policies.`}

\n

\"Storage\"

\n

{`Cleanup`}

\n

{`Storage might need to be erased after a while because of several reasons:`}

\n
    \n
  • {`maybe the data is no longer relevant`}
    • \n
  • {`due to security reasions`}
    • \n
  • {`etc.`}
    • \n
\n

{`To make this possible Kerberos Storage comes with a configurable cleanup script, which you can run inside your Kuberneters cluster next to your Kerberos Storage deployment.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c33aead070583dfe74e5182f4c03a463.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c33aead070583dfe74e5182f4c03a463.json index 1ccb5c2..8574096 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c33aead070583dfe74e5182f4c03a463.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c33aead070583dfe74e5182f4c03a463.json @@ -1 +1 @@ -{"expireTime":9007200861747683000,"key":"gatsby-plugin-mdx-entire-payload-b8c441bb7cc4a1f3ef7a0a58975aaa8b-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Kerberos Storage - Providers","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":31,"offset":189},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":31,"offset":189},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage allows you to attach one or more (and different) storage providers. These providers could be in the cloud like S3, Google Cloud Storage or Azure blob storage, or providers on premise such as Minio.","position":{"start":{"line":10,"column":1,"offset":191},"end":{"line":10,"column":215,"offset":405},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":191},"end":{"line":10,"column":215,"offset":405},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Depending on your use case: Kerberos Storage Cloud or Kerberos Storage Edge, you will opt for a specific storage provider. For example in the case Kerberos Storage Edge, it makes sense to store your recordings also at the edge. The accomplish this you could for example setup a Minio instance.","position":{"start":{"line":12,"column":1,"offset":407},"end":{"line":12,"column":294,"offset":700},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":407},"end":{"line":12,"column":294,"offset":700},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Below you can find a detailed step-by-step guide to setup different storage providers.","position":{"start":{"line":14,"column":1,"offset":702},"end":{"line":14,"column":87,"offset":788},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":702},"end":{"line":14,"column":87,"offset":788},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":16,"column":4,"offset":793},"end":{"line":16,"column":17,"offset":806},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":790},"end":{"line":16,"column":17,"offset":806},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This installation guide assumes you have setup Kerberos Storage properly.","position":{"start":{"line":18,"column":1,"offset":808},"end":{"line":18,"column":74,"offset":881},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":808},"end":{"line":18,"column":74,"offset":881},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Installation Minio","position":{"start":{"line":20,"column":4,"offset":886},"end":{"line":20,"column":22,"offset":904},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":883},"end":{"line":20,"column":22,"offset":904},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Minio is the recommended solution if you want to persist your data at the edge. To setup minio you just have to install a few components. Let's start with getting the configuration files (if not already done) for setting up Minio.","position":{"start":{"line":22,"column":1,"offset":906},"end":{"line":22,"column":231,"offset":1136},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":906},"end":{"line":22,"column":231,"offset":1136},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/storage","position":{"start":{"line":24,"column":1,"offset":1138},"end":{"line":24,"column":53,"offset":1190},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Now we have the configrations available, let's use start with creating a ","position":{"start":{"line":26,"column":1,"offset":1192},"end":{"line":26,"column":74,"offset":1265},"indent":[]}},{"type":"inlineCode","value":"local-storage","position":{"start":{"line":26,"column":74,"offset":1265},"end":{"line":26,"column":89,"offset":1280},"indent":[]}},{"type":"text","value":" volume using ","position":{"start":{"line":26,"column":89,"offset":1280},"end":{"line":26,"column":103,"offset":1294},"indent":[]}},{"type":"inlineCode","value":"./storage/yaml/minio/volume.yaml","position":{"start":{"line":26,"column":103,"offset":1294},"end":{"line":26,"column":137,"offset":1328},"indent":[]}},{"type":"text","value":" file. When opening the file we should focus on following attributes.","position":{"start":{"line":26,"column":137,"offset":1328},"end":{"line":26,"column":206,"offset":1397},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1192},"end":{"line":26,"column":206,"offset":1397},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n capacity:\n--> storage: 20Gi\n accessModes:\n - ReadWriteOnce\n persistentVolumeReclaimPolicy: Recycle\n storageClassName: hdd\n local:\n--> path: /home/minio\n nodeAffinity:\n required:\n nodeSelectorTerms:\n - matchExpressions:\n - key: kubernetes.io/hostname\n operator: In\n values:\n--> - hostname","position":{"start":{"line":29,"column":1,"offset":1400},"end":{"line":45,"column":27,"offset":1847},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Adapt the storage capacity to the amount of storage you want to assign to Minio, change the local path to the directory where you want to persist your data, and to finish make sure the hostname is the hostname of your node (where the directory is located). Once ready we can create the ","position":{"start":{"line":47,"column":1,"offset":1849},"end":{"line":47,"column":287,"offset":2135},"indent":[]}},{"type":"inlineCode","value":"local.path","position":{"start":{"line":47,"column":287,"offset":2135},"end":{"line":47,"column":299,"offset":2147},"indent":[]}},{"type":"text","value":" directory and create the volume.","position":{"start":{"line":47,"column":299,"offset":2147},"end":{"line":47,"column":332,"offset":2180},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":1849},"end":{"line":47,"column":332,"offset":2180},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"mkdir /home/minio\nkubectl apply -f ./storage/yaml/minio/volume.yaml","position":{"start":{"line":49,"column":1,"offset":2182},"end":{"line":50,"column":54,"offset":2257},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Next create Persistent Volume Claim (PVC), open the ","position":{"start":{"line":52,"column":1,"offset":2259},"end":{"line":52,"column":53,"offset":2311},"indent":[]}},{"type":"inlineCode","value":"./storage/yaml/minio/volume.yaml","position":{"start":{"line":52,"column":53,"offset":2311},"end":{"line":52,"column":87,"offset":2345},"indent":[]}},{"type":"text","value":" file and make sure the storage is aligned with the configurations of you ","position":{"start":{"line":52,"column":87,"offset":2345},"end":{"line":52,"column":161,"offset":2419},"indent":[]}},{"type":"inlineCode","value":"volume.yaml","position":{"start":{"line":52,"column":161,"offset":2419},"end":{"line":52,"column":174,"offset":2432},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":52,"column":174,"offset":2432},"end":{"line":52,"column":175,"offset":2433},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":2259},"end":{"line":52,"column":175,"offset":2433},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" resources:\n # This is the request for storage. Should be available in the cluster.\n requests:\n--> storage: 20Gi ","position":{"start":{"line":54,"column":1,"offset":2435},"end":{"line":57,"column":28,"offset":2576},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once ready, create the PVC.","position":{"start":{"line":59,"column":1,"offset":2578},"end":{"line":59,"column":28,"offset":2605},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":2578},"end":{"line":59,"column":28,"offset":2605},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./storage/yaml/minio/pvc.yaml","position":{"start":{"line":61,"column":1,"offset":2607},"end":{"line":61,"column":51,"offset":2657},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Ok, let us finish this and deploy the Kerberos Storage deployment. Before applying, we have to make sure the Ingress hostname is aligned. Open the ","position":{"start":{"line":63,"column":1,"offset":2659},"end":{"line":63,"column":148,"offset":2806},"indent":[]}},{"type":"inlineCode","value":"./storage/yaml/minio/deployment.yaml","position":{"start":{"line":63,"column":148,"offset":2806},"end":{"line":63,"column":186,"offset":2844},"indent":[]}},{"type":"text","value":" file and scroll down until you see the Ingress.","position":{"start":{"line":63,"column":186,"offset":2844},"end":{"line":63,"column":234,"offset":2892},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":2659},"end":{"line":63,"column":234,"offset":2892},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: minio.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: minio\n servicePort: 9000","position":{"start":{"line":65,"column":1,"offset":2894},"end":{"line":73,"column":34,"offset":3102},"indent":[1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Adapt the hostname to your needs, and apply the ","position":{"start":{"line":75,"column":1,"offset":3104},"end":{"line":75,"column":49,"offset":3152},"indent":[]}},{"type":"inlineCode","value":"deployment.yaml","position":{"start":{"line":75,"column":49,"offset":3152},"end":{"line":75,"column":66,"offset":3169},"indent":[]}},{"type":"text","value":" file when appropriate.","position":{"start":{"line":75,"column":66,"offset":3169},"end":{"line":75,"column":89,"offset":3192},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3104},"end":{"line":75,"column":89,"offset":3192},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./storage/yaml/minio/deployment.yaml","position":{"start":{"line":77,"column":1,"offset":3194},"end":{"line":77,"column":58,"offset":3251},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You should now see Minio being installed, and able to access it from your favourite web browser. You can use with the credentials you have defined in the ","position":{"start":{"line":79,"column":1,"offset":3253},"end":{"line":79,"column":155,"offset":3407},"indent":[]}},{"type":"inlineCode","value":"deployment.yaml file.","position":{"start":{"line":79,"column":155,"offset":3407},"end":{"line":79,"column":178,"offset":3430},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3253},"end":{"line":79,"column":178,"offset":3430},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/minio/webapp.png","alt":"minio kubernetes","position":{"start":{"line":81,"column":1,"offset":3432},"end":{"line":81,"column":58,"offset":3489},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3432},"end":{"line":81,"column":58,"offset":3489},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":84,"column":1,"offset":3492},"end":{"line":84,"column":31,"offset":3522},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":84,"column":31,"offset":3522}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Kerberos Storage - Providers`}

\n

{`Kerberos Storage allows you to attach one or more (and different) storage providers. These providers could be in the cloud like S3, Google Cloud Storage or Azure blob storage, or providers on premise such as Minio.`}

\n

{`Depending on your use case: Kerberos Storage Cloud or Kerberos Storage Edge, you will opt for a specific storage provider. For example in the case Kerberos Storage Edge, it makes sense to store your recordings also at the edge. The accomplish this you could for example setup a Minio instance.`}

\n

{`Below you can find a detailed step-by-step guide to setup different storage providers.`}

\n

{`Prerequisites`}

\n

{`This installation guide assumes you have setup Kerberos Storage properly.`}

\n

{`Installation Minio`}

\n

{`Minio is the recommended solution if you want to persist your data at the edge. To setup minio you just have to install a few components. Let's start with getting the configuration files (if not already done) for setting up Minio.`}

\n 
{`git clone https://github.com/kerberos-io/storage`}
\n

{`Now we have the configrations available, let's use start with creating a `}{`local-storage`}{` volume using `}{`./storage/yaml/minio/volume.yaml`}{` file. When opening the file we should focus on following attributes.`}

\n 
{`  spec:`}{`\n`}{`    capacity:`}{`\n`}{`-->   storage: 20Gi`}{`\n`}{`    accessModes:`}{`\n`}{`    - ReadWriteOnce`}{`\n`}{`    persistentVolumeReclaimPolicy: Recycle`}{`\n`}{`    storageClassName: hdd`}{`\n`}{`    local:`}{`\n`}{`-->   path: /home/minio`}{`\n`}{`    nodeAffinity:`}{`\n`}{`      required:`}{`\n`}{`        nodeSelectorTerms:`}{`\n`}{`        - matchExpressions:`}{`\n`}{`          - key: kubernetes.io/hostname`}{`\n`}{`            operator: In`}{`\n`}{`            values:`}{`\n`}{`-->         - hostname`}
\n

{`Adapt the storage capacity to the amount of storage you want to assign to Minio, change the local path to the directory where you want to persist your data, and to finish make sure the hostname is the hostname of your node (where the directory is located). Once ready we can create the `}{`local.path`}{` directory and create the volume.`}

\n 
{`mkdir /home/minio`}{`\n`}{`kubectl apply -f ./storage/yaml/minio/volume.yaml`}
\n

{`Next create Persistent Volume Claim (PVC), open the `}{`./storage/yaml/minio/volume.yaml`}{` file and make sure the storage is aligned with the configurations of you `}{`volume.yaml`}{`.`}

\n 
{`  resources:`}{`\n`}{`    # This is the request for storage. Should be available in the cluster.`}{`\n`}{`    requests:`}{`\n`}{`-->   storage: 20Gi    `}
\n

{`Once ready, create the PVC.`}

\n 
{`kubectl apply -f ./storage/yaml/minio/pvc.yaml`}
\n

{`Ok, let us finish this and deploy the Kerberos Storage deployment. Before applying, we have to make sure the Ingress hostname is aligned. Open the `}{`./storage/yaml/minio/deployment.yaml`}{` file and scroll down until you see the Ingress.`}

\n 
{`  spec:`}{`\n`}{`    rules:`}{`\n`}{`--> - host: minio.domain.com`}{`\n`}{`      http:`}{`\n`}{`        paths:`}{`\n`}{`        - path: /`}{`\n`}{`          backend:`}{`\n`}{`            serviceName: minio`}{`\n`}{`            servicePort: 9000`}
\n

{`Adapt the hostname to your needs, and apply the `}{`deployment.yaml`}{` file when appropriate.`}

\n 
{`kubectl apply -f ./storage/yaml/minio/deployment.yaml`}
\n

{`You should now see Minio being installed, and able to access it from your favourite web browser. You can use with the credentials you have defined in the `}{`deployment.yaml file.`}

\n

\"minio

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750187000,"key":"gatsby-plugin-mdx-entire-payload-b8c441bb7cc4a1f3ef7a0a58975aaa8b-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Kerberos Storage - Providers","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":31,"offset":189},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":31,"offset":189},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage allows you to attach one or more (and different) storage providers. These providers could be in the cloud like S3, Google Cloud Storage or Azure blob storage, or providers on premise such as Minio.","position":{"start":{"line":10,"column":1,"offset":191},"end":{"line":10,"column":215,"offset":405},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":191},"end":{"line":10,"column":215,"offset":405},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Depending on your use case: Kerberos Storage Cloud or Kerberos Storage Edge, you will opt for a specific storage provider. For example in the case Kerberos Storage Edge, it makes sense to store your recordings also at the edge. The accomplish this you could for example setup a Minio instance.","position":{"start":{"line":12,"column":1,"offset":407},"end":{"line":12,"column":294,"offset":700},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":407},"end":{"line":12,"column":294,"offset":700},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Below you can find a detailed step-by-step guide to setup different storage providers.","position":{"start":{"line":14,"column":1,"offset":702},"end":{"line":14,"column":87,"offset":788},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":702},"end":{"line":14,"column":87,"offset":788},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Prerequisites","position":{"start":{"line":16,"column":4,"offset":793},"end":{"line":16,"column":17,"offset":806},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":790},"end":{"line":16,"column":17,"offset":806},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This installation guide assumes you have setup Kerberos Storage properly.","position":{"start":{"line":18,"column":1,"offset":808},"end":{"line":18,"column":74,"offset":881},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":808},"end":{"line":18,"column":74,"offset":881},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Installation Minio","position":{"start":{"line":20,"column":4,"offset":886},"end":{"line":20,"column":22,"offset":904},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":883},"end":{"line":20,"column":22,"offset":904},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Minio is the recommended solution if you want to persist your data at the edge. To setup minio you just have to install a few components. Let's start with getting the configuration files (if not already done) for setting up Minio.","position":{"start":{"line":22,"column":1,"offset":906},"end":{"line":22,"column":231,"offset":1136},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":906},"end":{"line":22,"column":231,"offset":1136},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/storage","position":{"start":{"line":24,"column":1,"offset":1138},"end":{"line":24,"column":53,"offset":1190},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Now we have the configrations available, let's use start with creating a ","position":{"start":{"line":26,"column":1,"offset":1192},"end":{"line":26,"column":74,"offset":1265},"indent":[]}},{"type":"inlineCode","value":"local-storage","position":{"start":{"line":26,"column":74,"offset":1265},"end":{"line":26,"column":89,"offset":1280},"indent":[]}},{"type":"text","value":" volume using ","position":{"start":{"line":26,"column":89,"offset":1280},"end":{"line":26,"column":103,"offset":1294},"indent":[]}},{"type":"inlineCode","value":"./storage/yaml/minio/volume.yaml","position":{"start":{"line":26,"column":103,"offset":1294},"end":{"line":26,"column":137,"offset":1328},"indent":[]}},{"type":"text","value":" file. When opening the file we should focus on following attributes.","position":{"start":{"line":26,"column":137,"offset":1328},"end":{"line":26,"column":206,"offset":1397},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1192},"end":{"line":26,"column":206,"offset":1397},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n capacity:\n--> storage: 20Gi\n accessModes:\n - ReadWriteOnce\n persistentVolumeReclaimPolicy: Recycle\n storageClassName: hdd\n local:\n--> path: /home/minio\n nodeAffinity:\n required:\n nodeSelectorTerms:\n - matchExpressions:\n - key: kubernetes.io/hostname\n operator: In\n values:\n--> - hostname","position":{"start":{"line":29,"column":1,"offset":1400},"end":{"line":45,"column":27,"offset":1847},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Adapt the storage capacity to the amount of storage you want to assign to Minio, change the local path to the directory where you want to persist your data, and to finish make sure the hostname is the hostname of your node (where the directory is located). Once ready we can create the ","position":{"start":{"line":47,"column":1,"offset":1849},"end":{"line":47,"column":287,"offset":2135},"indent":[]}},{"type":"inlineCode","value":"local.path","position":{"start":{"line":47,"column":287,"offset":2135},"end":{"line":47,"column":299,"offset":2147},"indent":[]}},{"type":"text","value":" directory and create the volume.","position":{"start":{"line":47,"column":299,"offset":2147},"end":{"line":47,"column":332,"offset":2180},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":1849},"end":{"line":47,"column":332,"offset":2180},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"mkdir /home/minio\nkubectl apply -f ./storage/yaml/minio/volume.yaml","position":{"start":{"line":49,"column":1,"offset":2182},"end":{"line":50,"column":54,"offset":2257},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Next create Persistent Volume Claim (PVC), open the ","position":{"start":{"line":52,"column":1,"offset":2259},"end":{"line":52,"column":53,"offset":2311},"indent":[]}},{"type":"inlineCode","value":"./storage/yaml/minio/volume.yaml","position":{"start":{"line":52,"column":53,"offset":2311},"end":{"line":52,"column":87,"offset":2345},"indent":[]}},{"type":"text","value":" file and make sure the storage is aligned with the configurations of you ","position":{"start":{"line":52,"column":87,"offset":2345},"end":{"line":52,"column":161,"offset":2419},"indent":[]}},{"type":"inlineCode","value":"volume.yaml","position":{"start":{"line":52,"column":161,"offset":2419},"end":{"line":52,"column":174,"offset":2432},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":52,"column":174,"offset":2432},"end":{"line":52,"column":175,"offset":2433},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":2259},"end":{"line":52,"column":175,"offset":2433},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" resources:\n # This is the request for storage. Should be available in the cluster.\n requests:\n--> storage: 20Gi ","position":{"start":{"line":54,"column":1,"offset":2435},"end":{"line":57,"column":28,"offset":2576},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once ready, create the PVC.","position":{"start":{"line":59,"column":1,"offset":2578},"end":{"line":59,"column":28,"offset":2605},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":2578},"end":{"line":59,"column":28,"offset":2605},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./storage/yaml/minio/pvc.yaml","position":{"start":{"line":61,"column":1,"offset":2607},"end":{"line":61,"column":51,"offset":2657},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Ok, let us finish this and deploy the Kerberos Storage deployment. Before applying, we have to make sure the Ingress hostname is aligned. Open the ","position":{"start":{"line":63,"column":1,"offset":2659},"end":{"line":63,"column":148,"offset":2806},"indent":[]}},{"type":"inlineCode","value":"./storage/yaml/minio/deployment.yaml","position":{"start":{"line":63,"column":148,"offset":2806},"end":{"line":63,"column":186,"offset":2844},"indent":[]}},{"type":"text","value":" file and scroll down until you see the Ingress.","position":{"start":{"line":63,"column":186,"offset":2844},"end":{"line":63,"column":234,"offset":2892},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":2659},"end":{"line":63,"column":234,"offset":2892},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: minio.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: minio\n servicePort: 9000","position":{"start":{"line":65,"column":1,"offset":2894},"end":{"line":73,"column":34,"offset":3102},"indent":[1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Adapt the hostname to your needs, and apply the ","position":{"start":{"line":75,"column":1,"offset":3104},"end":{"line":75,"column":49,"offset":3152},"indent":[]}},{"type":"inlineCode","value":"deployment.yaml","position":{"start":{"line":75,"column":49,"offset":3152},"end":{"line":75,"column":66,"offset":3169},"indent":[]}},{"type":"text","value":" file when appropriate.","position":{"start":{"line":75,"column":66,"offset":3169},"end":{"line":75,"column":89,"offset":3192},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3104},"end":{"line":75,"column":89,"offset":3192},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./storage/yaml/minio/deployment.yaml","position":{"start":{"line":77,"column":1,"offset":3194},"end":{"line":77,"column":58,"offset":3251},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You should now see Minio being installed, and able to access it from your favourite web browser. You can use with the credentials you have defined in the ","position":{"start":{"line":79,"column":1,"offset":3253},"end":{"line":79,"column":155,"offset":3407},"indent":[]}},{"type":"inlineCode","value":"deployment.yaml file.","position":{"start":{"line":79,"column":155,"offset":3407},"end":{"line":79,"column":178,"offset":3430},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3253},"end":{"line":79,"column":178,"offset":3430},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/minio/webapp.png","alt":"minio kubernetes","position":{"start":{"line":81,"column":1,"offset":3432},"end":{"line":81,"column":58,"offset":3489},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3432},"end":{"line":81,"column":58,"offset":3489},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":84,"column":1,"offset":3492},"end":{"line":84,"column":31,"offset":3522},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":84,"column":31,"offset":3522}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Kerberos Storage - Providers`}

\n

{`Kerberos Storage allows you to attach one or more (and different) storage providers. These providers could be in the cloud like S3, Google Cloud Storage or Azure blob storage, or providers on premise such as Minio.`}

\n

{`Depending on your use case: Kerberos Storage Cloud or Kerberos Storage Edge, you will opt for a specific storage provider. For example in the case Kerberos Storage Edge, it makes sense to store your recordings also at the edge. The accomplish this you could for example setup a Minio instance.`}

\n

{`Below you can find a detailed step-by-step guide to setup different storage providers.`}

\n

{`Prerequisites`}

\n

{`This installation guide assumes you have setup Kerberos Storage properly.`}

\n

{`Installation Minio`}

\n

{`Minio is the recommended solution if you want to persist your data at the edge. To setup minio you just have to install a few components. Let's start with getting the configuration files (if not already done) for setting up Minio.`}

\n 
{`git clone https://github.com/kerberos-io/storage`}
\n

{`Now we have the configrations available, let's use start with creating a `}{`local-storage`}{` volume using `}{`./storage/yaml/minio/volume.yaml`}{` file. When opening the file we should focus on following attributes.`}

\n 
{`  spec:`}{`\n`}{`    capacity:`}{`\n`}{`-->   storage: 20Gi`}{`\n`}{`    accessModes:`}{`\n`}{`    - ReadWriteOnce`}{`\n`}{`    persistentVolumeReclaimPolicy: Recycle`}{`\n`}{`    storageClassName: hdd`}{`\n`}{`    local:`}{`\n`}{`-->   path: /home/minio`}{`\n`}{`    nodeAffinity:`}{`\n`}{`      required:`}{`\n`}{`        nodeSelectorTerms:`}{`\n`}{`        - matchExpressions:`}{`\n`}{`          - key: kubernetes.io/hostname`}{`\n`}{`            operator: In`}{`\n`}{`            values:`}{`\n`}{`-->         - hostname`}
\n

{`Adapt the storage capacity to the amount of storage you want to assign to Minio, change the local path to the directory where you want to persist your data, and to finish make sure the hostname is the hostname of your node (where the directory is located). Once ready we can create the `}{`local.path`}{` directory and create the volume.`}

\n 
{`mkdir /home/minio`}{`\n`}{`kubectl apply -f ./storage/yaml/minio/volume.yaml`}
\n

{`Next create Persistent Volume Claim (PVC), open the `}{`./storage/yaml/minio/volume.yaml`}{` file and make sure the storage is aligned with the configurations of you `}{`volume.yaml`}{`.`}

\n 
{`  resources:`}{`\n`}{`    # This is the request for storage. Should be available in the cluster.`}{`\n`}{`    requests:`}{`\n`}{`-->   storage: 20Gi    `}
\n

{`Once ready, create the PVC.`}

\n 
{`kubectl apply -f ./storage/yaml/minio/pvc.yaml`}
\n

{`Ok, let us finish this and deploy the Kerberos Storage deployment. Before applying, we have to make sure the Ingress hostname is aligned. Open the `}{`./storage/yaml/minio/deployment.yaml`}{` file and scroll down until you see the Ingress.`}

\n 
{`  spec:`}{`\n`}{`    rules:`}{`\n`}{`--> - host: minio.domain.com`}{`\n`}{`      http:`}{`\n`}{`        paths:`}{`\n`}{`        - path: /`}{`\n`}{`          backend:`}{`\n`}{`            serviceName: minio`}{`\n`}{`            servicePort: 9000`}
\n

{`Adapt the hostname to your needs, and apply the `}{`deployment.yaml`}{` file when appropriate.`}

\n 
{`kubectl apply -f ./storage/yaml/minio/deployment.yaml`}
\n

{`You should now see Minio being installed, and able to access it from your favourite web browser. You can use with the credentials you have defined in the `}{`deployment.yaml file.`}

\n

\"minio

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c4406cf1c3a749f51f72af2fcb6e9fb9.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c4406cf1c3a749f51f72af2fcb6e9fb9.json new file mode 100644 index 0000000..92a2559 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c4406cf1c3a749f51f72af2fcb6e9fb9.json @@ -0,0 +1 @@ +{"expireTime":9007200861750300000,"key":"gatsby-plugin-mdx-entire-payload-bfcd188b7df1d61d6fb9467d0f1e72c3-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Enterprise","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.","position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}}],"position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Next to that many other vendors started working on custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, and in the end delivering a closed software solution with limited API and/or messaging capabilities.","position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":242,"offset":1019},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":242,"offset":1019},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud which is open solution stack, suitable for scaling against your ever growing video surveillance landscape, but having extensibility and integration built-in from the start.","position":{"start":{"line":18,"column":1,"offset":1021},"end":{"line":18,"column":269,"offset":1289},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1021},"end":{"line":18,"column":269,"offset":1289},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":20,"column":1,"offset":1291},"end":{"line":22,"column":11,"offset":1493},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":24,"column":4,"offset":1498},"end":{"line":24,"column":14,"offset":1508},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1495},"end":{"line":24,"column":14,"offset":1508},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.","position":{"start":{"line":26,"column":1,"offset":1510},"end":{"line":26,"column":306,"offset":1815},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1510},"end":{"line":26,"column":306,"offset":1815},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":28,"column":1,"offset":1817},"end":{"line":28,"column":91,"offset":1907},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1817},"end":{"line":28,"column":91,"offset":1907},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).","position":{"start":{"line":30,"column":1,"offset":1909},"end":{"line":30,"column":239,"offset":2147},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1909},"end":{"line":30,"column":239,"offset":2147},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.","position":{"start":{"line":32,"column":1,"offset":2149},"end":{"line":32,"column":242,"offset":2390},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2149},"end":{"line":32,"column":242,"offset":2390},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.","position":{"start":{"line":34,"column":1,"offset":2392},"end":{"line":34,"column":205,"offset":2596},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2392},"end":{"line":34,"column":205,"offset":2596},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud or on premise","position":{"start":{"line":36,"column":4,"offset":2601},"end":{"line":36,"column":23,"offset":2620},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2598},"end":{"line":36,"column":23,"offset":2620},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.","position":{"start":{"line":38,"column":1,"offset":2622},"end":{"line":38,"column":283,"offset":2904},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2622},"end":{"line":38,"column":283,"offset":2904},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":40,"column":1,"offset":2906},"end":{"line":40,"column":97,"offset":3002},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2906},"end":{"line":40,"column":97,"offset":3002},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":42,"column":4,"offset":3007},"end":{"line":42,"column":13,"offset":3016},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":3004},"end":{"line":42,"column":13,"offset":3016},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is publicly available and ","position":{"start":{"line":44,"column":1,"offset":3018},"end":{"line":44,"column":47,"offset":3064},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":44,"column":49,"offset":3066},"end":{"line":44,"column":57,"offset":3074},"indent":[]}}],"position":{"start":{"line":44,"column":47,"offset":3064},"end":{"line":44,"column":59,"offset":3076},"indent":[]}},{"type":"text","value":" require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.","position":{"start":{"line":44,"column":59,"offset":3076},"end":{"line":44,"column":174,"offset":3191},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":3018},"end":{"line":44,"column":174,"offset":3191},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":47,"column":1,"offset":3194},"end":{"line":47,"column":31,"offset":3224},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":47,"column":31,"offset":3224}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Enterprise`}

\n

{`Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.`}

\n

{`That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.`}

\n

{`Next to that many other vendors started working on custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, and in the end delivering a closed software solution with limited API and/or messaging capabilities.`}

\n

{`Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud which is open solution stack, suitable for scaling against your ever growing video surveillance landscape, but having extensibility and integration built-in from the start.`}

\n
\n
\n

\n

{`Kubernetes`}

\n

{`To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.`}

\n

\"architecture

\n

{`Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).`}

\n

{`Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.`}

\n

{`By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.`}

\n

{`Cloud or on premise`}

\n

{`You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.`}

\n

\"architecture

\n

{`Licensing`}

\n

{`Kerberos Enterprise is publicly available and `}{`does not`}{` require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c5e8dbe187c832af2c8a3a1ff00efc31.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c5e8dbe187c832af2c8a3a1ff00efc31.json new file mode 100644 index 0000000..c13dbab --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-c5e8dbe187c832af2c8a3a1ff00efc31.json @@ -0,0 +1 @@ +{"expireTime":9007200861824786000,"key":"gatsby-plugin-mdx-entire-payload-c230e5cb6202087d568735dbe8785e21-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import SettingsIcon from '@material-ui/icons/Settings';","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":56,"offset":214},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Get Started","position":{"start":{"line":10,"column":3,"offset":218},"end":{"line":10,"column":14,"offset":229},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":216},"end":{"line":10,"column":14,"offset":229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.","position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":231},"end":{"line":12,"column":279,"offset":509},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known ","position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":169,"offset":679},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":14,"column":169,"offset":679},"end":{"line":14,"column":178,"offset":688},"indent":[]}},{"type":"text","value":" command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.","position":{"start":{"line":14,"column":178,"offset":688},"end":{"line":14,"column":314,"offset":824},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":511},"end":{"line":14,"column":314,"offset":824},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":16,"column":1,"offset":826},"end":{"line":18,"column":11,"offset":1028},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Login page","position":{"start":{"line":20,"column":4,"offset":1033},"end":{"line":20,"column":14,"offset":1043},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1030},"end":{"line":20,"column":14,"offset":1043},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.","position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1045},"end":{"line":22,"column":134,"offset":1178},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/login.gif","alt":"Factory","position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1180},"end":{"line":24,"column":50,"offset":1229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The default username password of the Factory web applications is:","position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1231},"end":{"line":26,"column":66,"offset":1296},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"username: ","position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":13,"offset":1310},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"root","position":{"start":{"line":28,"column":15,"offset":1312},"end":{"line":28,"column":19,"offset":1316},"indent":[]}}],"position":{"start":{"line":28,"column":13,"offset":1310},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":3,"offset":1300},"end":{"line":28,"column":21,"offset":1318},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":28,"column":21,"offset":1318},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"password: ","position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":13,"offset":1331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"kerberos","position":{"start":{"line":29,"column":15,"offset":1333},"end":{"line":29,"column":23,"offset":1341},"indent":[]}}],"position":{"start":{"line":29,"column":13,"offset":1331},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":3,"offset":1321},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1319},"end":{"line":29,"column":25,"offset":1343},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1298},"end":{"line":29,"column":25,"offset":1343},"indent":[1]}},{"type":"blockquote","children":[{"type":"paragraph","children":[{"type":"text","value":"The username and password ","position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":29,"offset":1373},"indent":[]}},{"type":"link","title":null,"url":"https://github.com/kerberos-io/enterprise/blob/master/yaml/factory/deployment.yaml#L54","children":[{"type":"text","value":"can be changed in the ","position":{"start":{"line":31,"column":30,"offset":1374},"end":{"line":31,"column":52,"offset":1396},"indent":[]}},{"type":"inlineCode","value":"deploment.yaml","position":{"start":{"line":31,"column":52,"offset":1396},"end":{"line":31,"column":68,"offset":1412},"indent":[]}},{"type":"text","value":" file","position":{"start":{"line":31,"column":68,"offset":1412},"end":{"line":31,"column":73,"offset":1417},"indent":[]}}],"position":{"start":{"line":31,"column":29,"offset":1373},"end":{"line":31,"column":162,"offset":1506},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":162,"offset":1506},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":3,"offset":1347},"end":{"line":31,"column":163,"offset":1507},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1345},"end":{"line":31,"column":163,"offset":1507},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Overview","position":{"start":{"line":33,"column":4,"offset":1512},"end":{"line":33,"column":12,"offset":1520},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1509},"end":{"line":33,"column":12,"offset":1520},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: ","position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":146,"offset":1667},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Docker","position":{"start":{"line":35,"column":148,"offset":1669},"end":{"line":35,"column":154,"offset":1675},"indent":[]}}],"position":{"start":{"line":35,"column":146,"offset":1667},"end":{"line":35,"column":156,"offset":1677},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":35,"column":156,"offset":1677},"end":{"line":35,"column":161,"offset":1682},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":35,"column":163,"offset":1684},"end":{"line":35,"column":173,"offset":1694},"indent":[]}}],"position":{"start":{"line":35,"column":161,"offset":1682},"end":{"line":35,"column":175,"offset":1696},"indent":[]}},{"type":"text","value":". Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.","position":{"start":{"line":35,"column":175,"offset":1696},"end":{"line":35,"column":317,"offset":1838},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1522},"end":{"line":35,"column":317,"offset":1838},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.","position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1840},"end":{"line":37,"column":187,"offset":2026},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/docker-Kubernetes.gif","alt":"Factory","position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2028},"end":{"line":39,"column":62,"offset":2089},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":41,"column":4,"offset":2094},"end":{"line":41,"column":14,"offset":2104},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2091},"end":{"line":41,"column":14,"offset":2104},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:","position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2106},"end":{"line":43,"column":99,"offset":2204},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Nodes: a list of all the nodes in your cluster.","position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":3,"offset":2208},"end":{"line":45,"column":50,"offset":2255},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":45,"column":50,"offset":2255},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Deployments: a list of all the Kerberos Enterprise agents running in your cluster.","position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":3,"offset":2258},"end":{"line":46,"column":85,"offset":2340},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":2256},"end":{"line":46,"column":85,"offset":2340},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pods: all the pods running in your cluster.","position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":3,"offset":2343},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2341},"end":{"line":47,"column":46,"offset":2386},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2206},"end":{"line":47,"column":46,"offset":2386},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Nodes","position":{"start":{"line":49,"column":4,"offset":2391},"end":{"line":49,"column":9,"offset":2396},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":2388},"end":{"line":49,"column":9,"offset":2396},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.","position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":2398},"end":{"line":51,"column":230,"offset":2627},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-nodes.png","alt":"Factory","position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2629},"end":{"line":53,"column":67,"offset":2695},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Deployments","position":{"start":{"line":55,"column":4,"offset":2700},"end":{"line":55,"column":15,"offset":2711},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2697},"end":{"line":55,"column":15,"offset":2711},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.","position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2713},"end":{"line":57,"column":409,"offset":3121},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-deployments.png","alt":"Factory","position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}}],"position":{"start":{"line":59,"column":1,"offset":3123},"end":{"line":59,"column":73,"offset":3195},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Adding a new deployment","position":{"start":{"line":61,"column":5,"offset":3201},"end":{"line":61,"column":28,"offset":3224},"indent":[]}}],"position":{"start":{"line":61,"column":1,"offset":3197},"end":{"line":61,"column":28,"offset":3224},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"There are two options to add a new deployment, single deployments and bulk deployment.","position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}}],"position":{"start":{"line":63,"column":1,"offset":3226},"end":{"line":63,"column":87,"offset":3312},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/single-bulk-deployment.gif","alt":"Factory","position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}}],"position":{"start":{"line":65,"column":1,"offset":3314},"end":{"line":65,"column":67,"offset":3380},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"single deployment","position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":3,"offset":3384},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":3382},"end":{"line":67,"column":20,"offset":3401},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.","position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":3403},"end":{"line":69,"column":161,"offset":3563},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"in bulk deployment.","position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":3,"offset":3567},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":3565},"end":{"line":71,"column":22,"offset":3586},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By importing an Excel file, deployments can be created in bulk.","position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":3588},"end":{"line":73,"column":64,"offset":3651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.","position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":3653},"end":{"line":75,"column":109,"offset":3761},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-add-bulk-deployment-excel.png","alt":"Factory","position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":3763},"end":{"line":77,"column":87,"offset":3849},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Configuring a deployment","position":{"start":{"line":79,"column":5,"offset":3855},"end":{"line":79,"column":29,"offset":3879},"indent":[]}}],"position":{"start":{"line":79,"column":1,"offset":3851},"end":{"line":79,"column":29,"offset":3879},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the ","position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":200,"offset":4080},"indent":[]}},{"type":"jsx","value":"","position":{"start":{"line":81,"column":200,"offset":4080},"end":{"line":81,"column":235,"offset":4115},"indent":[]}},{"type":"text","value":" icon. This will open a popup, allowing you to change some settings.","position":{"start":{"line":81,"column":235,"offset":4115},"end":{"line":81,"column":303,"offset":4183},"indent":[]}}],"position":{"start":{"line":81,"column":1,"offset":3881},"end":{"line":81,"column":303,"offset":4183},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/deployment-configuration.gif","alt":"Factory","position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}}],"position":{"start":{"line":83,"column":1,"offset":4185},"end":{"line":83,"column":69,"offset":4253},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Following settings can be changed:","position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}}],"position":{"start":{"line":85,"column":1,"offset":4255},"end":{"line":85,"column":35,"offset":4289},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more regions of interest,","position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":3,"offset":4293},"end":{"line":87,"column":35,"offset":4325},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":87,"column":35,"offset":4325},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Time based conditions,","position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":3,"offset":4328},"end":{"line":88,"column":25,"offset":4350},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":4326},"end":{"line":88,"column":25,"offset":4350},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Pre- and postrecording","position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":3,"offset":4353},"end":{"line":89,"column":25,"offset":4375},"indent":[]}}],"position":{"start":{"line":89,"column":1,"offset":4351},"end":{"line":89,"column":25,"offset":4375},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording","position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":3,"offset":4378},"end":{"line":90,"column":23,"offset":4398},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4376},"end":{"line":90,"column":23,"offset":4398},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Linking to ","position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":14,"offset":4412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":91,"column":15,"offset":4413},"end":{"line":91,"column":29,"offset":4427},"indent":[]}}],"position":{"start":{"line":91,"column":14,"offset":4412},"end":{"line":91,"column":38,"offset":4436},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":91,"column":38,"offset":4436},"end":{"line":91,"column":42,"offset":4440},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":91,"column":43,"offset":4441},"end":{"line":91,"column":59,"offset":4457},"indent":[]}}],"position":{"start":{"line":91,"column":42,"offset":4440},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":3,"offset":4401},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":91,"column":1,"offset":4399},"end":{"line":91,"column":83,"offset":4481},"indent":[]}}],"position":{"start":{"line":87,"column":1,"offset":4291},"end":{"line":91,"column":83,"offset":4481},"indent":[1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Global configuration","position":{"start":{"line":93,"column":5,"offset":4487},"end":{"line":93,"column":25,"offset":4507},"indent":[]}}],"position":{"start":{"line":93,"column":1,"offset":4483},"end":{"line":93,"column":25,"offset":4507},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.","position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}}],"position":{"start":{"line":95,"column":1,"offset":4509},"end":{"line":95,"column":249,"offset":4757},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.","position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4759},"end":{"line":97,"column":202,"offset":4960},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/global-configuration.gif","alt":"Factory Global Config","position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4962},"end":{"line":99,"column":79,"offset":5040},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Upgrade or reboot a Kerberos Enterprise agent","position":{"start":{"line":101,"column":5,"offset":5046},"end":{"line":101,"column":50,"offset":5091},"indent":[]}}],"position":{"start":{"line":101,"column":1,"offset":5042},"end":{"line":101,"column":50,"offset":5091},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, ","position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":373,"offset":5465},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"a zero downtime upgrade will take place","position":{"start":{"line":103,"column":375,"offset":5467},"end":{"line":103,"column":414,"offset":5506},"indent":[]}}],"position":{"start":{"line":103,"column":373,"offset":5465},"end":{"line":103,"column":416,"offset":5508},"indent":[]}},{"type":"text","value":". Kubernetes will download the new release, create a new pod, and destroy the old one.","position":{"start":{"line":103,"column":416,"offset":5508},"end":{"line":103,"column":502,"offset":5594},"indent":[]}}],"position":{"start":{"line":103,"column":1,"offset":5093},"end":{"line":103,"column":502,"offset":5594},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.","position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}}],"position":{"start":{"line":105,"column":1,"offset":5596},"end":{"line":105,"column":293,"offset":5888},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/upgrade-reboot.gif","alt":"Upgrade and reboot","position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}}],"position":{"start":{"line":107,"column":1,"offset":5890},"end":{"line":107,"column":70,"offset":5959},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Pods","position":{"start":{"line":110,"column":4,"offset":5965},"end":{"line":110,"column":8,"offset":5969},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":5962},"end":{"line":110,"column":8,"offset":5969},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.","position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":5971},"end":{"line":112,"column":439,"offset":6409},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-pods.png","alt":"Factory","position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}}],"position":{"start":{"line":114,"column":1,"offset":6411},"end":{"line":114,"column":66,"offset":6476},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage and video management","position":{"start":{"line":117,"column":4,"offset":6482},"end":{"line":117,"column":32,"offset":6510},"indent":[]}}],"position":{"start":{"line":117,"column":1,"offset":6479},"end":{"line":117,"column":32,"offset":6510},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).","position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}}],"position":{"start":{"line":119,"column":1,"offset":6512},"end":{"line":119,"column":354,"offset":6865},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also ","position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":169,"offset":7035},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":121,"column":171,"offset":7037},"end":{"line":121,"column":179,"offset":7045},"indent":[]}}],"position":{"start":{"line":121,"column":169,"offset":7035},"end":{"line":121,"column":181,"offset":7047},"indent":[]}},{"type":"text","value":" have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed ","position":{"start":{"line":121,"column":181,"offset":7047},"end":{"line":121,"column":419,"offset":7285},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":121,"column":420,"offset":7286},"end":{"line":121,"column":436,"offset":7302},"indent":[]}}],"position":{"start":{"line":121,"column":419,"offset":7285},"end":{"line":121,"column":460,"offset":7326},"indent":[]}},{"type":"text","value":" and ","position":{"start":{"line":121,"column":460,"offset":7326},"end":{"line":121,"column":465,"offset":7331},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":121,"column":466,"offset":7332},"end":{"line":121,"column":480,"offset":7346},"indent":[]}}],"position":{"start":{"line":121,"column":465,"offset":7331},"end":{"line":121,"column":489,"offset":7355},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":121,"column":489,"offset":7355},"end":{"line":121,"column":490,"offset":7356},"indent":[]}}],"position":{"start":{"line":121,"column":1,"offset":6867},"end":{"line":121,"column":490,"offset":7356},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":123,"column":5,"offset":7362},"end":{"line":123,"column":21,"offset":7378},"indent":[]}}],"position":{"start":{"line":123,"column":1,"offset":7358},"end":{"line":123,"column":21,"offset":7378},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":125,"column":2,"offset":7381},"end":{"line":125,"column":18,"offset":7397},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":42,"offset":7421},"indent":[]}},{"type":"text","value":" is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).","position":{"start":{"line":125,"column":42,"offset":7421},"end":{"line":125,"column":328,"offset":7707},"indent":[]}}],"position":{"start":{"line":125,"column":1,"offset":7380},"end":{"line":125,"column":328,"offset":7707},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).","position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}}],"position":{"start":{"line":127,"column":1,"offset":7709},"end":{"line":127,"column":266,"offset":7974},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":7976},"end":{"line":129,"column":66,"offset":8041},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the ","position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":147,"offset":8189},"indent":[]}},{"type":"inlineCode","value":"cloud","position":{"start":{"line":131,"column":147,"offset":8189},"end":{"line":131,"column":154,"offset":8196},"indent":[]}},{"type":"text","value":" tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.","position":{"start":{"line":131,"column":154,"offset":8196},"end":{"line":131,"column":245,"offset":8287},"indent":[]}}],"position":{"start":{"line":131,"column":1,"offset":8043},"end":{"line":131,"column":245,"offset":8287},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Storage URI: this is the API endpoint of your Kerberos Storage instance. Typically this is in the following format: ","position":{"start":{"line":133,"column":3,"offset":8291},"end":{"line":133,"column":119,"offset":8407},"indent":[]}},{"type":"inlineCode","value":"http(s)://api.yourdomain.com/storage. Where ","position":{"start":{"line":133,"column":119,"offset":8407},"end":{"line":133,"column":165,"offset":8453},"indent":[]}},{"type":"text","value":"api.yourdomain.com` should match your Kerberos Storage API endpoint.","position":{"start":{"line":133,"column":165,"offset":8453},"end":{"line":133,"column":233,"offset":8521},"indent":[]}}],"position":{"start":{"line":133,"column":3,"offset":8291},"end":{"line":133,"column":233,"offset":8521},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":8289},"end":{"line":134,"column":1,"offset":8522},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Provider: the name of the provider, which you created on the Kerberos Storage providers page, to which you want to send your recordings to.","position":{"start":{"line":135,"column":3,"offset":8525},"end":{"line":135,"column":142,"offset":8664},"indent":[]}}],"position":{"start":{"line":135,"column":3,"offset":8525},"end":{"line":135,"column":142,"offset":8664},"indent":[]}}],"position":{"start":{"line":135,"column":1,"offset":8523},"end":{"line":136,"column":1,"offset":8665},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Directory: this is the subdirectory in which your files will be stored. At the time of writing this should also equal your Kerberos Cloud username, if you plan to upload to Kerberos Cloud.","position":{"start":{"line":137,"column":3,"offset":8668},"end":{"line":137,"column":191,"offset":8856},"indent":[]}}],"position":{"start":{"line":137,"column":3,"offset":8668},"end":{"line":137,"column":191,"offset":8856},"indent":[]}}],"position":{"start":{"line":137,"column":1,"offset":8666},"end":{"line":138,"column":1,"offset":8857},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Access Key: this should match the access key of one of your Kerberos Storage accounts.","position":{"start":{"line":139,"column":3,"offset":8860},"end":{"line":139,"column":89,"offset":8946},"indent":[]}}],"position":{"start":{"line":139,"column":3,"offset":8860},"end":{"line":139,"column":89,"offset":8946},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":8858},"end":{"line":140,"column":1,"offset":8947},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Secret Access Key: this should match the secret access key of one of your Kerberos Storage accounts.","position":{"start":{"line":141,"column":3,"offset":8950},"end":{"line":141,"column":103,"offset":9050},"indent":[]}}],"position":{"start":{"line":141,"column":3,"offset":8950},"end":{"line":141,"column":103,"offset":9050},"indent":[]}}],"position":{"start":{"line":141,"column":1,"offset":8948},"end":{"line":141,"column":103,"offset":9050},"indent":[]}}],"position":{"start":{"line":133,"column":1,"offset":8289},"end":{"line":141,"column":103,"offset":9050},"indent":[1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-enterprise-storage-setup.gif","alt":"kerberos storage configuration","position":{"start":{"line":144,"column":1,"offset":9053},"end":{"line":144,"column":101,"offset":9153},"indent":[]}}],"position":{"start":{"line":144,"column":1,"offset":9053},"end":{"line":144,"column":101,"offset":9153},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":146,"column":5,"offset":9159},"end":{"line":146,"column":19,"offset":9173},"indent":[]}}],"position":{"start":{"line":146,"column":1,"offset":9155},"end":{"line":146,"column":19,"offset":9173},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more ","position":{"start":{"line":148,"column":1,"offset":9175},"end":{"line":148,"column":219,"offset":9393},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"about the features and functions here","position":{"start":{"line":148,"column":220,"offset":9394},"end":{"line":148,"column":257,"offset":9431},"indent":[]}}],"position":{"start":{"line":148,"column":219,"offset":9393},"end":{"line":148,"column":266,"offset":9440},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":148,"column":266,"offset":9440},"end":{"line":148,"column":267,"offset":9441},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":9175},"end":{"line":148,"column":267,"offset":9441},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the ","position":{"start":{"line":150,"column":1,"offset":9443},"end":{"line":150,"column":285,"offset":9727},"indent":[]}},{"type":"link","title":null,"url":"/storage/get-started","children":[{"type":"text","value":"Kerberos Storage page","position":{"start":{"line":150,"column":286,"offset":9728},"end":{"line":150,"column":307,"offset":9749},"indent":[]}}],"position":{"start":{"line":150,"column":285,"offset":9727},"end":{"line":150,"column":330,"offset":9772},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":150,"column":330,"offset":9772},"end":{"line":150,"column":331,"offset":9773},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":9443},"end":{"line":150,"column":331,"offset":9773},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.","position":{"start":{"line":152,"column":1,"offset":9775},"end":{"line":152,"column":104,"offset":9878},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":9775},"end":{"line":152,"column":104,"offset":9878},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-enterprise-to-cloud.gif","alt":"kerberos storage configuration","position":{"start":{"line":154,"column":1,"offset":9880},"end":{"line":154,"column":96,"offset":9975},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":9880},"end":{"line":154,"column":96,"offset":9975},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":157,"column":1,"offset":9978},"end":{"line":157,"column":31,"offset":10008},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":157,"column":31,"offset":10008}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport SettingsIcon from '@material-ui/icons/Settings';\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Get Started`}

\n

{`Once you've installed Kerberos Enterprise, you will have the Kerberos Enterprise Factory webapp running inside your cluster. This web application allows you to administrate your Kerberos Enterprise agents as deployments/pods. It comes a bunch of other features as well, read on.`}

\n

{`Important to note is that this web app is relying on the Golang Kubernetes SDK, so that means from an administration point of view, you could simply use the well known `}{`kubectl`}{` command. The webapp just add (a lot of) functionalities on top of the Kubernetes API, which are specific to Kerberos Enterprise agents.`}

\n
\n
\n

\n

{`Login page`}

\n

{`Once you open a browser, and navigate to the Factory web application (see installation for the url), you will land on the login page.`}

\n

\"Factory\"

\n

{`The default username password of the Factory web applications is:`}

\n
    \n
  • {`username: `}{`root`}
    • \n
  • {`password: `}{`kerberos`}
    • \n
\n
\n

{`The username and password `}{`can be changed in the `}{`deploment.yaml`}{` file`}{`.`}

\n
\n

{`Overview`}

\n

{`On the overview page you will find an intuitive overview of the different pages and functionalities. On the left menu you will see two sections: `}{`Docker`}{` and `}{`Kubernetes`}{`. Kerberos Enterprise can both run in Docker (single-host) and Kubernetes (cluster) mode, however the recommended way is of course Kubernetes.`}

\n

{`When working with Kubernetes, Kerberos Enterprise agents are deployed as a deployment. When working with Docker, Kerberos Enterprise agents are deployed as traditional Docker containers.`}

\n

\"Factory\"

\n

{`Kubernetes`}

\n

{`On the left menu you will find the Kubernetes section. In this section 3 sub menu's are available:`}

\n
    \n
  • {`Nodes: a list of all the nodes in your cluster.`}
    • \n
  • {`Deployments: a list of all the Kerberos Enterprise agents running in your cluster.`}
    • \n
  • {`Pods: all the pods running in your cluster.`}
    • \n
\n

{`Nodes`}

\n

{`The nodes section lists all the available nodes inside your Kubernetes cluster. It shows a limited amount of information such as the version, the number of Docker images installed on the node, and some basic hardware information.`}

\n

\"Factory\"

\n

{`Deployments`}

\n

{`The deployments section will list all the Kerberos Enterprise agents (running as deployments) that you have deployed inside your cluster. This page gives you access to deploy new Kerberos Enterprise agents one by one or in bulk. Next to that you can easily upgrade Kerberos Enterprise agents to a newer version, reboot them, view logging and update the configuration options of the Kerberos Enterprise agent.`}

\n

\"Factory\"

\n

{`Adding a new deployment`}

\n

{`There are two options to add a new deployment, single deployments and bulk deployment.`}

\n

\"Factory\"

\n
    \n
  • {`single deployment`}
    • \n
\n

{`By specifying a name for your deployment and it's corresponding RTSP url, a new deployment will be created for you, and deployed to one of your installed nodes.`}

\n
    \n
  • {`in bulk deployment.`}
    • \n
\n

{`By importing an Excel file, deployments can be created in bulk.`}

\n

{`By specifying the name and corresponding RTSP url in multiple rows, you can deploy your deployments in bulk.`}

\n

\"Factory\"

\n

{`Configuring a deployment`}

\n

{`Once you have a running deployment, you should see a green circle next to the deployment, indicating that it is succesfully running. At any time you can configure your deployments by clicking on the `}{` icon. This will open a popup, allowing you to change some settings.`}

\n

\"Factory\"

\n

{`Following settings can be changed:`}

\n
    \n
  • {`One or more regions of interest,`}
    • \n
  • {`Time based conditions,`}
    • \n
  • {`Pre- and postrecording`}
    • \n
  • {`Continious recording`}
    • \n
  • {`Linking to `}{`Kerberos Cloud`}{` or `}{`Kerberos Storage`}
    • \n
\n

{`Global configuration`}

\n

{`Configuration can be specified on a Kerberos Enterprise agent level, this means that you update the configuration of a specific deployment. However can also be specified at a higher level. This higher level is what we call the global configuration.`}

\n

{`By specifying configurations at a higher level, any Kerberos Enterprise agents will inherit from that configuration, improving the overall maintenance and management of your Kerberos Enterprise agents.`}

\n

\"Factory

\n

{`Upgrade or reboot a Kerberos Enterprise agent`}

\n

{`At Kerberos.io we have fast development cycles, which means that new versions will be released every day, week or month. To make sure you can upgrade or downgrade your Kerberos Enterprise agent easily, an upgrade feature is built-in. When pressing the upgrade button, you will be able to select the version to which you would like to upgrade or downgrade. Once submitted, `}{`a zero downtime upgrade will take place`}{`. Kubernetes will download the new release, create a new pod, and destroy the old one.`}

\n

{`At any moment you can reboot your Kerberos Enterprise agent. When pressing the reboot button, next to your deployment, Kubernetes will destroy the pod of your deployment, and schedule a new one. This comes in handy, when you noticed one of your Kerberos Enterprise agents is in a stale state.`}

\n

\"Upgrade

\n

{`Pods`}

\n

{`When creating a Kerberos Enterprise agent, Kubernetes will create a deployment and schedule a pod. This pod will be managed by your deployment, and deployed as a Docker container to one of your available nodes. Once a pod dies/ crashes, or whatever unexpected scenario, the deployment will make sure it is deployed again to a different (or the same) node. This makes sure the Kerberos Enterprise agent is in a healthy state at all times.`}

\n

\"Factory\"

\n

{`Storage and video management`}

\n

{`Kerberos Enterprise allows you to scale your video landscape horizontally, using the concept of Kubernetes, and brings a strong backbone for stability and performance. It allows you to avoid reinventing the wheel, and get stuck in the numerious challenges of making an intelligent VMS yourself (we worked on this for 2 years with experienced engineers).`}

\n

{`Kerberos Enterprise stores its recordings locally for a short amount of time. This means that long-term storage is not included in the solution. On top of that it also `}{`does not`}{` have a visual component, which allows you te review dashboards or recordings. To overcome these two challenges, long-term storage with extensibility/integration capabilities and visualisation features, following solutions were developed `}{`Kerberos Storage`}{` and `}{`Kerberos Cloud`}{`.`}

\n

{`Kerberos Storage`}

\n

{`Kerberos Storage`}{` is a solution which makes it able to store recordings from Kerberos Enterprise agents (accross different clusters) at a central place, on the storage provider you want. You can store your recordings in the cloud (AWS S3, Google Cloud Storage, Azure Blob storage) or on premise (Minio).`}

\n

{`On the other hand it's an open platform, as it allows you build extensions and integrations (web apps, mobile apps, machine learning services much more). Kerberos Storage ships with the ability of real-time messaging (Kafka) and a REST API (documented as Swaggger).`}

\n

\"architecture

\n

{`To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the `}{`cloud`}{` tab. Once selected you need to fill-in the credentials from your Kerberos Storage account.`}

\n
    \n
  • \n

    {`Storage URI: this is the API endpoint of your Kerberos Storage instance. Typically this is in the following format: `}{`http(s)://api.yourdomain.com/storage. Where `}{`api.yourdomain.com\\` should match your Kerberos Storage API endpoint.`}

    \n
    • \n
  • \n

    {`Provider: the name of the provider, which you created on the Kerberos Storage providers page, to which you want to send your recordings to.`}

    \n
    • \n
  • \n

    {`Directory: this is the subdirectory in which your files will be stored. At the time of writing this should also equal your Kerberos Cloud username, if you plan to upload to Kerberos Cloud.`}

    \n
    • \n
  • \n

    {`Access Key: this should match the access key of one of your Kerberos Storage accounts.`}

    \n
    • \n
  • \n

    {`Secret Access Key: this should match the secret access key of one of your Kerberos Storage accounts.`}

    \n
    • \n
\n

\"kerberos

\n

{`Kerberos Cloud`}

\n

{`For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud is a web app, backed up with a number of microservices, that shows dashboards, live streams, filter recordings and much more. Learn more `}{`about the features and functions here`}{`.`}

\n

{`You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the `}{`Kerberos Storage page`}{`.`}

\n

{`Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription.`}

\n

\"kerberos

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-cc14880a7d4cb8b07a23cc5268d5ca37.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-cc14880a7d4cb8b07a23cc5268d5ca37.json new file mode 100644 index 0000000..d4b05a4 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-cc14880a7d4cb8b07a23cc5268d5ca37.json @@ -0,0 +1 @@ +{"expireTime":9007200861857174000,"key":"gatsby-plugin-mdx-entire-payload-1085a25c1a7479c79fb670b1497d6fc9-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":88,"offset":322},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"AWS","position":{"start":{"line":12,"column":90,"offset":324},"end":{"line":12,"column":93,"offset":327},"indent":[]}}],"position":{"start":{"line":12,"column":88,"offset":322},"end":{"line":12,"column":95,"offset":329},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":12,"column":95,"offset":329},"end":{"line":12,"column":97,"offset":331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"GCP","position":{"start":{"line":12,"column":99,"offset":333},"end":{"line":12,"column":102,"offset":336},"indent":[]}}],"position":{"start":{"line":12,"column":97,"offset":331},"end":{"line":12,"column":104,"offset":338},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":12,"column":104,"offset":338},"end":{"line":12,"column":108,"offset":342},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Azure","position":{"start":{"line":12,"column":110,"offset":344},"end":{"line":12,"column":115,"offset":349},"indent":[]}}],"position":{"start":{"line":12,"column":108,"offset":342},"end":{"line":12,"column":117,"offset":351},"indent":[]}},{"type":"text","value":"),\ncloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.","position":{"start":{"line":12,"column":117,"offset":351},"end":{"line":13,"column":90,"offset":443},"indent":[1]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":13,"column":90,"offset":443},"indent":[1]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":15,"column":1,"offset":445},"end":{"line":17,"column":11,"offset":647},"indent":[1,1]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":19,"column":3,"offset":651},"end":{"line":19,"column":15,"offset":663},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":649},"end":{"line":19,"column":15,"offset":663},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.","position":{"start":{"line":21,"column":1,"offset":665},"end":{"line":21,"column":323,"offset":987},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":665},"end":{"line":21,"column":323,"offset":987},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":23,"column":1,"offset":989},"end":{"line":25,"column":11,"offset":1191},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"First clone the configrations from our Github repo.","position":{"start":{"line":27,"column":1,"offset":1193},"end":{"line":27,"column":52,"offset":1244},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1193},"end":{"line":27,"column":52,"offset":1244},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/enterprise","position":{"start":{"line":29,"column":1,"offset":1246},"end":{"line":29,"column":56,"offset":1301},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next go into the directory and execute the first Kubernetes configuration file ","position":{"start":{"line":31,"column":1,"offset":1303},"end":{"line":31,"column":80,"offset":1382},"indent":[]}},{"type":"inlineCode","value":"clusterrole.yaml","position":{"start":{"line":31,"column":80,"offset":1382},"end":{"line":31,"column":98,"offset":1400},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":98,"offset":1400},"end":{"line":31,"column":99,"offset":1401},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1303},"end":{"line":31,"column":99,"offset":1401},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml","position":{"start":{"line":33,"column":1,"offset":1403},"end":{"line":33,"column":65,"offset":1467},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This will make several actions inside your cluster available. We need this to be able to create deployments from the factory web app.","position":{"start":{"line":35,"column":1,"offset":1469},"end":{"line":35,"column":134,"offset":1602},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1469},"end":{"line":35,"column":134,"offset":1602},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Helm","position":{"start":{"line":37,"column":4,"offset":1607},"end":{"line":37,"column":8,"offset":1611},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1604},"end":{"line":37,"column":8,"offset":1611},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next we will install a couple of dependencies which are required for Kerberos Enterprise. ","position":{"start":{"line":39,"column":1,"offset":1613},"end":{"line":39,"column":91,"offset":1703},"indent":[]}},{"type":"link","title":null,"url":"https://helm.sh/","children":[{"type":"strong","children":[{"type":"text","value":"Helm","position":{"start":{"line":39,"column":94,"offset":1706},"end":{"line":39,"column":98,"offset":1710},"indent":[]}}],"position":{"start":{"line":39,"column":92,"offset":1704},"end":{"line":39,"column":100,"offset":1712},"indent":[]}}],"position":{"start":{"line":39,"column":91,"offset":1703},"end":{"line":39,"column":119,"offset":1731},"indent":[]}},{"type":"text","value":" is a package manager for Kubernetes, it helps you setting up services more easily (this could be a MQTT broker, a database, etc).\nInstead of writing yaml files for every service we need, we use so called ","position":{"start":{"line":39,"column":119,"offset":1731},"end":{"line":40,"column":75,"offset":1936},"indent":[1]}},{"type":"strong","children":[{"type":"text","value":"Charts","position":{"start":{"line":40,"column":77,"offset":1938},"end":{"line":40,"column":83,"offset":1944},"indent":[]}}],"position":{"start":{"line":40,"column":75,"offset":1936},"end":{"line":40,"column":85,"offset":1946},"indent":[]}},{"type":"text","value":" (libraries), that you can reuse and configure the,\nwith the appropriate settings.","position":{"start":{"line":40,"column":85,"offset":1946},"end":{"line":41,"column":31,"offset":2028},"indent":[1]}}],"position":{"start":{"line":39,"column":1,"offset":1613},"end":{"line":41,"column":31,"offset":2028},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Use one of the preferred OS package managers to install the Helm client:","position":{"start":{"line":43,"column":1,"offset":2030},"end":{"line":43,"column":73,"offset":2102},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2030},"end":{"line":43,"column":73,"offset":2102},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"brew install helm\n\nchoco install kubernetes-helm\n\nscoop install helm\n\ngofish install helm","position":{"start":{"line":45,"column":1,"offset":2104},"end":{"line":51,"column":24,"offset":2209},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Traefik","position":{"start":{"line":53,"column":4,"offset":2214},"end":{"line":53,"column":11,"offset":2221},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2211},"end":{"line":53,"column":11,"offset":2221},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://containo.us/traefik/","children":[{"type":"strong","children":[{"type":"text","value":"Traefik","position":{"start":{"line":55,"column":4,"offset":2226},"end":{"line":55,"column":11,"offset":2233},"indent":[]}}],"position":{"start":{"line":55,"column":2,"offset":2224},"end":{"line":55,"column":13,"offset":2235},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2223},"end":{"line":55,"column":44,"offset":2266},"indent":[]}},{"type":"text","value":" is a reverse proxy and load balancer which allows you to expose your deployments more easily. Kerberos uses Traefik to expose it's APIs more easily.","position":{"start":{"line":55,"column":44,"offset":2266},"end":{"line":55,"column":193,"offset":2415},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2223},"end":{"line":55,"column":193,"offset":2415},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By executing following helm command, we will install traefik and link it to a specific DNS name. Open the traefik values file, ","position":{"start":{"line":57,"column":1,"offset":2417},"end":{"line":57,"column":128,"offset":2544},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/traefik/values.yaml","position":{"start":{"line":57,"column":128,"offset":2544},"end":{"line":57,"column":167,"offset":2583},"indent":[]}},{"type":"text","value":", and update the DNS name to your own domain.","position":{"start":{"line":57,"column":167,"offset":2583},"end":{"line":57,"column":212,"offset":2628},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2417},"end":{"line":57,"column":212,"offset":2628},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" dashboard:\n enabled: true\n--> domain: traefik.domain.com\n serviceType: NodePort\n rbac:\n enabled: true","position":{"start":{"line":59,"column":1,"offset":2630},"end":{"line":64,"column":26,"offset":2781},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Add Helm repository and install traefik.","position":{"start":{"line":66,"column":1,"offset":2783},"end":{"line":66,"column":41,"offset":2823},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":2783},"end":{"line":66,"column":41,"offset":2823},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add stable https://kubernetes-charts.storage.googleapis.com\nhelm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik","position":{"start":{"line":68,"column":1,"offset":2825},"end":{"line":69,"column":81,"offset":2979},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"After installation you should have an IP attached to traefik service, look for it by executing the ","position":{"start":{"line":71,"column":1,"offset":2981},"end":{"line":71,"column":100,"offset":3080},"indent":[]}},{"type":"inlineCode","value":"get service","position":{"start":{"line":71,"column":100,"offset":3080},"end":{"line":71,"column":113,"offset":3093},"indent":[]}},{"type":"text","value":" command. You will see the ip address in the ","position":{"start":{"line":71,"column":113,"offset":3093},"end":{"line":71,"column":158,"offset":3138},"indent":[]}},{"type":"inlineCode","value":"EXTERNAL-IP","position":{"start":{"line":71,"column":158,"offset":3138},"end":{"line":71,"column":171,"offset":3151},"indent":[]}},{"type":"text","value":" attribute.","position":{"start":{"line":71,"column":171,"offset":3151},"end":{"line":71,"column":182,"offset":3162},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":2981},"end":{"line":71,"column":182,"offset":3162},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl get svc\n\n NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE\n kubernetes ClusterIP 10.0.0.1 443/TCP 36h\n--> traefik LoadBalancer 10.0.27.93 40.114.168.96 443:31623/TCP,80:31804/TCP 35h\n traefik-dashboard NodePort 10.0.252.6 80:31146/TCP 35h","position":{"start":{"line":73,"column":1,"offset":3164},"end":{"line":78,"column":115,"offset":3644},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Go to your DNS provider and link the domain you've configured in the first step ","position":{"start":{"line":80,"column":1,"offset":3646},"end":{"line":80,"column":81,"offset":3726},"indent":[]}},{"type":"inlineCode","value":"traefik.domain.com","position":{"start":{"line":80,"column":81,"offset":3726},"end":{"line":80,"column":101,"offset":3746},"indent":[]}},{"type":"text","value":" to the IP address of the ","position":{"start":{"line":80,"column":101,"offset":3746},"end":{"line":80,"column":127,"offset":3772},"indent":[]}},{"type":"inlineCode","value":"EXTERNAL-IP","position":{"start":{"line":80,"column":127,"offset":3772},"end":{"line":80,"column":140,"offset":3785},"indent":[]}},{"type":"text","value":" attribute. When browsing to ","position":{"start":{"line":80,"column":140,"offset":3785},"end":{"line":80,"column":169,"offset":3814},"indent":[]}},{"type":"inlineCode","value":"traefik.domain.com","position":{"start":{"line":80,"column":169,"offset":3814},"end":{"line":80,"column":189,"offset":3834},"indent":[]}},{"type":"text","value":", you should see the traefik dashboard showing up.","position":{"start":{"line":80,"column":189,"offset":3834},"end":{"line":80,"column":239,"offset":3884},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":3646},"end":{"line":80,"column":239,"offset":3884},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Ingress-Nginx (optional, instead of Traefik)","position":{"start":{"line":82,"column":4,"offset":3889},"end":{"line":82,"column":48,"offset":3933},"indent":[]}}],"position":{"start":{"line":82,"column":1,"offset":3886},"end":{"line":82,"column":48,"offset":3933},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx\nhelm repo update\nhelm install ingress-nginx ingress-nginx/ingress-nginx","position":{"start":{"line":84,"column":1,"offset":3935},"end":{"line":86,"column":59,"offset":4089},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"MongoDB","position":{"start":{"line":88,"column":4,"offset":4094},"end":{"line":88,"column":11,"offset":4101},"indent":[]}}],"position":{"start":{"line":88,"column":1,"offset":4091},"end":{"line":88,"column":11,"offset":4101},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use ","position":{"start":{"line":90,"column":1,"offset":4103},"end":{"line":90,"column":192,"offset":4294},"indent":[]}},{"type":"inlineCode","value":"helm ","position":{"start":{"line":90,"column":192,"offset":4294},"end":{"line":90,"column":199,"offset":4301},"indent":[]}},{"type":"text","value":"to install a MongoDB instance inside your cluster.","position":{"start":{"line":90,"column":199,"offset":4301},"end":{"line":90,"column":249,"offset":4351},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4103},"end":{"line":90,"column":249,"offset":4351},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Have a look into the ","position":{"start":{"line":92,"column":1,"offset":4353},"end":{"line":92,"column":22,"offset":4374},"indent":[]}},{"type":"inlineCode","value":"yaml/mongodb/values.yaml","position":{"start":{"line":92,"column":22,"offset":4374},"end":{"line":92,"column":48,"offset":4400},"indent":[]}},{"type":"text","value":" file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb.","position":{"start":{"line":92,"column":48,"offset":4400},"end":{"line":92,"column":204,"offset":4556},"indent":[]}}],"position":{"start":{"line":92,"column":1,"offset":4353},"end":{"line":92,"column":204,"offset":4556},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values.yaml","position":{"start":{"line":94,"column":1,"offset":4558},"end":{"line":95,"column":88,"offset":4706},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.","position":{"start":{"line":97,"column":1,"offset":4708},"end":{"line":97,"column":170,"offset":4877},"indent":[]}}],"position":{"start":{"line":97,"column":1,"offset":4708},"end":{"line":97,"column":170,"offset":4877},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)\necho $MONGODB_ROOT_PASSWORD","position":{"start":{"line":99,"column":1,"offset":4879},"end":{"line":100,"column":32,"offset":5055},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Enterprise Web App - The Factory","position":{"start":{"line":102,"column":4,"offset":5060},"end":{"line":102,"column":45,"offset":5101},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":5057},"end":{"line":102,"column":45,"offset":5101},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the ","position":{"start":{"line":104,"column":1,"offset":5103},"end":{"line":104,"column":138,"offset":5240},"indent":[]}},{"type":"inlineCode","value":"Factory","position":{"start":{"line":104,"column":138,"offset":5240},"end":{"line":104,"column":147,"offset":5249},"indent":[]}},{"type":"text","value":". It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.","position":{"start":{"line":104,"column":147,"offset":5249},"end":{"line":104,"column":309,"offset":5411},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":5103},"end":{"line":104,"column":309,"offset":5411},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the ","position":{"start":{"line":106,"column":1,"offset":5413},"end":{"line":106,"column":289,"offset":5701},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":106,"column":289,"offset":5701},"end":{"line":106,"column":298,"offset":5710},"indent":[]}},{"type":"text","value":" command.","position":{"start":{"line":106,"column":298,"offset":5710},"end":{"line":106,"column":307,"offset":5719},"indent":[]}}],"position":{"start":{"line":106,"column":1,"offset":5413},"end":{"line":106,"column":307,"offset":5719},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing the Factory web app, open the ","position":{"start":{"line":108,"column":1,"offset":5721},"end":{"line":108,"column":49,"offset":5769},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":108,"column":49,"offset":5769},"end":{"line":108,"column":92,"offset":5812},"indent":[]}},{"type":"text","value":" configuration file. At the bottom file you will find two endpoints, similar to the traefik config file. Update the domain names to your own domain, and add these to your DNS server (pointing to the same IP as the traefik EXTERNAL-IP).","position":{"start":{"line":108,"column":92,"offset":5812},"end":{"line":108,"column":327,"offset":6047},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":5721},"end":{"line":108,"column":327,"offset":6047},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 80\n--> - host: api.factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 8081","position":{"start":{"line":110,"column":1,"offset":6049},"end":{"line":125,"column":36,"offset":6481},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":127,"column":1,"offset":6483},"end":{"line":127,"column":99,"offset":6581},"indent":[]}}],"position":{"start":{"line":127,"column":1,"offset":6483},"end":{"line":127,"column":99,"offset":6581},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":129,"column":1,"offset":6583},"end":{"line":132,"column":30,"offset":6702},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.","position":{"start":{"line":134,"column":1,"offset":6704},"end":{"line":134,"column":118,"offset":6821},"indent":[]}}],"position":{"start":{"line":134,"column":1,"offset":6704},"end":{"line":134,"column":118,"offset":6821},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":136,"column":1,"offset":6823},"end":{"line":136,"column":63,"offset":6885},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":138,"column":4,"offset":6890},"end":{"line":138,"column":26,"offset":6912},"indent":[]}}],"position":{"start":{"line":138,"column":1,"offset":6887},"end":{"line":138,"column":26,"offset":6912},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":140,"column":1,"offset":6914},"end":{"line":140,"column":94,"offset":7007},"indent":[]}}],"position":{"start":{"line":140,"column":1,"offset":6914},"end":{"line":140,"column":94,"offset":7007},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":142,"column":5,"offset":7013},"end":{"line":142,"column":12,"offset":7020},"indent":[]}}],"position":{"start":{"line":142,"column":5,"offset":7013},"end":{"line":142,"column":12,"offset":7020},"indent":[]}}],"position":{"start":{"line":142,"column":1,"offset":7009},"end":{"line":142,"column":12,"offset":7020},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":143,"column":5,"offset":7025},"end":{"line":143,"column":12,"offset":7032},"indent":[]}}],"position":{"start":{"line":143,"column":5,"offset":7025},"end":{"line":143,"column":12,"offset":7032},"indent":[]}}],"position":{"start":{"line":143,"column":1,"offset":7021},"end":{"line":143,"column":12,"offset":7032},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Factory","position":{"start":{"line":144,"column":5,"offset":7037},"end":{"line":144,"column":12,"offset":7044},"indent":[]}}],"position":{"start":{"line":144,"column":5,"offset":7037},"end":{"line":144,"column":12,"offset":7044},"indent":[]}}],"position":{"start":{"line":144,"column":1,"offset":7033},"end":{"line":144,"column":12,"offset":7044},"indent":[]}}],"position":{"start":{"line":142,"column":1,"offset":7009},"end":{"line":144,"column":12,"offset":7044},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":146,"column":1,"offset":7046},"end":{"line":146,"column":26,"offset":7071},"indent":[]}}],"position":{"start":{"line":146,"column":1,"offset":7046},"end":{"line":146,"column":26,"offset":7071},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nfactory-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-758d5c5ddd-qsfq9 1/1 Running 0 5m31s\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":148,"column":1,"offset":7073},"end":{"line":152,"column":73,"offset":7385},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":154,"column":4,"offset":7390},"end":{"line":154,"column":21,"offset":7407},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":7387},"end":{"line":154,"column":21,"offset":7407},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain ","position":{"start":{"line":156,"column":1,"offset":7409},"end":{"line":156,"column":152,"offset":7560},"indent":[]}},{"type":"inlineCode","value":"factory.domain.com","position":{"start":{"line":156,"column":152,"offset":7560},"end":{"line":156,"column":172,"offset":7580},"indent":[]}},{"type":"text","value":" in your browser you will see the Factory login page showing up.","position":{"start":{"line":156,"column":172,"offset":7580},"end":{"line":156,"column":236,"offset":7644},"indent":[]}}],"position":{"start":{"line":156,"column":1,"offset":7409},"end":{"line":156,"column":236,"offset":7644},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Factory","position":{"start":{"line":158,"column":1,"offset":7646},"end":{"line":158,"column":71,"offset":7716},"indent":[]}}],"position":{"start":{"line":158,"column":1,"offset":7646},"end":{"line":158,"column":71,"offset":7716},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":161,"column":1,"offset":7719},"end":{"line":161,"column":31,"offset":7749},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":161,"column":31,"offset":7749}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Introduction`}

\n

{`Start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (`}{`AWS`}{`, `}{`GCP`}{` or `}{`Azure`}{`),\ncloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.`}

\n
\n
\n

\n

{`Installation`}

\n

{`Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.`}

\n
\n
\n

\n

{`First clone the configrations from our Github repo.`}

\n 
{`git clone https://github.com/kerberos-io/enterprise`}
\n

{`Next go into the directory and execute the first Kubernetes configuration file `}{`clusterrole.yaml`}{`.`}

\n 
{`kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml`}
\n

{`This will make several actions inside your cluster available. We need this to be able to create deployments from the factory web app.`}

\n

{`Helm`}

\n

{`Next we will install a couple of dependencies which are required for Kerberos Enterprise. `}{`Helm`}{` is a package manager for Kubernetes, it helps you setting up services more easily (this could be a MQTT broker, a database, etc).\nInstead of writing yaml files for every service we need, we use so called `}{`Charts`}{` (libraries), that you can reuse and configure the,\nwith the appropriate settings.`}

\n

{`Use one of the preferred OS package managers to install the Helm client:`}

\n 
{`brew install helm`}{`\n`}{`\n`}{`choco install kubernetes-helm`}{`\n`}{`\n`}{`scoop install helm`}{`\n`}{`\n`}{`gofish install helm`}
\n

{`Traefik`}

\n

{`Traefik`}{` is a reverse proxy and load balancer which allows you to expose your deployments more easily. Kerberos uses Traefik to expose it's APIs more easily.`}

\n

{`By executing following helm command, we will install traefik and link it to a specific DNS name. Open the traefik values file, `}{`./enterprise/yaml/traefik/values.yaml`}{`, and update the DNS name to your own domain.`}

\n 
{`    dashboard:`}{`\n`}{`      enabled: true`}{`\n`}{`-->   domain: traefik.domain.com`}{`\n`}{`      serviceType: NodePort`}{`\n`}{`    rbac:`}{`\n`}{`        enabled: true`}
\n

{`Add Helm repository and install traefik.`}

\n 
{`helm repo add stable https://kubernetes-charts.storage.googleapis.com`}{`\n`}{`helm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik`}
\n

{`After installation you should have an IP attached to traefik service, look for it by executing the `}{`get service`}{` command. You will see the ip address in the `}{`EXTERNAL-IP`}{` attribute.`}

\n 
{`kubectl get svc`}{`\n`}{`\n`}{`    NAME                        TYPE           CLUSTER-IP     EXTERNAL-IP     PORT(S)                      AGE`}{`\n`}{`    kubernetes                  ClusterIP      10.0.0.1                 443/TCP                      36h`}{`\n`}{`--> traefik                     LoadBalancer   10.0.27.93     40.114.168.96   443:31623/TCP,80:31804/TCP   35h`}{`\n`}{`    traefik-dashboard           NodePort       10.0.252.6               80:31146/TCP                 35h`}
\n

{`Go to your DNS provider and link the domain you've configured in the first step `}{`traefik.domain.com`}{` to the IP address of the `}{`EXTERNAL-IP`}{` attribute. When browsing to `}{`traefik.domain.com`}{`, you should see the traefik dashboard showing up.`}

\n

{`Ingress-Nginx (optional, instead of Traefik)`}

\n 
{`helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx`}{`\n`}{`helm repo update`}{`\n`}{`helm install ingress-nginx ingress-nginx/ingress-nginx`}
\n

{`MongoDB`}

\n

{`When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use `}{`helm `}{`to install a MongoDB instance inside your cluster.`}

\n

{`Have a look into the `}{`yaml/mongodb/values.yaml`}{` file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb.`}

\n 
{`helm repo add bitnami https://charts.bitnami.com/bitnami`}{`\n`}{`helm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values.yaml`}
\n

{`Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.`}

\n 
{`export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)`}{`\n`}{`echo $MONGODB_ROOT_PASSWORD`}
\n

{`Kerberos Enterprise Web App - The Factory`}

\n

{`The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the `}{`Factory`}{`. It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.`}

\n

{`The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the `}{`kubectl`}{` command.`}

\n

{`Before installing the Factory web app, open the `}{`./enterprise/yaml/factory/deployment.yaml`}{` configuration file. At the bottom file you will find two endpoints, similar to the traefik config file. Update the domain names to your own domain, and add these to your DNS server (pointing to the same IP as the traefik EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 8081`}
\n

{`Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.`}

\n 
{`kubectl apply -f ./enterprise/yaml/factory/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Factory`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`factory-6f5c877d7c-hf77p          1/1     Running   0          2d11h`}{`\n`}{`mongodb-758d5c5ddd-qsfq9          1/1     Running   0          5m31s`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain `}{`factory.domain.com`}{` in your browser you will see the Factory login page showing up.`}

\n

\"Factory\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-cfc94c97379ad232f2f5eb1312d54073.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-cfc94c97379ad232f2f5eb1312d54073.json new file mode 100644 index 0000000..5be63c4 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-cfc94c97379ad232f2f5eb1312d54073.json @@ -0,0 +1 @@ +{"expireTime":9007200861829328000,"key":"gatsby-plugin-mdx-entire-payload-4bad6d34fc9808a5c597191c5b824547-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"list","ordered":true,"start":1,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":77,"offset":412},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":78,"offset":413},"end":{"line":12,"column":92,"offset":427},"indent":[]}}],"position":{"start":{"line":12,"column":77,"offset":412},"end":{"line":12,"column":101,"offset":436},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers.","position":{"start":{"line":12,"column":101,"offset":436},"end":{"line":12,"column":166,"offset":501},"indent":[]}}],"position":{"start":{"line":12,"column":4,"offset":339},"end":{"line":12,"column":166,"offset":501},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":166,"offset":501},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and be consumed by Kerberos Cloud in parrallel. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":13,"column":4,"offset":505},"end":{"line":13,"column":625,"offset":1126},"indent":[]}}],"position":{"start":{"line":13,"column":4,"offset":505},"end":{"line":13,"column":625,"offset":1126},"indent":[]}}],"position":{"start":{"line":13,"column":1,"offset":502},"end":{"line":13,"column":625,"offset":1126},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":13,"column":625,"offset":1126},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":15,"column":4,"offset":1131},"end":{"line":15,"column":18,"offset":1145},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":1128},"end":{"line":15,"column":18,"offset":1145},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":17,"column":1,"offset":1147},"end":{"line":17,"column":291,"offset":1437},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":17,"column":292,"offset":1438},"end":{"line":17,"column":309,"offset":1455},"indent":[]}}],"position":{"start":{"line":17,"column":291,"offset":1437},"end":{"line":17,"column":318,"offset":1464},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":17,"column":318,"offset":1464},"end":{"line":17,"column":319,"offset":1465},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":1147},"end":{"line":17,"column":319,"offset":1465},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":19,"column":1,"offset":1467},"end":{"line":19,"column":56,"offset":1522},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":1467},"end":{"line":19,"column":56,"offset":1522},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":21,"column":4,"offset":1527},"end":{"line":21,"column":20,"offset":1543},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":1524},"end":{"line":21,"column":20,"offset":1543},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":23,"column":1,"offset":1545},"end":{"line":23,"column":253,"offset":1797},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1545},"end":{"line":23,"column":253,"offset":1797},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":25,"column":6,"offset":1804},"end":{"line":25,"column":35,"offset":1833},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1803},"end":{"line":25,"column":70,"offset":1868},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1803},"end":{"line":25,"column":70,"offset":1868},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1799},"end":{"line":25,"column":70,"offset":1868},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":26,"column":6,"offset":1874},"end":{"line":26,"column":29,"offset":1897},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1873},"end":{"line":26,"column":83,"offset":1951},"indent":[]}}],"position":{"start":{"line":26,"column":5,"offset":1873},"end":{"line":26,"column":83,"offset":1951},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1869},"end":{"line":26,"column":83,"offset":1951},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":27,"column":6,"offset":1957},"end":{"line":27,"column":28,"offset":1979},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1956},"end":{"line":27,"column":57,"offset":2008},"indent":[]}}],"position":{"start":{"line":27,"column":5,"offset":1956},"end":{"line":27,"column":57,"offset":2008},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1952},"end":{"line":27,"column":57,"offset":2008},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":28,"column":6,"offset":2014},"end":{"line":28,"column":11,"offset":2019},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":2013},"end":{"line":28,"column":29,"offset":2037},"indent":[]}}],"position":{"start":{"line":28,"column":5,"offset":2013},"end":{"line":28,"column":29,"offset":2037},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":2009},"end":{"line":28,"column":29,"offset":2037},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1799},"end":{"line":28,"column":29,"offset":2037},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":30,"column":1,"offset":2039},"end":{"line":30,"column":190,"offset":2228},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2039},"end":{"line":30,"column":190,"offset":2228},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":32,"column":1,"offset":2230},"end":{"line":32,"column":99,"offset":2328},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2230},"end":{"line":32,"column":99,"offset":2328},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":34,"column":1,"offset":2330},"end":{"line":34,"column":220,"offset":2549},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2330},"end":{"line":34,"column":220,"offset":2549},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":36,"column":1,"offset":2551},"end":{"line":36,"column":98,"offset":2648},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2551},"end":{"line":36,"column":98,"offset":2648},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":38,"column":5,"offset":2654},"end":{"line":38,"column":11,"offset":2660},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2650},"end":{"line":38,"column":11,"offset":2660},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":40,"column":1,"offset":2662},"end":{"line":40,"column":303,"offset":2964},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2662},"end":{"line":40,"column":303,"offset":2964},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":42,"column":6,"offset":2971},"end":{"line":42,"column":18,"offset":2983},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2970},"end":{"line":42,"column":46,"offset":3011},"indent":[]}}],"position":{"start":{"line":42,"column":5,"offset":2970},"end":{"line":42,"column":46,"offset":3011},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2966},"end":{"line":42,"column":46,"offset":3011},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":43,"column":6,"offset":3017},"end":{"line":43,"column":29,"offset":3040},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":3016},"end":{"line":43,"column":59,"offset":3070},"indent":[]}}],"position":{"start":{"line":43,"column":5,"offset":3016},"end":{"line":43,"column":59,"offset":3070},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":3012},"end":{"line":43,"column":59,"offset":3070},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2966},"end":{"line":43,"column":59,"offset":3070},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":45,"column":1,"offset":3072},"end":{"line":45,"column":368,"offset":3439},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":3072},"end":{"line":45,"column":368,"offset":3439},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":47,"column":1,"offset":3441},"end":{"line":47,"column":66,"offset":3506},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3441},"end":{"line":47,"column":66,"offset":3506},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":49,"column":5,"offset":3512},"end":{"line":49,"column":21,"offset":3528},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3508},"end":{"line":49,"column":21,"offset":3528},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":51,"column":1,"offset":3530},"end":{"line":51,"column":237,"offset":3766},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":3530},"end":{"line":51,"column":237,"offset":3766},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":53,"column":1,"offset":3768},"end":{"line":53,"column":105,"offset":3872},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":3768},"end":{"line":53,"column":105,"offset":3872},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":55,"column":1,"offset":3874},"end":{"line":55,"column":45,"offset":3918},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":3874},"end":{"line":55,"column":45,"offset":3918},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":57,"column":3,"offset":3922},"end":{"line":57,"column":380,"offset":4299},"indent":[]}}],"position":{"start":{"line":57,"column":3,"offset":3922},"end":{"line":57,"column":380,"offset":4299},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":3920},"end":{"line":58,"column":1,"offset":4300},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":59,"column":3,"offset":4303},"end":{"line":60,"column":49,"offset":4617},"indent":[2]}}],"position":{"start":{"line":59,"column":3,"offset":4303},"end":{"line":60,"column":49,"offset":4617},"indent":[2]}}],"position":{"start":{"line":59,"column":1,"offset":4301},"end":{"line":60,"column":49,"offset":4617},"indent":[1]}}],"position":{"start":{"line":57,"column":1,"offset":3920},"end":{"line":60,"column":49,"offset":4617},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":62,"column":5,"offset":4623},"end":{"line":62,"column":13,"offset":4631},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4619},"end":{"line":62,"column":13,"offset":4631},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":64,"column":1,"offset":4633},"end":{"line":64,"column":156,"offset":4788},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":64,"column":156,"offset":4788},"end":{"line":64,"column":177,"offset":4809},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":64,"column":177,"offset":4809},"end":{"line":64,"column":188,"offset":4820},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":64,"column":188,"offset":4820},"end":{"line":64,"column":193,"offset":4825},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":64,"column":193,"offset":4825},"end":{"line":64,"column":379,"offset":5011},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4633},"end":{"line":64,"column":379,"offset":5011},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":66,"column":1,"offset":5013},"end":{"line":66,"column":68,"offset":5080},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":5013},"end":{"line":66,"column":68,"offset":5080},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":68,"column":4,"offset":5085},"end":{"line":68,"column":13,"offset":5094},"indent":[]}}],"position":{"start":{"line":68,"column":1,"offset":5082},"end":{"line":68,"column":13,"offset":5094},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":70,"column":1,"offset":5096},"end":{"line":70,"column":44,"offset":5139},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":70,"column":46,"offset":5141},"end":{"line":70,"column":68,"offset":5163},"indent":[]}}],"position":{"start":{"line":70,"column":44,"offset":5139},"end":{"line":70,"column":70,"offset":5165},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":70,"column":70,"offset":5165},"end":{"line":70,"column":106,"offset":5201},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":70,"column":108,"offset":5203},"end":{"line":70,"column":129,"offset":5224},"indent":[]}}],"position":{"start":{"line":70,"column":106,"offset":5201},"end":{"line":70,"column":131,"offset":5226},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":70,"column":131,"offset":5226},"end":{"line":70,"column":159,"offset":5254},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":5096},"end":{"line":70,"column":159,"offset":5254},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":73,"column":1,"offset":5257},"end":{"line":73,"column":31,"offset":5287},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":73,"column":31,"offset":5287}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n
    \n
  1. {`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers.`}
    2. \n
  2. {`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and be consumed by Kerberos Cloud in parrallel. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}
    3. \n
\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-d3dd2181e5ba4853c802ea90214236d0.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-d3dd2181e5ba4853c802ea90214236d0.json index 94373db..0cd72aa 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-d3dd2181e5ba4853c802ea90214236d0.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-d3dd2181e5ba4853c802ea90214236d0.json @@ -1 +1 @@ -{"expireTime":9007200861747672000,"key":"gatsby-plugin-mdx-entire-payload-c9c72f0130dd78f8efd67e980b7d80b5-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"How it works","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":15,"offset":173},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":15,"offset":173},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When you install Kerberos Open Source or Kerberos Enterprise we will refer to it as the Kerberos Agent. A Kerberos Agent, is a software solution that consist of two pieces: Front-End and Back-End. The Back-End processes the video stream of a single surveillance camera, makes recordings and takes actions (for example sending notifications). The Front-End allows you to review recordings, and configure the Back-End.","position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":417,"offset":591},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":417,"offset":591},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent-structure.png","alt":"architecture kerberos agent","position":{"start":{"line":12,"column":1,"offset":593},"end":{"line":12,"column":78,"offset":670},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":593},"end":{"line":12,"column":78,"offset":670},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Front-End","position":{"start":{"line":14,"column":5,"offset":676},"end":{"line":14,"column":14,"offset":685},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":672},"end":{"line":14,"column":14,"offset":685},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Kerberos Agent ships with a web interface (Front-End) and a video processing engine (Back-End). The Front-End allows the user to modify specific settings, and if Kerberos Open Source, watch recordings in a easy-to-use interface; The Front-End for ","position":{"start":{"line":15,"column":1,"offset":686},"end":{"line":15,"column":252,"offset":937},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":15,"column":253,"offset":938},"end":{"line":15,"column":272,"offset":957},"indent":[]}}],"position":{"start":{"line":15,"column":252,"offset":937},"end":{"line":15,"column":299,"offset":984},"indent":[]}},{"type":"text","value":" is only for configuration purposes only.","position":{"start":{"line":15,"column":299,"offset":984},"end":{"line":15,"column":340,"offset":1025},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":686},"end":{"line":15,"column":340,"offset":1025},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Back-End","position":{"start":{"line":17,"column":5,"offset":1031},"end":{"line":17,"column":13,"offset":1039},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":1027},"end":{"line":17,"column":13,"offset":1039},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Back-End piece of the Kerberos Agent is a service that processes the camera feed with computer vision algorithms to detect motion, and makes recordings and/or execute specific actions. Kerberos Enterprise supports any type of IP-camera (RTSP/ONVIF), and Kerberos Open Source also adds support for USB (V4L2) and the popular Raspberry Pi camera.","position":{"start":{"line":18,"column":1,"offset":1040},"end":{"line":18,"column":349,"offset":1388},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1040},"end":{"line":18,"column":349,"offset":1388},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Depending on which Kerberos Agent, Kerberos Open Source or Kerberos Enterprise, you will have different installation methods. If you would like to learn more about the Kerberos Agent, have a look in the related sections: ","position":{"start":{"line":20,"column":1,"offset":1390},"end":{"line":20,"column":222,"offset":1611},"indent":[]}},{"type":"link","title":null,"url":"/opensource/introduction","children":[{"type":"text","value":"Open Source","position":{"start":{"line":20,"column":223,"offset":1612},"end":{"line":20,"column":234,"offset":1623},"indent":[]}}],"position":{"start":{"line":20,"column":222,"offset":1611},"end":{"line":20,"column":261,"offset":1650},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":20,"column":261,"offset":1650},"end":{"line":20,"column":263,"offset":1652},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Enterprise","position":{"start":{"line":20,"column":264,"offset":1653},"end":{"line":20,"column":274,"offset":1663},"indent":[]}}],"position":{"start":{"line":20,"column":263,"offset":1652},"end":{"line":20,"column":301,"offset":1690},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":20,"column":301,"offset":1690},"end":{"line":20,"column":302,"offset":1691},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1390},"end":{"line":20,"column":302,"offset":1691},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Open Source vs Enterprise","position":{"start":{"line":22,"column":4,"offset":1696},"end":{"line":22,"column":29,"offset":1721},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1693},"end":{"line":22,"column":29,"offset":1721},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Kerberos project started as an Open Source project, with a main focus on low-cost devices such as the Raspberry Pi. Later on the Open Source version was bundled inside the Docker technology so that it was easier to distribute. Anyone can use the Open Source version for personal usage.","position":{"start":{"line":24,"column":1,"offset":1723},"end":{"line":24,"column":290,"offset":2012},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1723},"end":{"line":24,"column":290,"offset":2012},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Enterprises are more demanding, and have a lot of surveillance cameras, therefore they need a scalable surveillance system. The ","position":{"start":{"line":26,"column":1,"offset":2014},"end":{"line":26,"column":129,"offset":2142},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Enterprise edition","position":{"start":{"line":26,"column":130,"offset":2143},"end":{"line":26,"column":148,"offset":2161},"indent":[]}}],"position":{"start":{"line":26,"column":129,"offset":2142},"end":{"line":26,"column":175,"offset":2188},"indent":[]}},{"type":"text","value":" of Kerberos allows you to operate a video surveillance cluster (Kubernetes) on-premise or in the cloud (AWS/GCP/Azure).","position":{"start":{"line":26,"column":175,"offset":2188},"end":{"line":26,"column":295,"offset":2308},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":2014},"end":{"line":26,"column":295,"offset":2308},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent.png","alt":"kerberos agent oss enterprise","position":{"start":{"line":28,"column":1,"offset":2310},"end":{"line":28,"column":70,"offset":2379},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":2310},"end":{"line":28,"column":70,"offset":2379},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Open Source and Enterprise edition are significantly different from a source code point of view. The ","position":{"start":{"line":30,"column":1,"offset":2381},"end":{"line":30,"column":106,"offset":2486},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Enterprise edition","position":{"start":{"line":30,"column":107,"offset":2487},"end":{"line":30,"column":125,"offset":2505},"indent":[]}}],"position":{"start":{"line":30,"column":106,"offset":2486},"end":{"line":30,"column":152,"offset":2532},"indent":[]}},{"type":"text","value":" is a complete rewrite of the Open Source version, and got all the best practices we discovered over the years implemented. Both version are and will remain updated in the future.","position":{"start":{"line":30,"column":152,"offset":2532},"end":{"line":30,"column":331,"offset":2711},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2381},"end":{"line":30,"column":331,"offset":2711},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage","position":{"start":{"line":32,"column":4,"offset":2716},"end":{"line":32,"column":11,"offset":2723},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2713},"end":{"line":32,"column":11,"offset":2723},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Users or Enteprises which only have a few surveillance cameras to manage, probably will be fine with Kerberos Open Source. On top of that they might include ","position":{"start":{"line":34,"column":1,"offset":2725},"end":{"line":34,"column":158,"offset":2882},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":34,"column":159,"offset":2883},"end":{"line":34,"column":173,"offset":2897},"indent":[]}}],"position":{"start":{"line":34,"column":158,"offset":2882},"end":{"line":34,"column":182,"offset":2906},"indent":[]}},{"type":"text","value":" for remote access and monitoring.","position":{"start":{"line":34,"column":182,"offset":2906},"end":{"line":34,"column":216,"offset":2940},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2725},"end":{"line":34,"column":216,"offset":2940},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand if you plan to manage a larger network of surveillance cameras, you will have to look into ","position":{"start":{"line":36,"column":1,"offset":2942},"end":{"line":36,"column":110,"offset":3051},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":36,"column":111,"offset":3052},"end":{"line":36,"column":130,"offset":3071},"indent":[]}}],"position":{"start":{"line":36,"column":110,"offset":3051},"end":{"line":36,"column":157,"offset":3098},"indent":[]}},{"type":"text","value":". Backed up with Kubernetes, Kerberos Enterprise, will give you the real super powers to your scale surveillance camera landscape. Kerberos Enterprise comes with a Front-End to manage and scale your deployments inside a Kubernetes Cluster.","position":{"start":{"line":36,"column":157,"offset":3098},"end":{"line":36,"column":396,"offset":3337},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2942},"end":{"line":36,"column":396,"offset":3337},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":38,"column":2,"offset":3340},"end":{"line":38,"column":21,"offset":3359},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":3339},"end":{"line":38,"column":48,"offset":3386},"indent":[]}},{"type":"text","value":" leverages a service called, ","position":{"start":{"line":38,"column":48,"offset":3386},"end":{"line":38,"column":77,"offset":3415},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":38,"column":78,"offset":3416},"end":{"line":38,"column":94,"offset":3432},"indent":[]}}],"position":{"start":{"line":38,"column":77,"offset":3415},"end":{"line":38,"column":118,"offset":3456},"indent":[]}},{"type":"text","value":", for central and hybrid storage. Kerberos Storage implements the concept of BYOC (Bring Your Own Cloud). By selecting a cloud provider (AWS, GCP, AZURE) or on-premise (Minio) you can bring your recordings where you them to be.","position":{"start":{"line":38,"column":118,"offset":3456},"end":{"line":38,"column":345,"offset":3683},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":3339},"end":{"line":38,"column":345,"offset":3683},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to the concept of BYOC, Kerberos Storage enables you to connect to Kerberos Cloud (with your own storage), send events to message brokers (such as Kafka or SQS) and enables you to build custom apps or services (such as a custom machine learning service).","position":{"start":{"line":40,"column":1,"offset":3685},"end":{"line":40,"column":267,"offset":3951},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":3685},"end":{"line":40,"column":267,"offset":3951},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-storage.png","alt":"Architecture Storage","position":{"start":{"line":42,"column":1,"offset":3953},"end":{"line":42,"column":63,"offset":4015},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":3953},"end":{"line":42,"column":63,"offset":4015},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud","position":{"start":{"line":44,"column":4,"offset":4020},"end":{"line":44,"column":9,"offset":4025},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":4017},"end":{"line":44,"column":9,"offset":4025},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When installing a Kerberos Agent inside your local network, it's possible to review your activity by using the agent its web interface. By all network principles, having a local setup, you will not be able to access the web interface from the cloud (outside your local network). On top of that, the Kerberos Agent doesn't come with a consolidated overview. This means that you will need to open multiple web interfaces, one for each connected surveillance camera. To simplify and resolve all of these challenges, ","position":{"start":{"line":46,"column":1,"offset":4027},"end":{"line":46,"column":514,"offset":4540},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":46,"column":515,"offset":4541},"end":{"line":46,"column":529,"offset":4555},"indent":[]}}],"position":{"start":{"line":46,"column":514,"offset":4540},"end":{"line":46,"column":538,"offset":4564},"indent":[]}},{"type":"text","value":" was developed.","position":{"start":{"line":46,"column":538,"offset":4564},"end":{"line":46,"column":553,"offset":4579},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":4027},"end":{"line":46,"column":553,"offset":4579},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":48,"column":1,"offset":4581},"end":{"line":48,"column":53,"offset":4633},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":4581},"end":{"line":48,"column":53,"offset":4633},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":51,"column":1,"offset":4636},"end":{"line":51,"column":31,"offset":4666},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":51,"column":31,"offset":4666}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`How it works`}

\n

{`When you install Kerberos Open Source or Kerberos Enterprise we will refer to it as the Kerberos Agent. A Kerberos Agent, is a software solution that consist of two pieces: Front-End and Back-End. The Back-End processes the video stream of a single surveillance camera, makes recordings and takes actions (for example sending notifications). The Front-End allows you to review recordings, and configure the Back-End.`}

\n

\"architecture

\n

{`Front-End`}

\n

{`The Kerberos Agent ships with a web interface (Front-End) and a video processing engine (Back-End). The Front-End allows the user to modify specific settings, and if Kerberos Open Source, watch recordings in a easy-to-use interface; The Front-End for `}{`Kerberos Enterprise`}{` is only for configuration purposes only.`}

\n

{`Back-End`}

\n

{`The Back-End piece of the Kerberos Agent is a service that processes the camera feed with computer vision algorithms to detect motion, and makes recordings and/or execute specific actions. Kerberos Enterprise supports any type of IP-camera (RTSP/ONVIF), and Kerberos Open Source also adds support for USB (V4L2) and the popular Raspberry Pi camera.`}

\n

{`Depending on which Kerberos Agent, Kerberos Open Source or Kerberos Enterprise, you will have different installation methods. If you would like to learn more about the Kerberos Agent, have a look in the related sections: `}{`Open Source`}{`, `}{`Enterprise`}{`.`}

\n

{`Open Source vs Enterprise`}

\n

{`The Kerberos project started as an Open Source project, with a main focus on low-cost devices such as the Raspberry Pi. Later on the Open Source version was bundled inside the Docker technology so that it was easier to distribute. Anyone can use the Open Source version for personal usage.`}

\n

{`Enterprises are more demanding, and have a lot of surveillance cameras, therefore they need a scalable surveillance system. The `}{`Enterprise edition`}{` of Kerberos allows you to operate a video surveillance cluster (Kubernetes) on-premise or in the cloud (AWS/GCP/Azure).`}

\n

\"kerberos

\n

{`The Open Source and Enterprise edition are significantly different from a source code point of view. The `}{`Enterprise edition`}{` is a complete rewrite of the Open Source version, and got all the best practices we discovered over the years implemented. Both version are and will remain updated in the future.`}

\n

{`Storage`}

\n

{`Users or Enteprises which only have a few surveillance cameras to manage, probably will be fine with Kerberos Open Source. On top of that they might include `}{`Kerberos Cloud`}{` for remote access and monitoring.`}

\n

{`On the other hand if you plan to manage a larger network of surveillance cameras, you will have to look into `}{`Kerberos Enterprise`}{`. Backed up with Kubernetes, Kerberos Enterprise, will give you the real super powers to your scale surveillance camera landscape. Kerberos Enterprise comes with a Front-End to manage and scale your deployments inside a Kubernetes Cluster.`}

\n

{`Kerberos Enterprise`}{` leverages a service called, `}{`Kerberos Storage`}{`, for central and hybrid storage. Kerberos Storage implements the concept of BYOC (Bring Your Own Cloud). By selecting a cloud provider (AWS, GCP, AZURE) or on-premise (Minio) you can bring your recordings where you them to be.`}

\n

{`In addition to the concept of BYOC, Kerberos Storage enables you to connect to Kerberos Cloud (with your own storage), send events to message brokers (such as Kafka or SQS) and enables you to build custom apps or services (such as a custom machine learning service).`}

\n

\"Architecture

\n

{`Cloud`}

\n

{`When installing a Kerberos Agent inside your local network, it's possible to review your activity by using the agent its web interface. By all network principles, having a local setup, you will not be able to access the web interface from the cloud (outside your local network). On top of that, the Kerberos Agent doesn't come with a consolidated overview. This means that you will need to open multiple web interfaces, one for each connected surveillance camera. To simplify and resolve all of these challenges, `}{`Kerberos Cloud`}{` was developed.`}

\n

\"cloud\"

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750176000,"key":"gatsby-plugin-mdx-entire-payload-c9c72f0130dd78f8efd67e980b7d80b5-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"How it works","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":15,"offset":173},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":15,"offset":173},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When you install Kerberos Open Source or Kerberos Enterprise we will refer to it as the Kerberos Agent. A Kerberos Agent, is a software solution that consist of two pieces: Front-End and Back-End. The Back-End processes the video stream of a single surveillance camera, makes recordings and takes actions (for example sending notifications). The Front-End allows you to review recordings, and configure the Back-End.","position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":417,"offset":591},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":175},"end":{"line":10,"column":417,"offset":591},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent-structure.png","alt":"architecture kerberos agent","position":{"start":{"line":12,"column":1,"offset":593},"end":{"line":12,"column":78,"offset":670},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":593},"end":{"line":12,"column":78,"offset":670},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Front-End","position":{"start":{"line":14,"column":5,"offset":676},"end":{"line":14,"column":14,"offset":685},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":672},"end":{"line":14,"column":14,"offset":685},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Kerberos Agent ships with a web interface (Front-End) and a video processing engine (Back-End). The Front-End allows the user to modify specific settings, and if Kerberos Open Source, watch recordings in a easy-to-use interface; The Front-End for ","position":{"start":{"line":15,"column":1,"offset":686},"end":{"line":15,"column":252,"offset":937},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":15,"column":253,"offset":938},"end":{"line":15,"column":272,"offset":957},"indent":[]}}],"position":{"start":{"line":15,"column":252,"offset":937},"end":{"line":15,"column":299,"offset":984},"indent":[]}},{"type":"text","value":" is only for configuration purposes only.","position":{"start":{"line":15,"column":299,"offset":984},"end":{"line":15,"column":340,"offset":1025},"indent":[]}}],"position":{"start":{"line":15,"column":1,"offset":686},"end":{"line":15,"column":340,"offset":1025},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Back-End","position":{"start":{"line":17,"column":5,"offset":1031},"end":{"line":17,"column":13,"offset":1039},"indent":[]}}],"position":{"start":{"line":17,"column":1,"offset":1027},"end":{"line":17,"column":13,"offset":1039},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Back-End piece of the Kerberos Agent is a service that processes the camera feed with computer vision algorithms to detect motion, and makes recordings and/or execute specific actions. Kerberos Enterprise supports any type of IP-camera (RTSP/ONVIF), and Kerberos Open Source also adds support for USB (V4L2) and the popular Raspberry Pi camera.","position":{"start":{"line":18,"column":1,"offset":1040},"end":{"line":18,"column":349,"offset":1388},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1040},"end":{"line":18,"column":349,"offset":1388},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Depending on which Kerberos Agent, Kerberos Open Source or Kerberos Enterprise, you will have different installation methods. If you would like to learn more about the Kerberos Agent, have a look in the related sections: ","position":{"start":{"line":20,"column":1,"offset":1390},"end":{"line":20,"column":222,"offset":1611},"indent":[]}},{"type":"link","title":null,"url":"/opensource/introduction","children":[{"type":"text","value":"Open Source","position":{"start":{"line":20,"column":223,"offset":1612},"end":{"line":20,"column":234,"offset":1623},"indent":[]}}],"position":{"start":{"line":20,"column":222,"offset":1611},"end":{"line":20,"column":261,"offset":1650},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":20,"column":261,"offset":1650},"end":{"line":20,"column":263,"offset":1652},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Enterprise","position":{"start":{"line":20,"column":264,"offset":1653},"end":{"line":20,"column":274,"offset":1663},"indent":[]}}],"position":{"start":{"line":20,"column":263,"offset":1652},"end":{"line":20,"column":301,"offset":1690},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":20,"column":301,"offset":1690},"end":{"line":20,"column":302,"offset":1691},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1390},"end":{"line":20,"column":302,"offset":1691},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Open Source vs Enterprise","position":{"start":{"line":22,"column":4,"offset":1696},"end":{"line":22,"column":29,"offset":1721},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1693},"end":{"line":22,"column":29,"offset":1721},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Kerberos project started as an Open Source project, with a main focus on low-cost devices such as the Raspberry Pi. Later on the Open Source version was bundled inside the Docker technology so that it was easier to distribute. Anyone can use the Open Source version for personal usage.","position":{"start":{"line":24,"column":1,"offset":1723},"end":{"line":24,"column":290,"offset":2012},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1723},"end":{"line":24,"column":290,"offset":2012},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Enterprises are more demanding, and have a lot of surveillance cameras, therefore they need a scalable surveillance system. The ","position":{"start":{"line":26,"column":1,"offset":2014},"end":{"line":26,"column":129,"offset":2142},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Enterprise edition","position":{"start":{"line":26,"column":130,"offset":2143},"end":{"line":26,"column":148,"offset":2161},"indent":[]}}],"position":{"start":{"line":26,"column":129,"offset":2142},"end":{"line":26,"column":175,"offset":2188},"indent":[]}},{"type":"text","value":" of Kerberos allows you to operate a video surveillance cluster (Kubernetes) on-premise or in the cloud (AWS/GCP/Azure).","position":{"start":{"line":26,"column":175,"offset":2188},"end":{"line":26,"column":295,"offset":2308},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":2014},"end":{"line":26,"column":295,"offset":2308},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-agent.png","alt":"kerberos agent oss enterprise","position":{"start":{"line":28,"column":1,"offset":2310},"end":{"line":28,"column":70,"offset":2379},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":2310},"end":{"line":28,"column":70,"offset":2379},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Open Source and Enterprise edition are significantly different from a source code point of view. The ","position":{"start":{"line":30,"column":1,"offset":2381},"end":{"line":30,"column":106,"offset":2486},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Enterprise edition","position":{"start":{"line":30,"column":107,"offset":2487},"end":{"line":30,"column":125,"offset":2505},"indent":[]}}],"position":{"start":{"line":30,"column":106,"offset":2486},"end":{"line":30,"column":152,"offset":2532},"indent":[]}},{"type":"text","value":" is a complete rewrite of the Open Source version, and got all the best practices we discovered over the years implemented. Both version are and will remain updated in the future.","position":{"start":{"line":30,"column":152,"offset":2532},"end":{"line":30,"column":331,"offset":2711},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":2381},"end":{"line":30,"column":331,"offset":2711},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Storage","position":{"start":{"line":32,"column":4,"offset":2716},"end":{"line":32,"column":11,"offset":2723},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2713},"end":{"line":32,"column":11,"offset":2723},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Users or Enteprises which only have a few surveillance cameras to manage, probably will be fine with Kerberos Open Source. On top of that they might include ","position":{"start":{"line":34,"column":1,"offset":2725},"end":{"line":34,"column":158,"offset":2882},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":34,"column":159,"offset":2883},"end":{"line":34,"column":173,"offset":2897},"indent":[]}}],"position":{"start":{"line":34,"column":158,"offset":2882},"end":{"line":34,"column":182,"offset":2906},"indent":[]}},{"type":"text","value":" for remote access and monitoring.","position":{"start":{"line":34,"column":182,"offset":2906},"end":{"line":34,"column":216,"offset":2940},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2725},"end":{"line":34,"column":216,"offset":2940},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand if you plan to manage a larger network of surveillance cameras, you will have to look into ","position":{"start":{"line":36,"column":1,"offset":2942},"end":{"line":36,"column":110,"offset":3051},"indent":[]}},{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":36,"column":111,"offset":3052},"end":{"line":36,"column":130,"offset":3071},"indent":[]}}],"position":{"start":{"line":36,"column":110,"offset":3051},"end":{"line":36,"column":157,"offset":3098},"indent":[]}},{"type":"text","value":". Backed up with Kubernetes, Kerberos Enterprise, will give you the real super powers to your scale surveillance camera landscape. Kerberos Enterprise comes with a Front-End to manage and scale your deployments inside a Kubernetes Cluster.","position":{"start":{"line":36,"column":157,"offset":3098},"end":{"line":36,"column":396,"offset":3337},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2942},"end":{"line":36,"column":396,"offset":3337},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"/enterprise/introduction","children":[{"type":"text","value":"Kerberos Enterprise","position":{"start":{"line":38,"column":2,"offset":3340},"end":{"line":38,"column":21,"offset":3359},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":3339},"end":{"line":38,"column":48,"offset":3386},"indent":[]}},{"type":"text","value":" leverages a service called, ","position":{"start":{"line":38,"column":48,"offset":3386},"end":{"line":38,"column":77,"offset":3415},"indent":[]}},{"type":"link","title":null,"url":"/storage/introduction","children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":38,"column":78,"offset":3416},"end":{"line":38,"column":94,"offset":3432},"indent":[]}}],"position":{"start":{"line":38,"column":77,"offset":3415},"end":{"line":38,"column":118,"offset":3456},"indent":[]}},{"type":"text","value":", for central and hybrid storage. Kerberos Storage implements the concept of BYOC (Bring Your Own Cloud). By selecting a cloud provider (AWS, GCP, AZURE) or on-premise (Minio) you can bring your recordings where you them to be.","position":{"start":{"line":38,"column":118,"offset":3456},"end":{"line":38,"column":345,"offset":3683},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":3339},"end":{"line":38,"column":345,"offset":3683},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to the concept of BYOC, Kerberos Storage enables you to connect to Kerberos Cloud (with your own storage), send events to message brokers (such as Kafka or SQS) and enables you to build custom apps or services (such as a custom machine learning service).","position":{"start":{"line":40,"column":1,"offset":3685},"end":{"line":40,"column":267,"offset":3951},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":3685},"end":{"line":40,"column":267,"offset":3951},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-storage.png","alt":"Architecture Storage","position":{"start":{"line":42,"column":1,"offset":3953},"end":{"line":42,"column":63,"offset":4015},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":3953},"end":{"line":42,"column":63,"offset":4015},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud","position":{"start":{"line":44,"column":4,"offset":4020},"end":{"line":44,"column":9,"offset":4025},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":4017},"end":{"line":44,"column":9,"offset":4025},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When installing a Kerberos Agent inside your local network, it's possible to review your activity by using the agent its web interface. By all network principles, having a local setup, you will not be able to access the web interface from the cloud (outside your local network). On top of that, the Kerberos Agent doesn't come with a consolidated overview. This means that you will need to open multiple web interfaces, one for each connected surveillance camera. To simplify and resolve all of these challenges, ","position":{"start":{"line":46,"column":1,"offset":4027},"end":{"line":46,"column":514,"offset":4540},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":46,"column":515,"offset":4541},"end":{"line":46,"column":529,"offset":4555},"indent":[]}}],"position":{"start":{"line":46,"column":514,"offset":4540},"end":{"line":46,"column":538,"offset":4564},"indent":[]}},{"type":"text","value":" was developed.","position":{"start":{"line":46,"column":538,"offset":4564},"end":{"line":46,"column":553,"offset":4579},"indent":[]}}],"position":{"start":{"line":46,"column":1,"offset":4027},"end":{"line":46,"column":553,"offset":4579},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":48,"column":1,"offset":4581},"end":{"line":48,"column":53,"offset":4633},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":4581},"end":{"line":48,"column":53,"offset":4633},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":51,"column":1,"offset":4636},"end":{"line":51,"column":31,"offset":4666},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":51,"column":31,"offset":4666}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`How it works`}

\n

{`When you install Kerberos Open Source or Kerberos Enterprise we will refer to it as the Kerberos Agent. A Kerberos Agent, is a software solution that consist of two pieces: Front-End and Back-End. The Back-End processes the video stream of a single surveillance camera, makes recordings and takes actions (for example sending notifications). The Front-End allows you to review recordings, and configure the Back-End.`}

\n

\"architecture

\n

{`Front-End`}

\n

{`The Kerberos Agent ships with a web interface (Front-End) and a video processing engine (Back-End). The Front-End allows the user to modify specific settings, and if Kerberos Open Source, watch recordings in a easy-to-use interface; The Front-End for `}{`Kerberos Enterprise`}{` is only for configuration purposes only.`}

\n

{`Back-End`}

\n

{`The Back-End piece of the Kerberos Agent is a service that processes the camera feed with computer vision algorithms to detect motion, and makes recordings and/or execute specific actions. Kerberos Enterprise supports any type of IP-camera (RTSP/ONVIF), and Kerberos Open Source also adds support for USB (V4L2) and the popular Raspberry Pi camera.`}

\n

{`Depending on which Kerberos Agent, Kerberos Open Source or Kerberos Enterprise, you will have different installation methods. If you would like to learn more about the Kerberos Agent, have a look in the related sections: `}{`Open Source`}{`, `}{`Enterprise`}{`.`}

\n

{`Open Source vs Enterprise`}

\n

{`The Kerberos project started as an Open Source project, with a main focus on low-cost devices such as the Raspberry Pi. Later on the Open Source version was bundled inside the Docker technology so that it was easier to distribute. Anyone can use the Open Source version for personal usage.`}

\n

{`Enterprises are more demanding, and have a lot of surveillance cameras, therefore they need a scalable surveillance system. The `}{`Enterprise edition`}{` of Kerberos allows you to operate a video surveillance cluster (Kubernetes) on-premise or in the cloud (AWS/GCP/Azure).`}

\n

\"kerberos

\n

{`The Open Source and Enterprise edition are significantly different from a source code point of view. The `}{`Enterprise edition`}{` is a complete rewrite of the Open Source version, and got all the best practices we discovered over the years implemented. Both version are and will remain updated in the future.`}

\n

{`Storage`}

\n

{`Users or Enteprises which only have a few surveillance cameras to manage, probably will be fine with Kerberos Open Source. On top of that they might include `}{`Kerberos Cloud`}{` for remote access and monitoring.`}

\n

{`On the other hand if you plan to manage a larger network of surveillance cameras, you will have to look into `}{`Kerberos Enterprise`}{`. Backed up with Kubernetes, Kerberos Enterprise, will give you the real super powers to your scale surveillance camera landscape. Kerberos Enterprise comes with a Front-End to manage and scale your deployments inside a Kubernetes Cluster.`}

\n

{`Kerberos Enterprise`}{` leverages a service called, `}{`Kerberos Storage`}{`, for central and hybrid storage. Kerberos Storage implements the concept of BYOC (Bring Your Own Cloud). By selecting a cloud provider (AWS, GCP, AZURE) or on-premise (Minio) you can bring your recordings where you them to be.`}

\n

{`In addition to the concept of BYOC, Kerberos Storage enables you to connect to Kerberos Cloud (with your own storage), send events to message brokers (such as Kafka or SQS) and enables you to build custom apps or services (such as a custom machine learning service).`}

\n

\"Architecture

\n

{`Cloud`}

\n

{`When installing a Kerberos Agent inside your local network, it's possible to review your activity by using the agent its web interface. By all network principles, having a local setup, you will not be able to access the web interface from the cloud (outside your local network). On top of that, the Kerberos Agent doesn't come with a consolidated overview. This means that you will need to open multiple web interfaces, one for each connected surveillance camera. To simplify and resolve all of these challenges, `}{`Kerberos Cloud`}{` was developed.`}

\n

\"cloud\"

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-d5f7cf0926e7257c1932d204d4d5a90c.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-d5f7cf0926e7257c1932d204d4d5a90c.json new file mode 100644 index 0000000..ac52897 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-d5f7cf0926e7257c1932d204d4d5a90c.json @@ -0,0 +1 @@ +{"expireTime":9007200861750176000,"key":"gatsby-plugin-mdx-entire-payload-96c9fd338fdcc81a683f605751c63654-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Enterprise","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.","position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}}],"position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Next to that many other vendors started working on custom VMS solution, usually tightly coupled to there proprietary surveillance hardware, and closed software with limited API or messaging capabilities.","position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":204,"offset":981},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":204,"offset":981},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud which is open solution stack, suitable for scaling against your ever growing video surveillance landscape, but having extensibility and integration built-in from the start.","position":{"start":{"line":18,"column":1,"offset":983},"end":{"line":18,"column":269,"offset":1251},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":983},"end":{"line":18,"column":269,"offset":1251},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":20,"column":1,"offset":1253},"end":{"line":22,"column":11,"offset":1455},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":24,"column":4,"offset":1460},"end":{"line":24,"column":14,"offset":1470},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1457},"end":{"line":24,"column":14,"offset":1470},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.","position":{"start":{"line":26,"column":1,"offset":1472},"end":{"line":26,"column":306,"offset":1777},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1472},"end":{"line":26,"column":306,"offset":1777},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":28,"column":1,"offset":1779},"end":{"line":28,"column":91,"offset":1869},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1779},"end":{"line":28,"column":91,"offset":1869},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).","position":{"start":{"line":30,"column":1,"offset":1871},"end":{"line":30,"column":239,"offset":2109},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1871},"end":{"line":30,"column":239,"offset":2109},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.","position":{"start":{"line":32,"column":1,"offset":2111},"end":{"line":32,"column":242,"offset":2352},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2111},"end":{"line":32,"column":242,"offset":2352},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.","position":{"start":{"line":34,"column":1,"offset":2354},"end":{"line":34,"column":205,"offset":2558},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2354},"end":{"line":34,"column":205,"offset":2558},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud or on premise","position":{"start":{"line":36,"column":4,"offset":2563},"end":{"line":36,"column":23,"offset":2582},"indent":[]}}],"position":{"start":{"line":36,"column":1,"offset":2560},"end":{"line":36,"column":23,"offset":2582},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.","position":{"start":{"line":38,"column":1,"offset":2584},"end":{"line":38,"column":283,"offset":2866},"indent":[]}}],"position":{"start":{"line":38,"column":1,"offset":2584},"end":{"line":38,"column":283,"offset":2866},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":40,"column":1,"offset":2868},"end":{"line":40,"column":97,"offset":2964},"indent":[]}}],"position":{"start":{"line":40,"column":1,"offset":2868},"end":{"line":40,"column":97,"offset":2964},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":42,"column":4,"offset":2969},"end":{"line":42,"column":13,"offset":2978},"indent":[]}}],"position":{"start":{"line":42,"column":1,"offset":2966},"end":{"line":42,"column":13,"offset":2978},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is publicly available and ","position":{"start":{"line":44,"column":1,"offset":2980},"end":{"line":44,"column":47,"offset":3026},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":44,"column":49,"offset":3028},"end":{"line":44,"column":57,"offset":3036},"indent":[]}}],"position":{"start":{"line":44,"column":47,"offset":3026},"end":{"line":44,"column":59,"offset":3038},"indent":[]}},{"type":"text","value":" require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.","position":{"start":{"line":44,"column":59,"offset":3038},"end":{"line":44,"column":174,"offset":3153},"indent":[]}}],"position":{"start":{"line":44,"column":1,"offset":2980},"end":{"line":44,"column":174,"offset":3153},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":47,"column":1,"offset":3156},"end":{"line":47,"column":31,"offset":3186},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":47,"column":31,"offset":3186}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Enterprise`}

\n

{`Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.`}

\n

{`That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.`}

\n

{`Next to that many other vendors started working on custom VMS solution, usually tightly coupled to there proprietary surveillance hardware, and closed software with limited API or messaging capabilities.`}

\n

{`Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud which is open solution stack, suitable for scaling against your ever growing video surveillance landscape, but having extensibility and integration built-in from the start.`}

\n
\n
\n

\n

{`Kubernetes`}

\n

{`To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.`}

\n

\"architecture

\n

{`Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).`}

\n

{`Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.`}

\n

{`By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.`}

\n

{`Cloud or on premise`}

\n

{`You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.`}

\n

\"architecture

\n

{`Licensing`}

\n

{`Kerberos Enterprise is publicly available and `}{`does not`}{` require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-dd0393e61ad68e54dee80c0d90a8a818.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-dd0393e61ad68e54dee80c0d90a8a818.json new file mode 100644 index 0000000..578ca8b --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-dd0393e61ad68e54dee80c0d90a8a818.json @@ -0,0 +1 @@ +{"expireTime":9007200861762410000,"key":"gatsby-plugin-mdx-entire-payload-c2941ccc935a53b0c9920abfef0ee3c8-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Enterprise","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.","position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}}],"position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Independent from that we've seen many vendors developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solutions with limited API's and/or messaging capabilities.","position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":280,"offset":1057},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":280,"offset":1057},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the ground up.","position":{"start":{"line":18,"column":1,"offset":1059},"end":{"line":18,"column":270,"offset":1328},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1059},"end":{"line":18,"column":270,"offset":1328},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The major key differentiators compared to to other solutions are:","position":{"start":{"line":20,"column":1,"offset":1330},"end":{"line":20,"column":66,"offset":1395},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1330},"end":{"line":20,"column":66,"offset":1395},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Scalability with Kubernetes,","position":{"start":{"line":22,"column":5,"offset":1401},"end":{"line":22,"column":33,"offset":1429},"indent":[]}}],"position":{"start":{"line":22,"column":5,"offset":1401},"end":{"line":22,"column":33,"offset":1429},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1397},"end":{"line":22,"column":33,"offset":1429},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Open API's with well documented Swagger API's,","position":{"start":{"line":23,"column":5,"offset":1434},"end":{"line":23,"column":51,"offset":1480},"indent":[]}}],"position":{"start":{"line":23,"column":5,"offset":1434},"end":{"line":23,"column":51,"offset":1480},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1430},"end":{"line":23,"column":51,"offset":1480},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Host anywhere, in the cloud or on premise,","position":{"start":{"line":24,"column":5,"offset":1485},"end":{"line":24,"column":47,"offset":1527},"indent":[]}}],"position":{"start":{"line":24,"column":5,"offset":1485},"end":{"line":24,"column":47,"offset":1527},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1481},"end":{"line":24,"column":47,"offset":1527},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Integration and extension, allowing to build custom apps, ML services and more.","position":{"start":{"line":25,"column":5,"offset":1532},"end":{"line":25,"column":84,"offset":1611},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1532},"end":{"line":25,"column":84,"offset":1611},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1528},"end":{"line":25,"column":84,"offset":1611},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1397},"end":{"line":25,"column":84,"offset":1611},"indent":[1,1,1]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":27,"column":1,"offset":1613},"end":{"line":29,"column":11,"offset":1815},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":31,"column":4,"offset":1820},"end":{"line":31,"column":14,"offset":1830},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1817},"end":{"line":31,"column":14,"offset":1830},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.","position":{"start":{"line":33,"column":1,"offset":1832},"end":{"line":33,"column":306,"offset":2137},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1832},"end":{"line":33,"column":306,"offset":2137},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":35,"column":1,"offset":2139},"end":{"line":35,"column":91,"offset":2229},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2139},"end":{"line":35,"column":91,"offset":2229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Baremetal machines).","position":{"start":{"line":37,"column":1,"offset":2231},"end":{"line":37,"column":238,"offset":2468},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2231},"end":{"line":37,"column":238,"offset":2468},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.","position":{"start":{"line":39,"column":1,"offset":2470},"end":{"line":39,"column":242,"offset":2711},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2470},"end":{"line":39,"column":242,"offset":2711},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.","position":{"start":{"line":41,"column":1,"offset":2713},"end":{"line":41,"column":205,"offset":2917},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2713},"end":{"line":41,"column":205,"offset":2917},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud or on premise","position":{"start":{"line":43,"column":4,"offset":2922},"end":{"line":43,"column":23,"offset":2941},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2919},"end":{"line":43,"column":23,"offset":2941},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.","position":{"start":{"line":45,"column":1,"offset":2943},"end":{"line":45,"column":283,"offset":3225},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2943},"end":{"line":45,"column":283,"offset":3225},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":47,"column":1,"offset":3227},"end":{"line":47,"column":97,"offset":3323},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3227},"end":{"line":47,"column":97,"offset":3323},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":49,"column":4,"offset":3328},"end":{"line":49,"column":13,"offset":3337},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3325},"end":{"line":49,"column":13,"offset":3337},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is publicly available and ","position":{"start":{"line":51,"column":1,"offset":3339},"end":{"line":51,"column":47,"offset":3385},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":51,"column":49,"offset":3387},"end":{"line":51,"column":57,"offset":3395},"indent":[]}}],"position":{"start":{"line":51,"column":47,"offset":3385},"end":{"line":51,"column":59,"offset":3397},"indent":[]}},{"type":"text","value":" require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.","position":{"start":{"line":51,"column":59,"offset":3397},"end":{"line":51,"column":174,"offset":3512},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":3339},"end":{"line":51,"column":174,"offset":3512},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":54,"column":1,"offset":3515},"end":{"line":54,"column":31,"offset":3545},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":54,"column":31,"offset":3545}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Enterprise`}

\n

{`Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.`}

\n

{`That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.`}

\n

{`Independent from that we've seen many vendors developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solutions with limited API's and/or messaging capabilities.`}

\n

{`Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the ground up.`}

\n

{`The major key differentiators compared to to other solutions are:`}

\n
    \n
  • {`Scalability with Kubernetes,`}
    • \n
  • {`Open API's with well documented Swagger API's,`}
    • \n
  • {`Host anywhere, in the cloud or on premise,`}
    • \n
  • {`Integration and extension, allowing to build custom apps, ML services and more.`}
    • \n
\n
\n
\n

\n

{`Kubernetes`}

\n

{`To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.`}

\n

\"architecture

\n

{`Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Baremetal machines).`}

\n

{`Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.`}

\n

{`By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.`}

\n

{`Cloud or on premise`}

\n

{`You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.`}

\n

\"architecture

\n

{`Licensing`}

\n

{`Kerberos Enterprise is publicly available and `}{`does not`}{` require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e2595422e38f9a81e250876e319c5968.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e2595422e38f9a81e250876e319c5968.json new file mode 100644 index 0000000..16727c1 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e2595422e38f9a81e250876e319c5968.json @@ -0,0 +1 @@ +{"expireTime":9007200861750704000,"key":"gatsby-plugin-mdx-entire-payload-951dbd7fbf77a468de3cfb91b926aa3a-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Enterprise","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.","position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}}],"position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Independent from that we've seen many vendors developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solutions with limited API's and/or messaging capabilities.","position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":280,"offset":1057},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":280,"offset":1057},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the ground up.","position":{"start":{"line":18,"column":1,"offset":1059},"end":{"line":18,"column":270,"offset":1328},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1059},"end":{"line":18,"column":270,"offset":1328},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The major key differentiators compared to to other solutions are:","position":{"start":{"line":20,"column":1,"offset":1330},"end":{"line":20,"column":66,"offset":1395},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1330},"end":{"line":20,"column":66,"offset":1395},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Scalability with Kubernetes,","position":{"start":{"line":22,"column":5,"offset":1401},"end":{"line":22,"column":33,"offset":1429},"indent":[]}}],"position":{"start":{"line":22,"column":5,"offset":1401},"end":{"line":22,"column":33,"offset":1429},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1397},"end":{"line":22,"column":33,"offset":1429},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Open API's with well documented Swagger API's,","position":{"start":{"line":23,"column":5,"offset":1434},"end":{"line":23,"column":51,"offset":1480},"indent":[]}}],"position":{"start":{"line":23,"column":5,"offset":1434},"end":{"line":23,"column":51,"offset":1480},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1430},"end":{"line":23,"column":51,"offset":1480},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Host anywhere, in the cloud or on premise.","position":{"start":{"line":24,"column":5,"offset":1485},"end":{"line":24,"column":47,"offset":1527},"indent":[]}}],"position":{"start":{"line":24,"column":5,"offset":1485},"end":{"line":24,"column":47,"offset":1527},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1481},"end":{"line":24,"column":47,"offset":1527},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Integration and extension, allowing to build custom apps, ML services and more.","position":{"start":{"line":25,"column":5,"offset":1532},"end":{"line":25,"column":84,"offset":1611},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1532},"end":{"line":25,"column":84,"offset":1611},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1528},"end":{"line":25,"column":84,"offset":1611},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1397},"end":{"line":25,"column":84,"offset":1611},"indent":[1,1,1]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":27,"column":1,"offset":1613},"end":{"line":29,"column":11,"offset":1815},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":31,"column":4,"offset":1820},"end":{"line":31,"column":14,"offset":1830},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1817},"end":{"line":31,"column":14,"offset":1830},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.","position":{"start":{"line":33,"column":1,"offset":1832},"end":{"line":33,"column":306,"offset":2137},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1832},"end":{"line":33,"column":306,"offset":2137},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":35,"column":1,"offset":2139},"end":{"line":35,"column":91,"offset":2229},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2139},"end":{"line":35,"column":91,"offset":2229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).","position":{"start":{"line":37,"column":1,"offset":2231},"end":{"line":37,"column":239,"offset":2469},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2231},"end":{"line":37,"column":239,"offset":2469},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.","position":{"start":{"line":39,"column":1,"offset":2471},"end":{"line":39,"column":242,"offset":2712},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2471},"end":{"line":39,"column":242,"offset":2712},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.","position":{"start":{"line":41,"column":1,"offset":2714},"end":{"line":41,"column":205,"offset":2918},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2714},"end":{"line":41,"column":205,"offset":2918},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud or on premise","position":{"start":{"line":43,"column":4,"offset":2923},"end":{"line":43,"column":23,"offset":2942},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2920},"end":{"line":43,"column":23,"offset":2942},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.","position":{"start":{"line":45,"column":1,"offset":2944},"end":{"line":45,"column":283,"offset":3226},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2944},"end":{"line":45,"column":283,"offset":3226},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":47,"column":1,"offset":3228},"end":{"line":47,"column":97,"offset":3324},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3228},"end":{"line":47,"column":97,"offset":3324},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":49,"column":4,"offset":3329},"end":{"line":49,"column":13,"offset":3338},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3326},"end":{"line":49,"column":13,"offset":3338},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is publicly available and ","position":{"start":{"line":51,"column":1,"offset":3340},"end":{"line":51,"column":47,"offset":3386},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":51,"column":49,"offset":3388},"end":{"line":51,"column":57,"offset":3396},"indent":[]}}],"position":{"start":{"line":51,"column":47,"offset":3386},"end":{"line":51,"column":59,"offset":3398},"indent":[]}},{"type":"text","value":" require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.","position":{"start":{"line":51,"column":59,"offset":3398},"end":{"line":51,"column":174,"offset":3513},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":3340},"end":{"line":51,"column":174,"offset":3513},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":54,"column":1,"offset":3516},"end":{"line":54,"column":31,"offset":3546},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":54,"column":31,"offset":3546}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Enterprise`}

\n

{`Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.`}

\n

{`That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.`}

\n

{`Independent from that we've seen many vendors developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solutions with limited API's and/or messaging capabilities.`}

\n

{`Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the ground up.`}

\n

{`The major key differentiators compared to to other solutions are:`}

\n
    \n
  • {`Scalability with Kubernetes,`}
    • \n
  • {`Open API's with well documented Swagger API's,`}
    • \n
  • {`Host anywhere, in the cloud or on premise.`}
    • \n
  • {`Integration and extension, allowing to build custom apps, ML services and more.`}
    • \n
\n
\n
\n

\n

{`Kubernetes`}

\n

{`To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.`}

\n

\"architecture

\n

{`Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).`}

\n

{`Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.`}

\n

{`By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.`}

\n

{`Cloud or on premise`}

\n

{`You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.`}

\n

\"architecture

\n

{`Licensing`}

\n

{`Kerberos Enterprise is publicly available and `}{`does not`}{` require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e375037fc8ce1a33452477b4a399edd8.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e375037fc8ce1a33452477b4a399edd8.json new file mode 100644 index 0000000..dc616e5 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e375037fc8ce1a33452477b4a399edd8.json @@ -0,0 +1 @@ +{"expireTime":9007200861829927000,"key":"gatsby-plugin-mdx-entire-payload-5427ff58a8a6695178601f26ed2a1384-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":396,"offset":1049},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":396,"offset":1049},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Despite the flexible storage capabilities, Kerberos Storage is also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations. It allows you to leverage a scalable and stable system as a strong backbone for your video analytics solutions, machine learning algorithms, and more.","position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":349,"offset":1399},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":349,"offset":1399},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":22,"column":4,"offset":1404},"end":{"line":22,"column":18,"offset":1418},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1401},"end":{"line":22,"column":18,"offset":1418},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can upload your recordings to our ","position":{"start":{"line":24,"column":1,"offset":1420},"end":{"line":24,"column":90,"offset":1509},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":24,"column":91,"offset":1510},"end":{"line":24,"column":105,"offset":1524},"indent":[]}}],"position":{"start":{"line":24,"column":90,"offset":1509},"end":{"line":24,"column":114,"offset":1533},"indent":[]}},{"type":"text","value":" environment. This means that your data will be hosted and processed (metadata) in our Kerberos datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":24,"column":114,"offset":1533},"end":{"line":24,"column":274,"offset":1693},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":24,"column":275,"offset":1694},"end":{"line":24,"column":292,"offset":1711},"indent":[]}}],"position":{"start":{"line":24,"column":274,"offset":1693},"end":{"line":24,"column":301,"offset":1720},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":24,"column":301,"offset":1720},"end":{"line":24,"column":302,"offset":1721},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1420},"end":{"line":24,"column":302,"offset":1721},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":26,"column":1,"offset":1723},"end":{"line":26,"column":56,"offset":1778},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1723},"end":{"line":26,"column":56,"offset":1778},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":28,"column":4,"offset":1783},"end":{"line":28,"column":20,"offset":1799},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1780},"end":{"line":28,"column":20,"offset":1799},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":30,"column":1,"offset":1801},"end":{"line":30,"column":253,"offset":2053},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1801},"end":{"line":30,"column":253,"offset":2053},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":32,"column":6,"offset":2060},"end":{"line":32,"column":35,"offset":2089},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2059},"end":{"line":32,"column":70,"offset":2124},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2059},"end":{"line":32,"column":70,"offset":2124},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2055},"end":{"line":32,"column":70,"offset":2124},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":33,"column":6,"offset":2130},"end":{"line":33,"column":29,"offset":2153},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2129},"end":{"line":33,"column":83,"offset":2207},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2129},"end":{"line":33,"column":83,"offset":2207},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2125},"end":{"line":33,"column":83,"offset":2207},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":34,"column":6,"offset":2213},"end":{"line":34,"column":28,"offset":2235},"indent":[]}}],"position":{"start":{"line":34,"column":5,"offset":2212},"end":{"line":34,"column":57,"offset":2264},"indent":[]}}],"position":{"start":{"line":34,"column":5,"offset":2212},"end":{"line":34,"column":57,"offset":2264},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2208},"end":{"line":34,"column":57,"offset":2264},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":35,"column":6,"offset":2270},"end":{"line":35,"column":11,"offset":2275},"indent":[]}}],"position":{"start":{"line":35,"column":5,"offset":2269},"end":{"line":35,"column":29,"offset":2293},"indent":[]}}],"position":{"start":{"line":35,"column":5,"offset":2269},"end":{"line":35,"column":29,"offset":2293},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2265},"end":{"line":35,"column":29,"offset":2293},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2055},"end":{"line":35,"column":29,"offset":2293},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"When installing Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":37,"column":1,"offset":2295},"end":{"line":37,"column":189,"offset":2483},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2295},"end":{"line":37,"column":189,"offset":2483},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":39,"column":1,"offset":2485},"end":{"line":39,"column":99,"offset":2583},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2485},"end":{"line":39,"column":99,"offset":2583},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing or video analytics suchs as computer bision or machine learning at the edge.","position":{"start":{"line":41,"column":1,"offset":2585},"end":{"line":41,"column":246,"offset":2830},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2585},"end":{"line":41,"column":246,"offset":2830},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":43,"column":1,"offset":2832},"end":{"line":43,"column":98,"offset":2929},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2832},"end":{"line":43,"column":98,"offset":2929},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":45,"column":5,"offset":2935},"end":{"line":45,"column":11,"offset":2941},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2931},"end":{"line":45,"column":11,"offset":2941},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":47,"column":1,"offset":2943},"end":{"line":47,"column":303,"offset":3245},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2943},"end":{"line":47,"column":303,"offset":3245},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":49,"column":6,"offset":3252},"end":{"line":49,"column":18,"offset":3264},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":3251},"end":{"line":49,"column":46,"offset":3292},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":3251},"end":{"line":49,"column":46,"offset":3292},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3247},"end":{"line":49,"column":46,"offset":3292},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":50,"column":6,"offset":3298},"end":{"line":50,"column":29,"offset":3321},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":3297},"end":{"line":50,"column":59,"offset":3351},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":3297},"end":{"line":50,"column":59,"offset":3351},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3293},"end":{"line":50,"column":59,"offset":3351},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3247},"end":{"line":50,"column":59,"offset":3351},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":52,"column":1,"offset":3353},"end":{"line":52,"column":368,"offset":3720},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3353},"end":{"line":52,"column":368,"offset":3720},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":54,"column":1,"offset":3722},"end":{"line":54,"column":66,"offset":3787},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3722},"end":{"line":54,"column":66,"offset":3787},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":56,"column":5,"offset":3793},"end":{"line":56,"column":21,"offset":3809},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3789},"end":{"line":56,"column":21,"offset":3809},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":58,"column":1,"offset":3811},"end":{"line":58,"column":237,"offset":4047},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3811},"end":{"line":58,"column":237,"offset":4047},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":60,"column":1,"offset":4049},"end":{"line":60,"column":105,"offset":4153},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4049},"end":{"line":60,"column":105,"offset":4153},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":62,"column":1,"offset":4155},"end":{"line":62,"column":45,"offset":4199},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4155},"end":{"line":62,"column":45,"offset":4199},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":64,"column":3,"offset":4203},"end":{"line":64,"column":380,"offset":4580},"indent":[]}}],"position":{"start":{"line":64,"column":3,"offset":4203},"end":{"line":64,"column":380,"offset":4580},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4201},"end":{"line":65,"column":1,"offset":4581},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":66,"column":3,"offset":4584},"end":{"line":67,"column":49,"offset":4898},"indent":[2]}}],"position":{"start":{"line":66,"column":3,"offset":4584},"end":{"line":67,"column":49,"offset":4898},"indent":[2]}}],"position":{"start":{"line":66,"column":1,"offset":4582},"end":{"line":67,"column":49,"offset":4898},"indent":[1]}}],"position":{"start":{"line":64,"column":1,"offset":4201},"end":{"line":67,"column":49,"offset":4898},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":69,"column":5,"offset":4904},"end":{"line":69,"column":13,"offset":4912},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4900},"end":{"line":69,"column":13,"offset":4912},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":71,"column":1,"offset":4914},"end":{"line":71,"column":156,"offset":5069},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":71,"column":156,"offset":5069},"end":{"line":71,"column":177,"offset":5090},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":71,"column":177,"offset":5090},"end":{"line":71,"column":188,"offset":5101},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":71,"column":188,"offset":5101},"end":{"line":71,"column":193,"offset":5106},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":71,"column":193,"offset":5106},"end":{"line":71,"column":379,"offset":5292},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":4914},"end":{"line":71,"column":379,"offset":5292},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":73,"column":1,"offset":5294},"end":{"line":73,"column":68,"offset":5361},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5294},"end":{"line":73,"column":68,"offset":5361},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":75,"column":4,"offset":5366},"end":{"line":75,"column":13,"offset":5375},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5363},"end":{"line":75,"column":13,"offset":5375},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":77,"column":1,"offset":5377},"end":{"line":77,"column":44,"offset":5420},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":77,"column":46,"offset":5422},"end":{"line":77,"column":68,"offset":5444},"indent":[]}}],"position":{"start":{"line":77,"column":44,"offset":5420},"end":{"line":77,"column":70,"offset":5446},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":77,"column":70,"offset":5446},"end":{"line":77,"column":106,"offset":5482},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":77,"column":108,"offset":5484},"end":{"line":77,"column":129,"offset":5505},"indent":[]}}],"position":{"start":{"line":77,"column":106,"offset":5482},"end":{"line":77,"column":131,"offset":5507},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":77,"column":131,"offset":5507},"end":{"line":77,"column":159,"offset":5535},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":5377},"end":{"line":77,"column":159,"offset":5535},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":80,"column":1,"offset":5538},"end":{"line":80,"column":31,"offset":5568},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":80,"column":31,"offset":5568}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio.`}

\n

{`Despite the flexible storage capabilities, Kerberos Storage is also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations. It allows you to leverage a scalable and stable system as a strong backbone for your video analytics solutions, machine learning algorithms, and more.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can upload your recordings to our `}{`Kerberos Cloud`}{` environment. This means that your data will be hosted and processed (metadata) in our Kerberos datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`When installing Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing or video analytics suchs as computer bision or machine learning at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e3b4f18dc084340278044c19092a97a4.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e3b4f18dc084340278044c19092a97a4.json new file mode 100644 index 0000000..6bd11de --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e3b4f18dc084340278044c19092a97a4.json @@ -0,0 +1 @@ +{"expireTime":9007200861859764000,"key":"gatsby-plugin-mdx-entire-payload-b8ef4cda7ced979c98a7a9e2b4582aa3-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import ReplaceVersion from \"../components/ReplaceVersion\";","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":59,"offset":217},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Introduction","position":{"start":{"line":10,"column":3,"offset":221},"end":{"line":10,"column":15,"offset":233},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":219},"end":{"line":10,"column":15,"offset":233},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (","position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":12,"column":88,"offset":322},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"AWS","position":{"start":{"line":12,"column":90,"offset":324},"end":{"line":12,"column":93,"offset":327},"indent":[]}}],"position":{"start":{"line":12,"column":88,"offset":322},"end":{"line":12,"column":95,"offset":329},"indent":[]}},{"type":"text","value":", ","position":{"start":{"line":12,"column":95,"offset":329},"end":{"line":12,"column":97,"offset":331},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"GCP","position":{"start":{"line":12,"column":99,"offset":333},"end":{"line":12,"column":102,"offset":336},"indent":[]}}],"position":{"start":{"line":12,"column":97,"offset":331},"end":{"line":12,"column":104,"offset":338},"indent":[]}},{"type":"text","value":" or ","position":{"start":{"line":12,"column":104,"offset":338},"end":{"line":12,"column":108,"offset":342},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"Azure","position":{"start":{"line":12,"column":110,"offset":344},"end":{"line":12,"column":115,"offset":349},"indent":[]}}],"position":{"start":{"line":12,"column":108,"offset":342},"end":{"line":12,"column":117,"offset":351},"indent":[]}},{"type":"text","value":"),\ncloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.","position":{"start":{"line":12,"column":117,"offset":351},"end":{"line":13,"column":90,"offset":443},"indent":[1]}}],"position":{"start":{"line":12,"column":1,"offset":235},"end":{"line":13,"column":90,"offset":443},"indent":[1]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":15,"column":1,"offset":445},"end":{"line":17,"column":11,"offset":647},"indent":[1,1]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Installation","position":{"start":{"line":19,"column":3,"offset":651},"end":{"line":19,"column":15,"offset":663},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":649},"end":{"line":19,"column":15,"offset":663},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.","position":{"start":{"line":21,"column":1,"offset":665},"end":{"line":21,"column":323,"offset":987},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":665},"end":{"line":21,"column":323,"offset":987},"indent":[]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":23,"column":1,"offset":989},"end":{"line":25,"column":11,"offset":1191},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"First clone the configrations from our Github repo.","position":{"start":{"line":27,"column":1,"offset":1193},"end":{"line":27,"column":52,"offset":1244},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1193},"end":{"line":27,"column":52,"offset":1244},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"git clone https://github.com/kerberos-io/enterprise","position":{"start":{"line":29,"column":1,"offset":1246},"end":{"line":29,"column":56,"offset":1301},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next go into the directory and execute the first Kubernetes configuration file ","position":{"start":{"line":31,"column":1,"offset":1303},"end":{"line":31,"column":80,"offset":1382},"indent":[]}},{"type":"inlineCode","value":"clusterrole.yaml","position":{"start":{"line":31,"column":80,"offset":1382},"end":{"line":31,"column":98,"offset":1400},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":31,"column":98,"offset":1400},"end":{"line":31,"column":99,"offset":1401},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1303},"end":{"line":31,"column":99,"offset":1401},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml","position":{"start":{"line":33,"column":1,"offset":1403},"end":{"line":33,"column":65,"offset":1467},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This will make several actions inside your cluster available. We need this to be able to create deployments from the factory web app.","position":{"start":{"line":35,"column":1,"offset":1469},"end":{"line":35,"column":134,"offset":1602},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":1469},"end":{"line":35,"column":134,"offset":1602},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Helm","position":{"start":{"line":37,"column":4,"offset":1607},"end":{"line":37,"column":8,"offset":1611},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":1604},"end":{"line":37,"column":8,"offset":1611},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next we will install a couple of dependencies which are required for Kerberos Enterprise. ","position":{"start":{"line":39,"column":1,"offset":1613},"end":{"line":39,"column":91,"offset":1703},"indent":[]}},{"type":"link","title":null,"url":"https://helm.sh/","children":[{"type":"strong","children":[{"type":"text","value":"Helm","position":{"start":{"line":39,"column":94,"offset":1706},"end":{"line":39,"column":98,"offset":1710},"indent":[]}}],"position":{"start":{"line":39,"column":92,"offset":1704},"end":{"line":39,"column":100,"offset":1712},"indent":[]}}],"position":{"start":{"line":39,"column":91,"offset":1703},"end":{"line":39,"column":119,"offset":1731},"indent":[]}},{"type":"text","value":" is a package manager for Kubernetes, it helps you setting up services more easily (this could be a MQTT broker, a database, etc).\nInstead of writing yaml files for every service we need, we use so called ","position":{"start":{"line":39,"column":119,"offset":1731},"end":{"line":40,"column":75,"offset":1936},"indent":[1]}},{"type":"strong","children":[{"type":"text","value":"Charts","position":{"start":{"line":40,"column":77,"offset":1938},"end":{"line":40,"column":83,"offset":1944},"indent":[]}}],"position":{"start":{"line":40,"column":75,"offset":1936},"end":{"line":40,"column":85,"offset":1946},"indent":[]}},{"type":"text","value":" (libraries), that you can reuse and configure the,\nwith the appropriate settings.","position":{"start":{"line":40,"column":85,"offset":1946},"end":{"line":41,"column":31,"offset":2028},"indent":[1]}}],"position":{"start":{"line":39,"column":1,"offset":1613},"end":{"line":41,"column":31,"offset":2028},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Use one of the preferred OS package managers to install the Helm client:","position":{"start":{"line":43,"column":1,"offset":2030},"end":{"line":43,"column":73,"offset":2102},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2030},"end":{"line":43,"column":73,"offset":2102},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"brew install helm\n\nchoco install kubernetes-helm\n\nscoop install helm\n\ngofish install helm","position":{"start":{"line":45,"column":1,"offset":2104},"end":{"line":51,"column":24,"offset":2209},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Traefik","position":{"start":{"line":53,"column":4,"offset":2214},"end":{"line":53,"column":11,"offset":2221},"indent":[]}}],"position":{"start":{"line":53,"column":1,"offset":2211},"end":{"line":53,"column":11,"offset":2221},"indent":[]}},{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://containo.us/traefik/","children":[{"type":"strong","children":[{"type":"text","value":"Traefik","position":{"start":{"line":55,"column":4,"offset":2226},"end":{"line":55,"column":11,"offset":2233},"indent":[]}}],"position":{"start":{"line":55,"column":2,"offset":2224},"end":{"line":55,"column":13,"offset":2235},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2223},"end":{"line":55,"column":44,"offset":2266},"indent":[]}},{"type":"text","value":" is a reverse proxy and load balancer which allows you to expose your deployments more easily. Kerberos uses Traefik to expose it's APIs more easily.","position":{"start":{"line":55,"column":44,"offset":2266},"end":{"line":55,"column":193,"offset":2415},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":2223},"end":{"line":55,"column":193,"offset":2415},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By executing following helm command, we will install traefik and link it to a specific DNS name. Open the traefik values file, ","position":{"start":{"line":57,"column":1,"offset":2417},"end":{"line":57,"column":128,"offset":2544},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/traefik/values.yaml","position":{"start":{"line":57,"column":128,"offset":2544},"end":{"line":57,"column":167,"offset":2583},"indent":[]}},{"type":"text","value":", and update the DNS name to your own domain.","position":{"start":{"line":57,"column":167,"offset":2583},"end":{"line":57,"column":212,"offset":2628},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":2417},"end":{"line":57,"column":212,"offset":2628},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" dashboard:\n enabled: true\n--> domain: traefik.domain.com\n serviceType: NodePort\n rbac:\n enabled: true","position":{"start":{"line":59,"column":1,"offset":2630},"end":{"line":64,"column":26,"offset":2781},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Add Helm repository and install traefik.","position":{"start":{"line":66,"column":1,"offset":2783},"end":{"line":66,"column":41,"offset":2823},"indent":[]}}],"position":{"start":{"line":66,"column":1,"offset":2783},"end":{"line":66,"column":41,"offset":2823},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add stable https://kubernetes-charts.storage.googleapis.com\nhelm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik","position":{"start":{"line":68,"column":1,"offset":2825},"end":{"line":69,"column":81,"offset":2979},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"After installation you should have an IP attached to traefik service, look for it by executing the ","position":{"start":{"line":71,"column":1,"offset":2981},"end":{"line":71,"column":100,"offset":3080},"indent":[]}},{"type":"inlineCode","value":"get service","position":{"start":{"line":71,"column":100,"offset":3080},"end":{"line":71,"column":113,"offset":3093},"indent":[]}},{"type":"text","value":" command. You will see the ip address in the ","position":{"start":{"line":71,"column":113,"offset":3093},"end":{"line":71,"column":158,"offset":3138},"indent":[]}},{"type":"inlineCode","value":"EXTERNAL-IP","position":{"start":{"line":71,"column":158,"offset":3138},"end":{"line":71,"column":171,"offset":3151},"indent":[]}},{"type":"text","value":" attribute.","position":{"start":{"line":71,"column":171,"offset":3151},"end":{"line":71,"column":182,"offset":3162},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":2981},"end":{"line":71,"column":182,"offset":3162},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl get svc\n\n NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE\n kubernetes ClusterIP 10.0.0.1 443/TCP 36h\n--> traefik LoadBalancer 10.0.27.93 40.114.168.96 443:31623/TCP,80:31804/TCP 35h\n traefik-dashboard NodePort 10.0.252.6 80:31146/TCP 35h","position":{"start":{"line":73,"column":1,"offset":3164},"end":{"line":78,"column":115,"offset":3644},"indent":[1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Go to your DNS provider and link the domain you've configured in the first step ","position":{"start":{"line":80,"column":1,"offset":3646},"end":{"line":80,"column":81,"offset":3726},"indent":[]}},{"type":"inlineCode","value":"traefik.domain.com","position":{"start":{"line":80,"column":81,"offset":3726},"end":{"line":80,"column":101,"offset":3746},"indent":[]}},{"type":"text","value":" to the IP address of the ","position":{"start":{"line":80,"column":101,"offset":3746},"end":{"line":80,"column":127,"offset":3772},"indent":[]}},{"type":"inlineCode","value":"EXTERNAL-IP","position":{"start":{"line":80,"column":127,"offset":3772},"end":{"line":80,"column":140,"offset":3785},"indent":[]}},{"type":"text","value":" attribute. When browsing to ","position":{"start":{"line":80,"column":140,"offset":3785},"end":{"line":80,"column":169,"offset":3814},"indent":[]}},{"type":"inlineCode","value":"traefik.domain.com","position":{"start":{"line":80,"column":169,"offset":3814},"end":{"line":80,"column":189,"offset":3834},"indent":[]}},{"type":"text","value":", you should see the traefik dashboard showing up.","position":{"start":{"line":80,"column":189,"offset":3834},"end":{"line":80,"column":239,"offset":3884},"indent":[]}}],"position":{"start":{"line":80,"column":1,"offset":3646},"end":{"line":80,"column":239,"offset":3884},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Ingress-Nginx (alternative for Traefik)","position":{"start":{"line":82,"column":4,"offset":3889},"end":{"line":82,"column":43,"offset":3928},"indent":[]}}],"position":{"start":{"line":82,"column":1,"offset":3886},"end":{"line":82,"column":43,"offset":3928},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you don't like ","position":{"start":{"line":84,"column":1,"offset":3930},"end":{"line":84,"column":19,"offset":3948},"indent":[]}},{"type":"inlineCode","value":"Traefik","position":{"start":{"line":84,"column":19,"offset":3948},"end":{"line":84,"column":28,"offset":3957},"indent":[]}},{"type":"text","value":" but you prefer ","position":{"start":{"line":84,"column":28,"offset":3957},"end":{"line":84,"column":44,"offset":3973},"indent":[]}},{"type":"inlineCode","value":"Ingress Nginx","position":{"start":{"line":84,"column":44,"offset":3973},"end":{"line":84,"column":59,"offset":3988},"indent":[]}},{"type":"text","value":", that works as well.","position":{"start":{"line":84,"column":59,"offset":3988},"end":{"line":84,"column":80,"offset":4009},"indent":[]}}],"position":{"start":{"line":84,"column":1,"offset":3930},"end":{"line":84,"column":80,"offset":4009},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx\nhelm repo update\nhelm install ingress-nginx ingress-nginx/ingress-nginx","position":{"start":{"line":86,"column":1,"offset":4011},"end":{"line":88,"column":59,"offset":4165},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"MongoDB","position":{"start":{"line":90,"column":4,"offset":4170},"end":{"line":90,"column":11,"offset":4177},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":4167},"end":{"line":90,"column":11,"offset":4177},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use ","position":{"start":{"line":92,"column":1,"offset":4179},"end":{"line":92,"column":192,"offset":4370},"indent":[]}},{"type":"inlineCode","value":"helm ","position":{"start":{"line":92,"column":192,"offset":4370},"end":{"line":92,"column":199,"offset":4377},"indent":[]}},{"type":"text","value":"to install a MongoDB instance inside your cluster.","position":{"start":{"line":92,"column":199,"offset":4377},"end":{"line":92,"column":249,"offset":4427},"indent":[]}}],"position":{"start":{"line":92,"column":1,"offset":4179},"end":{"line":92,"column":249,"offset":4427},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Have a look into the ","position":{"start":{"line":94,"column":1,"offset":4429},"end":{"line":94,"column":22,"offset":4450},"indent":[]}},{"type":"inlineCode","value":"yaml/mongodb/values.yaml","position":{"start":{"line":94,"column":22,"offset":4450},"end":{"line":94,"column":48,"offset":4476},"indent":[]}},{"type":"text","value":" file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb.","position":{"start":{"line":94,"column":48,"offset":4476},"end":{"line":94,"column":204,"offset":4632},"indent":[]}}],"position":{"start":{"line":94,"column":1,"offset":4429},"end":{"line":94,"column":204,"offset":4632},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values.yaml","position":{"start":{"line":96,"column":1,"offset":4634},"end":{"line":97,"column":88,"offset":4782},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.","position":{"start":{"line":99,"column":1,"offset":4784},"end":{"line":99,"column":170,"offset":4953},"indent":[]}}],"position":{"start":{"line":99,"column":1,"offset":4784},"end":{"line":99,"column":170,"offset":4953},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)\necho $MONGODB_ROOT_PASSWORD","position":{"start":{"line":101,"column":1,"offset":4955},"end":{"line":102,"column":32,"offset":5131},"indent":[1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Enterprise Web App - The Factory","position":{"start":{"line":104,"column":4,"offset":5136},"end":{"line":104,"column":45,"offset":5177},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":5133},"end":{"line":104,"column":45,"offset":5177},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the ","position":{"start":{"line":106,"column":1,"offset":5179},"end":{"line":106,"column":138,"offset":5316},"indent":[]}},{"type":"inlineCode","value":"Factory","position":{"start":{"line":106,"column":138,"offset":5316},"end":{"line":106,"column":147,"offset":5325},"indent":[]}},{"type":"text","value":". It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.","position":{"start":{"line":106,"column":147,"offset":5325},"end":{"line":106,"column":309,"offset":5487},"indent":[]}}],"position":{"start":{"line":106,"column":1,"offset":5179},"end":{"line":106,"column":309,"offset":5487},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the ","position":{"start":{"line":108,"column":1,"offset":5489},"end":{"line":108,"column":289,"offset":5777},"indent":[]}},{"type":"inlineCode","value":"kubectl","position":{"start":{"line":108,"column":289,"offset":5777},"end":{"line":108,"column":298,"offset":5786},"indent":[]}},{"type":"text","value":" command.","position":{"start":{"line":108,"column":298,"offset":5786},"end":{"line":108,"column":307,"offset":5795},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":5489},"end":{"line":108,"column":307,"offset":5795},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Before installing the Factory web app, open the ","position":{"start":{"line":110,"column":1,"offset":5797},"end":{"line":110,"column":49,"offset":5845},"indent":[]}},{"type":"inlineCode","value":"./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":110,"column":49,"offset":5845},"end":{"line":110,"column":92,"offset":5888},"indent":[]}},{"type":"text","value":" configuration file. At the of the bottom file you will find two endpoints, similar to the Ingres file bewlwo. Update the hostnames to your own perferred domain, and add these to your DNS server or ","position":{"start":{"line":110,"column":92,"offset":5888},"end":{"line":110,"column":290,"offset":6086},"indent":[]}},{"type":"inlineCode","value":"/etc/hosts","position":{"start":{"line":110,"column":290,"offset":6086},"end":{"line":110,"column":302,"offset":6098},"indent":[]}},{"type":"text","value":" file (pointing to the same IP as the Traefik/Ingress nginx EXTERNAL-IP).","position":{"start":{"line":110,"column":302,"offset":6098},"end":{"line":110,"column":375,"offset":6171},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":5797},"end":{"line":110,"column":375,"offset":6171},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" spec:\n rules:\n--> - host: factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 80\n--> - host: api.factory.domain.com\n http:\n paths:\n - path: /\n backend:\n serviceName: factory\n servicePort: 8081","position":{"start":{"line":112,"column":1,"offset":6173},"end":{"line":127,"column":36,"offset":6605},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Ingress Nginx, do not forgot to comment ","position":{"start":{"line":129,"column":1,"offset":6607},"end":{"line":129,"column":58,"offset":6664},"indent":[]}},{"type":"inlineCode","value":"Traefik","position":{"start":{"line":129,"column":58,"offset":6664},"end":{"line":129,"column":67,"offset":6673},"indent":[]}},{"type":"text","value":" and uncomment ","position":{"start":{"line":129,"column":67,"offset":6673},"end":{"line":129,"column":82,"offset":6688},"indent":[]}},{"type":"inlineCode","value":"Ingress nginx","position":{"start":{"line":129,"column":82,"offset":6688},"end":{"line":129,"column":97,"offset":6703},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":129,"column":97,"offset":6703},"end":{"line":129,"column":98,"offset":6704},"indent":[]}}],"position":{"start":{"line":129,"column":1,"offset":6607},"end":{"line":129,"column":98,"offset":6704},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"apiVersion: extensions/v1beta1\nkind: Ingress\nmetadata:\n name: factory\n annotations:\n #kubernetes.io/ingress.class: traefik\n kubernetes.io/ingress.class: nginx","position":{"start":{"line":131,"column":1,"offset":6706},"end":{"line":137,"column":43,"offset":6900},"indent":[1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.","position":{"start":{"line":139,"column":1,"offset":6902},"end":{"line":139,"column":99,"offset":7000},"indent":[]}}],"position":{"start":{"line":139,"column":1,"offset":6902},"end":{"line":139,"column":99,"offset":7000},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":" - name: MONGODB_USERNAME\n value: \"root\"\n - name: MONGODB_PASSWORD\n--> value: \"xxxxxxxxxx\"","position":{"start":{"line":141,"column":1,"offset":7002},"end":{"line":144,"column":30,"offset":7121},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.","position":{"start":{"line":146,"column":1,"offset":7123},"end":{"line":146,"column":118,"offset":7240},"indent":[]}}],"position":{"start":{"line":146,"column":1,"offset":7123},"end":{"line":146,"column":118,"offset":7240},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"kubectl apply -f ./enterprise/yaml/factory/deployment.yaml","position":{"start":{"line":148,"column":1,"offset":7242},"end":{"line":148,"column":63,"offset":7304},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Test out configuration","position":{"start":{"line":150,"column":4,"offset":7309},"end":{"line":150,"column":26,"offset":7331},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":7306},"end":{"line":150,"column":26,"offset":7331},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If everything worked out as expected, you should now have following services in your cluster:","position":{"start":{"line":152,"column":1,"offset":7333},"end":{"line":152,"column":94,"offset":7426},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":7333},"end":{"line":152,"column":94,"offset":7426},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MongoDB","position":{"start":{"line":154,"column":5,"offset":7432},"end":{"line":154,"column":12,"offset":7439},"indent":[]}}],"position":{"start":{"line":154,"column":5,"offset":7432},"end":{"line":154,"column":12,"offset":7439},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":7428},"end":{"line":154,"column":12,"offset":7439},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Traefik","position":{"start":{"line":155,"column":5,"offset":7444},"end":{"line":155,"column":12,"offset":7451},"indent":[]}}],"position":{"start":{"line":155,"column":5,"offset":7444},"end":{"line":155,"column":12,"offset":7451},"indent":[]}}],"position":{"start":{"line":155,"column":1,"offset":7440},"end":{"line":155,"column":12,"offset":7451},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Factory","position":{"start":{"line":156,"column":5,"offset":7456},"end":{"line":156,"column":12,"offset":7463},"indent":[]}}],"position":{"start":{"line":156,"column":5,"offset":7456},"end":{"line":156,"column":12,"offset":7463},"indent":[]}}],"position":{"start":{"line":156,"column":1,"offset":7452},"end":{"line":156,"column":12,"offset":7463},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":7428},"end":{"line":156,"column":12,"offset":7463},"indent":[1,1]}},{"type":"paragraph","children":[{"type":"text","value":"It should look like this.","position":{"start":{"line":158,"column":1,"offset":7465},"end":{"line":158,"column":26,"offset":7490},"indent":[]}}],"position":{"start":{"line":158,"column":1,"offset":7465},"end":{"line":158,"column":26,"offset":7490},"indent":[]}},{"type":"code","lang":null,"meta":null,"value":"$ kubectl get pods\nNAME READY STATUS RESTARTS AGE\nfactory-6f5c877d7c-hf77p 1/1 Running 0 2d11h\nmongodb-758d5c5ddd-qsfq9 1/1 Running 0 5m31s\ntraefik-7d566ccc47-mwslb 1/1 Running 0 4d12h","position":{"start":{"line":160,"column":1,"offset":7492},"end":{"line":164,"column":73,"offset":7804},"indent":[1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Access the system","position":{"start":{"line":166,"column":4,"offset":7809},"end":{"line":166,"column":21,"offset":7826},"indent":[]}}],"position":{"start":{"line":166,"column":1,"offset":7806},"end":{"line":166,"column":21,"offset":7826},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain ","position":{"start":{"line":168,"column":1,"offset":7828},"end":{"line":168,"column":152,"offset":7979},"indent":[]}},{"type":"inlineCode","value":"factory.domain.com","position":{"start":{"line":168,"column":152,"offset":7979},"end":{"line":168,"column":172,"offset":7999},"indent":[]}},{"type":"text","value":" in your browser you will see the Factory login page showing up.","position":{"start":{"line":168,"column":172,"offset":7999},"end":{"line":168,"column":236,"offset":8063},"indent":[]}}],"position":{"start":{"line":168,"column":1,"offset":7828},"end":{"line":168,"column":236,"offset":8063},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/factory/kerberos-factory-loginpage.png","alt":"Factory","position":{"start":{"line":170,"column":1,"offset":8065},"end":{"line":170,"column":71,"offset":8135},"indent":[]}}],"position":{"start":{"line":170,"column":1,"offset":8065},"end":{"line":170,"column":71,"offset":8135},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":173,"column":1,"offset":8138},"end":{"line":173,"column":31,"offset":8168},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":173,"column":31,"offset":8168}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport ReplaceVersion from \"../components/ReplaceVersion\";\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Introduction`}

\n

{`Start by installing a Kubernetes cluster. This can be done on one of the hyperscalers (`}{`AWS`}{`, `}{`GCP`}{` or `}{`Azure`}{`),\ncloud providers (Digital Ocean, Scaleway, etc) or on-premise in your own private network.`}

\n
\n
\n

\n

{`Installation`}

\n

{`Before setting up Kerberos Enterprise, some configuration needs to happen. First thing that we need to do is setting up the RBAC permissions (Role Based Access Control). We need to enable this to be able to query specific endpoints from the Kubernetes API. By default these endpoints are locked, so we need to unlock them.`}

\n
\n
\n

\n

{`First clone the configrations from our Github repo.`}

\n 
{`git clone https://github.com/kerberos-io/enterprise`}
\n

{`Next go into the directory and execute the first Kubernetes configuration file `}{`clusterrole.yaml`}{`.`}

\n 
{`kubectl create -f ./enterprise/yaml/factory/clusterrole.yaml`}
\n

{`This will make several actions inside your cluster available. We need this to be able to create deployments from the factory web app.`}

\n

{`Helm`}

\n

{`Next we will install a couple of dependencies which are required for Kerberos Enterprise. `}{`Helm`}{` is a package manager for Kubernetes, it helps you setting up services more easily (this could be a MQTT broker, a database, etc).\nInstead of writing yaml files for every service we need, we use so called `}{`Charts`}{` (libraries), that you can reuse and configure the,\nwith the appropriate settings.`}

\n

{`Use one of the preferred OS package managers to install the Helm client:`}

\n 
{`brew install helm`}{`\n`}{`\n`}{`choco install kubernetes-helm`}{`\n`}{`\n`}{`scoop install helm`}{`\n`}{`\n`}{`gofish install helm`}
\n

{`Traefik`}

\n

{`Traefik`}{` is a reverse proxy and load balancer which allows you to expose your deployments more easily. Kerberos uses Traefik to expose it's APIs more easily.`}

\n

{`By executing following helm command, we will install traefik and link it to a specific DNS name. Open the traefik values file, `}{`./enterprise/yaml/traefik/values.yaml`}{`, and update the DNS name to your own domain.`}

\n 
{`    dashboard:`}{`\n`}{`      enabled: true`}{`\n`}{`-->   domain: traefik.domain.com`}{`\n`}{`      serviceType: NodePort`}{`\n`}{`    rbac:`}{`\n`}{`        enabled: true`}
\n

{`Add Helm repository and install traefik.`}

\n 
{`helm repo add stable https://kubernetes-charts.storage.googleapis.com`}{`\n`}{`helm install traefik -f ./enterprise/yaml/traefik/values.yaml stable/traefik`}
\n

{`After installation you should have an IP attached to traefik service, look for it by executing the `}{`get service`}{` command. You will see the ip address in the `}{`EXTERNAL-IP`}{` attribute.`}

\n 
{`kubectl get svc`}{`\n`}{`\n`}{`    NAME                        TYPE           CLUSTER-IP     EXTERNAL-IP     PORT(S)                      AGE`}{`\n`}{`    kubernetes                  ClusterIP      10.0.0.1                 443/TCP                      36h`}{`\n`}{`--> traefik                     LoadBalancer   10.0.27.93     40.114.168.96   443:31623/TCP,80:31804/TCP   35h`}{`\n`}{`    traefik-dashboard           NodePort       10.0.252.6               80:31146/TCP                 35h`}
\n

{`Go to your DNS provider and link the domain you've configured in the first step `}{`traefik.domain.com`}{` to the IP address of the `}{`EXTERNAL-IP`}{` attribute. When browsing to `}{`traefik.domain.com`}{`, you should see the traefik dashboard showing up.`}

\n

{`Ingress-Nginx (alternative for Traefik)`}

\n

{`If you don't like `}{`Traefik`}{` but you prefer `}{`Ingress Nginx`}{`, that works as well.`}

\n 
{`helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx`}{`\n`}{`helm repo update`}{`\n`}{`helm install ingress-nginx ingress-nginx/ingress-nginx`}
\n

{`MongoDB`}

\n

{`When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use `}{`helm `}{`to install a MongoDB instance inside your cluster.`}

\n

{`Have a look into the `}{`yaml/mongodb/values.yaml`}{` file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb.`}

\n 
{`helm repo add bitnami https://charts.bitnami.com/bitnami`}{`\n`}{`helm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values.yaml`}
\n

{`Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps.`}

\n 
{`export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb -o jsonpath=\"{.data.mongodb-root-password}\" | base64 --decode)`}{`\n`}{`echo $MONGODB_ROOT_PASSWORD`}
\n

{`Kerberos Enterprise Web App - The Factory`}

\n

{`The last step is to install the Kerberos Enterprise application. Kerberos Enterprise is managed through an application which we call the `}{`Factory`}{`. It is responsible for initiating the deployments inside your cluster. These deployments is what we also call (similar to the Open Source version) the machinery.`}

\n

{`The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the `}{`kubectl`}{` command.`}

\n

{`Before installing the Factory web app, open the `}{`./enterprise/yaml/factory/deployment.yaml`}{` configuration file. At the of the bottom file you will find two endpoints, similar to the Ingres file bewlwo. Update the hostnames to your own perferred domain, and add these to your DNS server or `}{`/etc/hosts`}{` file (pointing to the same IP as the Traefik/Ingress nginx EXTERNAL-IP).`}

\n 
{`    spec:`}{`\n`}{`      rules:`}{`\n`}{`-->   - host: factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 80`}{`\n`}{`-->   - host: api.factory.domain.com`}{`\n`}{`        http:`}{`\n`}{`          paths:`}{`\n`}{`          - path: /`}{`\n`}{`            backend:`}{`\n`}{`              serviceName: factory`}{`\n`}{`              servicePort: 8081`}
\n

{`If you are using Ingress Nginx, do not forgot to comment `}{`Traefik`}{` and uncomment `}{`Ingress nginx`}{`.`}

\n 
{`apiVersion: extensions/v1beta1`}{`\n`}{`kind: Ingress`}{`\n`}{`metadata:`}{`\n`}{`  name: factory`}{`\n`}{`  annotations:`}{`\n`}{`    #kubernetes.io/ingress.class: traefik`}{`\n`}{`    kubernetes.io/ingress.class: nginx`}
\n

{`Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance.`}

\n 
{`    - name: MONGODB_USERNAME`}{`\n`}{`      value: \"root\"`}{`\n`}{`    - name: MONGODB_PASSWORD`}{`\n`}{`-->   value: \"xxxxxxxxxx\"`}
\n

{`Once you have corrected the DNS names (or internal /etc/hosts file), install the Factory web app inside your cluster.`}

\n 
{`kubectl apply -f ./enterprise/yaml/factory/deployment.yaml`}
\n

{`Test out configuration`}

\n

{`If everything worked out as expected, you should now have following services in your cluster:`}

\n
    \n
  • {`MongoDB`}
    • \n
  • {`Traefik`}
    • \n
  • {`Factory`}
    • \n
\n

{`It should look like this.`}

\n 
{`$ kubectl get pods`}{`\n`}{`NAME                              READY   STATUS    RESTARTS   AGE`}{`\n`}{`factory-6f5c877d7c-hf77p          1/1     Running   0          2d11h`}{`\n`}{`mongodb-758d5c5ddd-qsfq9          1/1     Running   0          5m31s`}{`\n`}{`traefik-7d566ccc47-mwslb          1/1     Running   0          4d12h`}
\n

{`Access the system`}

\n

{`Once everything is configured correctly your cluster and DNS, you should be able to setup the Factory application. By navigating to the Factory domain `}{`factory.domain.com`}{` in your browser you will see the Factory login page showing up.`}

\n

\"Factory\"

\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e8aa2a80b6d8b25efef29267ee82ea19.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e8aa2a80b6d8b25efef29267ee82ea19.json index ddd6618..877bd96 100644 --- a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e8aa2a80b6d8b25efef29267ee82ea19.json +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-e8aa2a80b6d8b25efef29267ee82ea19.json @@ -1 +1 @@ -{"expireTime":9007200861747690000,"key":"gatsby-plugin-mdx-entire-payload-a79531575b5a9e24fdd84c6824bcabed-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import { Playground, Props } from 'docz'","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":41,"offset":199},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":10,"column":3,"offset":203},"end":{"line":10,"column":12,"offset":212},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":201},"end":{"line":10,"column":12,"offset":212},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The machinery is the processing engine of Kerberos Open Source. It's an image processing framework, written in C++, who benefits from other third party libraries (OpenCV, etc). It takes images from the type of camera (USB-, IP- or RPi-camera) you've configured in the configuration files and executes one ore more algorithms and post-processes (e.g. save a snapshot). The configuration files allow you to define the type of camera, post-processes, conditions and much more; it's highly configurable. It's important to note that the machinery, out-of-the-box, can handle only one camera at a time.","position":{"start":{"line":12,"column":1,"offset":214},"end":{"line":12,"column":597,"offset":810},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":214},"end":{"line":12,"column":597,"offset":810},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Project structure","position":{"start":{"line":14,"column":4,"offset":815},"end":{"line":14,"column":21,"offset":832},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":812},"end":{"line":14,"column":21,"offset":832},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The machinery is an image processing framework which is devided into four steps:","position":{"start":{"line":16,"column":1,"offset":834},"end":{"line":16,"column":81,"offset":914},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":834},"end":{"line":16,"column":81,"offset":914},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"condition","position":{"start":{"line":18,"column":3,"offset":918},"end":{"line":18,"column":12,"offset":927},"indent":[]}}],"position":{"start":{"line":18,"column":3,"offset":918},"end":{"line":18,"column":12,"offset":927},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":916},"end":{"line":18,"column":12,"offset":927},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"algorithm","position":{"start":{"line":19,"column":3,"offset":930},"end":{"line":19,"column":12,"offset":939},"indent":[]}}],"position":{"start":{"line":19,"column":3,"offset":930},"end":{"line":19,"column":12,"offset":939},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":928},"end":{"line":19,"column":12,"offset":939},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"expositor","position":{"start":{"line":20,"column":3,"offset":942},"end":{"line":20,"column":12,"offset":951},"indent":[]}}],"position":{"start":{"line":20,"column":3,"offset":942},"end":{"line":20,"column":12,"offset":951},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":940},"end":{"line":20,"column":12,"offset":951},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"heuristic","position":{"start":{"line":21,"column":3,"offset":954},"end":{"line":21,"column":12,"offset":963},"indent":[]}}],"position":{"start":{"line":21,"column":3,"offset":954},"end":{"line":21,"column":12,"offset":963},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":952},"end":{"line":21,"column":12,"offset":963},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":916},"end":{"line":21,"column":12,"offset":963},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"The steps belong to a four passway; illustrated on the image below. In each cycle a sequence of images is processed. Each step will process the sequence, and will return some result to the next step. For example: an algorithm will process the images and returns an array to the Expositor, which contains boolean values. The steps are loosly coupled, so they have simple conventions, just like the example before.","position":{"start":{"line":23,"column":1,"offset":965},"end":{"line":23,"column":413,"offset":1377},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":965},"end":{"line":23,"column":413,"offset":1377},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Thanks to the loosly coupling, each step can be developed indepently. So algorithms, expositors, heuristics and conditions can be switched on the fly. This makes it easier for other developers who want to contribute to the machinery. They can create a new algorithm without knowing how a specific expositor or heuristic works. They just need to be aware of the convention an algorithm should meet.","position":{"start":{"line":25,"column":1,"offset":1379},"end":{"line":25,"column":398,"offset":1776},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1379},"end":{"line":25,"column":398,"offset":1776},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/machinery/project_structure.png","alt":"machinery project structure","position":{"start":{"line":27,"column":1,"offset":1778},"end":{"line":27,"column":84,"offset":1861},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1778},"end":{"line":27,"column":84,"offset":1861},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"These different steps can be configured by editing a couple of configurationn files located at ","position":{"start":{"line":29,"column":1,"offset":1863},"end":{"line":29,"column":96,"offset":1958},"indent":[]}},{"type":"inlineCode","value":"config/","position":{"start":{"line":29,"column":96,"offset":1958},"end":{"line":29,"column":105,"offset":1967},"indent":[]}},{"type":"text","value":". The main configuration file ","position":{"start":{"line":29,"column":105,"offset":1967},"end":{"line":29,"column":135,"offset":1997},"indent":[]}},{"type":"inlineCode","value":"config/config.xml","position":{"start":{"line":29,"column":135,"offset":1997},"end":{"line":29,"column":154,"offset":2016},"indent":[]}},{"type":"text","value":" looks like this:","position":{"start":{"line":29,"column":154,"offset":2016},"end":{"line":29,"column":171,"offset":2033},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1863},"end":{"line":29,"column":171,"offset":2033},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n frontdoor\n false\n Europe-Brussels\n RaspiCamera\n Mjpg\n Enabled\n DifferentialCollins\n Hull\n Sequence\n Video\n S3\n \n","position":{"start":{"line":31,"column":1,"offset":2035},"end":{"line":48,"column":4,"offset":2690},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Capture","position":{"start":{"line":50,"column":4,"offset":2695},"end":{"line":50,"column":11,"offset":2702},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2692},"end":{"line":50,"column":11,"offset":2702},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can choose which capture device you will be using, you can use your old USB webcam, the popular Raspberry Pi camera or a state-of-the-art IP camera. The capture device will take pictures and deliver them to the algorithm if the conditions (the first step of the four passway) are valid.","position":{"start":{"line":52,"column":1,"offset":2704},"end":{"line":52,"column":291,"offset":2994},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":2704},"end":{"line":52,"column":291,"offset":2994},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can change the capture device by changing the ","position":{"start":{"line":54,"column":1,"offset":2996},"end":{"line":54,"column":51,"offset":3046},"indent":[]}},{"type":"inlineCode","value":"config/config.xml","position":{"start":{"line":54,"column":51,"offset":3046},"end":{"line":54,"column":70,"offset":3065},"indent":[]}},{"type":"text","value":" file, and choose one of the following:","position":{"start":{"line":54,"column":70,"offset":3065},"end":{"line":54,"column":109,"offset":3104},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":2996},"end":{"line":54,"column":109,"offset":3104},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"USBCamera","position":{"start":{"line":55,"column":3,"offset":3107},"end":{"line":55,"column":12,"offset":3116},"indent":[]}}],"position":{"start":{"line":55,"column":3,"offset":3107},"end":{"line":55,"column":12,"offset":3116},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":3105},"end":{"line":55,"column":12,"offset":3116},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"RaspiCamera","position":{"start":{"line":56,"column":3,"offset":3119},"end":{"line":56,"column":14,"offset":3130},"indent":[]}}],"position":{"start":{"line":56,"column":3,"offset":3119},"end":{"line":56,"column":14,"offset":3130},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3117},"end":{"line":56,"column":14,"offset":3130},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"IPCamera","position":{"start":{"line":57,"column":3,"offset":3133},"end":{"line":57,"column":11,"offset":3141},"indent":[]}}],"position":{"start":{"line":57,"column":3,"offset":3133},"end":{"line":57,"column":11,"offset":3141},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":3131},"end":{"line":57,"column":11,"offset":3141},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":3105},"end":{"line":57,"column":11,"offset":3141},"indent":[1,1]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n ...\n RaspiCamera\n ...\n \n","position":{"start":{"line":59,"column":1,"offset":3143},"end":{"line":68,"column":4,"offset":3295},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"USB camera","position":{"start":{"line":70,"column":5,"offset":3301},"end":{"line":70,"column":15,"offset":3311},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":3297},"end":{"line":70,"column":15,"offset":3311},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The machinery supports a whole range of USB cameras. You will find a complete list here. Make sure you have updated the web interface, to make the machinery aware you will be using an USB camera.","position":{"start":{"line":72,"column":1,"offset":3313},"end":{"line":72,"column":196,"offset":3508},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3313},"end":{"line":72,"column":196,"offset":3508},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":74,"column":6,"offset":3515},"end":{"line":74,"column":16,"offset":3525},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":3510},"end":{"line":74,"column":16,"offset":3525},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the USB camera can be found in the ","position":{"start":{"line":76,"column":1,"offset":3527},"end":{"line":76,"column":54,"offset":3580},"indent":[]}},{"type":"inlineCode","value":"config/capture.xml","position":{"start":{"line":76,"column":54,"offset":3580},"end":{"line":76,"column":74,"offset":3600},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":76,"column":74,"offset":3600},"end":{"line":76,"column":179,"offset":3705},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":3527},"end":{"line":76,"column":179,"offset":3705},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n 1280\n 720\n 0\n 0\n 0\n \n","position":{"start":{"line":78,"column":1,"offset":3707},"end":{"line":88,"column":4,"offset":3985},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Framewidth and -height","position":{"start":{"line":90,"column":7,"offset":3993},"end":{"line":90,"column":29,"offset":4015},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":3987},"end":{"line":90,"column":29,"offset":4015},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can set the resolution of the capture device, make sure the resolution you've defined is valid with your camera. Please check the specs of the USB camera you're using.","position":{"start":{"line":92,"column":1,"offset":4017},"end":{"line":92,"column":172,"offset":4188},"indent":[]}}],"position":{"start":{"line":92,"column":1,"offset":4017},"end":{"line":92,"column":172,"offset":4188},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Device number","position":{"start":{"line":94,"column":7,"offset":4196},"end":{"line":94,"column":20,"offset":4209},"indent":[]}}],"position":{"start":{"line":94,"column":1,"offset":4190},"end":{"line":94,"column":20,"offset":4209},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If more than one device is connected, you can specify the index of the USB-camera. The index is an integer (1-5).","position":{"start":{"line":96,"column":1,"offset":4211},"end":{"line":96,"column":114,"offset":4324},"indent":[]}}],"position":{"start":{"line":96,"column":1,"offset":4211},"end":{"line":96,"column":114,"offset":4324},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Delay","position":{"start":{"line":98,"column":7,"offset":4332},"end":{"line":98,"column":12,"offset":4337},"indent":[]}}],"position":{"start":{"line":98,"column":1,"offset":4326},"end":{"line":98,"column":12,"offset":4337},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can provide a delay/interval (milliseconds) between two captures.","position":{"start":{"line":100,"column":1,"offset":4339},"end":{"line":100,"column":70,"offset":4408},"indent":[]}}],"position":{"start":{"line":100,"column":1,"offset":4339},"end":{"line":100,"column":70,"offset":4408},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Angle","position":{"start":{"line":102,"column":7,"offset":4416},"end":{"line":102,"column":12,"offset":4421},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":4410},"end":{"line":102,"column":12,"offset":4421},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By defining an angle (degrees), you can rotate the images taken by the capture device. For example if you would mount the camera upside down, than you could enter the value 180 as the angle; this will flip the images.","position":{"start":{"line":104,"column":1,"offset":4423},"end":{"line":104,"column":218,"offset":4640},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":4423},"end":{"line":104,"column":218,"offset":4640},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Raspberry Pi Camera Module","position":{"start":{"line":106,"column":5,"offset":4646},"end":{"line":106,"column":31,"offset":4672},"indent":[]}}],"position":{"start":{"line":106,"column":1,"offset":4642},"end":{"line":106,"column":31,"offset":4672},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can use the Raspberry Pi Camera Module with the machinery. You just need to attach the camera module and you're ready to go. The Raspberry Pi Camera Module is enabled by default in the web.","position":{"start":{"line":108,"column":1,"offset":4674},"end":{"line":108,"column":194,"offset":4867},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":4674},"end":{"line":108,"column":194,"offset":4867},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":110,"column":6,"offset":4874},"end":{"line":110,"column":16,"offset":4884},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":4869},"end":{"line":110,"column":16,"offset":4884},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Raspberry Pi Camera Module can be found in the config/capture.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":112,"column":1,"offset":4886},"end":{"line":112,"column":193,"offset":5078},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":4886},"end":{"line":112,"column":193,"offset":5078},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n 640\n 480\n 1400\n 0\n 30\n 0\n 0\n 0\n 50\n \n","position":{"start":{"line":114,"column":1,"offset":5080},"end":{"line":128,"column":4,"offset":5534},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Framewidth and -height","position":{"start":{"line":130,"column":7,"offset":5542},"end":{"line":130,"column":29,"offset":5564},"indent":[]}}],"position":{"start":{"line":130,"column":1,"offset":5536},"end":{"line":130,"column":29,"offset":5564},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can set the resolution of the camera module, make sure the resolution you've defined is valid.","position":{"start":{"line":132,"column":1,"offset":5566},"end":{"line":132,"column":99,"offset":5664},"indent":[]}}],"position":{"start":{"line":132,"column":1,"offset":5566},"end":{"line":132,"column":99,"offset":5664},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Delay","position":{"start":{"line":134,"column":7,"offset":5672},"end":{"line":134,"column":12,"offset":5677},"indent":[]}}],"position":{"start":{"line":134,"column":1,"offset":5666},"end":{"line":134,"column":12,"offset":5677},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can provide a delay/interval (milliseconds) between two captures.","position":{"start":{"line":136,"column":1,"offset":5679},"end":{"line":136,"column":70,"offset":5748},"indent":[]}}],"position":{"start":{"line":136,"column":1,"offset":5679},"end":{"line":136,"column":70,"offset":5748},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Angle","position":{"start":{"line":138,"column":7,"offset":5756},"end":{"line":138,"column":12,"offset":5761},"indent":[]}}],"position":{"start":{"line":138,"column":1,"offset":5750},"end":{"line":138,"column":12,"offset":5761},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By defining an angle (degrees), you can rotate the images taken by the capture device. For example if you would mount the camera upside down, than you could enter the value 180 as the angle; this will flip the images.","position":{"start":{"line":140,"column":1,"offset":5763},"end":{"line":140,"column":218,"offset":5980},"indent":[]}}],"position":{"start":{"line":140,"column":1,"offset":5763},"end":{"line":140,"column":218,"offset":5980},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Framerate","position":{"start":{"line":142,"column":7,"offset":5988},"end":{"line":142,"column":16,"offset":5997},"indent":[]}}],"position":{"start":{"line":142,"column":1,"offset":5982},"end":{"line":142,"column":16,"offset":5997},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The number of frames captures per second. Please note that this parameter will also be used if you're recording video. E.g. if you set this parameter to 20, you're recorded videos will also be 20 FPS.","position":{"start":{"line":144,"column":1,"offset":5999},"end":{"line":144,"column":201,"offset":6199},"indent":[]}}],"position":{"start":{"line":144,"column":1,"offset":5999},"end":{"line":144,"column":201,"offset":6199},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Sharpness, saturation, contrast, brightness","position":{"start":{"line":146,"column":7,"offset":6207},"end":{"line":146,"column":50,"offset":6250},"indent":[]}}],"position":{"start":{"line":146,"column":1,"offset":6201},"end":{"line":146,"column":50,"offset":6250},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Camera properties which you can specify to tune the settings to your needs.","position":{"start":{"line":148,"column":1,"offset":6252},"end":{"line":148,"column":76,"offset":6327},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":6252},"end":{"line":148,"column":76,"offset":6327},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"IP camera","position":{"start":{"line":150,"column":5,"offset":6333},"end":{"line":150,"column":14,"offset":6342},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":6329},"end":{"line":150,"column":14,"offset":6342},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The machinery can be used with any IP camera, that provides a RTSP (or MJPEG) stream. Make sure that you know the correct URL of your IP camera, you can ","position":{"start":{"line":152,"column":1,"offset":6344},"end":{"line":152,"column":154,"offset":6497},"indent":[]}},{"type":"link","title":null,"url":"http://www.ispyconnect.com/sources.aspx","children":[{"type":"text","value":"find a list here","position":{"start":{"line":152,"column":155,"offset":6498},"end":{"line":152,"column":171,"offset":6514},"indent":[]}}],"position":{"start":{"line":152,"column":154,"offset":6497},"end":{"line":152,"column":213,"offset":6556},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":152,"column":213,"offset":6556},"end":{"line":152,"column":214,"offset":6557},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":6344},"end":{"line":152,"column":214,"offset":6557},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":154,"column":6,"offset":6564},"end":{"line":154,"column":16,"offset":6574},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":6559},"end":{"line":154,"column":16,"offset":6574},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the IP capture device can be found in the ","position":{"start":{"line":156,"column":1,"offset":6576},"end":{"line":156,"column":61,"offset":6636},"indent":[]}},{"type":"inlineCode","value":"config/capture.xml","position":{"start":{"line":156,"column":61,"offset":6636},"end":{"line":156,"column":81,"offset":6656},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":156,"column":81,"offset":6656},"end":{"line":156,"column":186,"offset":6761},"indent":[]}}],"position":{"start":{"line":156,"column":1,"offset":6576},"end":{"line":156,"column":186,"offset":6761},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n http://username:password@ipaddress/image.jpg\n 800\n 640\n 0\n 0\n \n","position":{"start":{"line":158,"column":1,"offset":6763},"end":{"line":168,"column":4,"offset":7061},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"URL","position":{"start":{"line":170,"column":7,"offset":7069},"end":{"line":170,"column":10,"offset":7072},"indent":[]}}],"position":{"start":{"line":170,"column":1,"offset":7063},"end":{"line":170,"column":10,"offset":7072},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To use your IP camera, you should provide a valid RTSP (or MJPEG) URL. The machinery will take snapshots from this stream.","position":{"start":{"line":172,"column":1,"offset":7074},"end":{"line":172,"column":123,"offset":7196},"indent":[]}}],"position":{"start":{"line":172,"column":1,"offset":7074},"end":{"line":172,"column":123,"offset":7196},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Framewidth and -height","position":{"start":{"line":174,"column":7,"offset":7204},"end":{"line":174,"column":29,"offset":7226},"indent":[]}}],"position":{"start":{"line":174,"column":1,"offset":7198},"end":{"line":174,"column":29,"offset":7226},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can set the resolution of the capture device, make sure the resolution you've defined is equal to the resolution you've defined in your IP-camera software.","position":{"start":{"line":176,"column":1,"offset":7228},"end":{"line":176,"column":160,"offset":7387},"indent":[]}}],"position":{"start":{"line":176,"column":1,"offset":7228},"end":{"line":176,"column":160,"offset":7387},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Delay","position":{"start":{"line":178,"column":7,"offset":7395},"end":{"line":178,"column":12,"offset":7400},"indent":[]}}],"position":{"start":{"line":178,"column":1,"offset":7389},"end":{"line":178,"column":12,"offset":7400},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can provide a delay/interval (milliseconds) between two captures.","position":{"start":{"line":180,"column":1,"offset":7402},"end":{"line":180,"column":70,"offset":7471},"indent":[]}}],"position":{"start":{"line":180,"column":1,"offset":7402},"end":{"line":180,"column":70,"offset":7471},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Angle","position":{"start":{"line":182,"column":7,"offset":7479},"end":{"line":182,"column":12,"offset":7484},"indent":[]}}],"position":{"start":{"line":182,"column":1,"offset":7473},"end":{"line":182,"column":12,"offset":7484},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By defining an angle (degrees), you can rotate the images taken by the capture device. For example if you would mount the camera upside down, than you could enter the value 180 as the angle; this will flip the images.","position":{"start":{"line":184,"column":1,"offset":7486},"end":{"line":184,"column":218,"offset":7703},"indent":[]}}],"position":{"start":{"line":184,"column":1,"offset":7486},"end":{"line":184,"column":218,"offset":7703},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Condition","position":{"start":{"line":186,"column":4,"offset":7708},"end":{"line":186,"column":13,"offset":7717},"indent":[]}}],"position":{"start":{"line":186,"column":1,"offset":7705},"end":{"line":186,"column":13,"offset":7717},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The condition is the first step of the four passway. In this step the machinery will determine if it's allowed to proceed to the next step. For example a condition can be a time constraint, a brightness threshold, etc; multiple conditions can be selected.","position":{"start":{"line":188,"column":1,"offset":7719},"end":{"line":188,"column":256,"offset":7974},"indent":[]}}],"position":{"start":{"line":188,"column":1,"offset":7719},"end":{"line":188,"column":256,"offset":7974},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n ...\n Enabled\n ...\n \n","position":{"start":{"line":190,"column":1,"offset":7976},"end":{"line":199,"column":4,"offset":8146},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Enabled","position":{"start":{"line":201,"column":5,"offset":8152},"end":{"line":201,"column":12,"offset":8159},"indent":[]}}],"position":{"start":{"line":201,"column":1,"offset":8148},"end":{"line":201,"column":12,"offset":8159},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"It can be helpful to enable or disable the machinery at specific times. Therefore the time condition makes it possible to select a time range for each day of the week. When the current time is within the time range, the machinery will be enabled.","position":{"start":{"line":203,"column":1,"offset":8161},"end":{"line":203,"column":247,"offset":8407},"indent":[]}}],"position":{"start":{"line":203,"column":1,"offset":8161},"end":{"line":203,"column":247,"offset":8407},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":205,"column":6,"offset":8414},"end":{"line":205,"column":16,"offset":8424},"indent":[]}}],"position":{"start":{"line":205,"column":1,"offset":8409},"end":{"line":205,"column":16,"offset":8424},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Enabled condition can be found in the ","position":{"start":{"line":207,"column":1,"offset":8426},"end":{"line":207,"column":61,"offset":8486},"indent":[]}},{"type":"inlineCode","value":"config/condition.xml","position":{"start":{"line":207,"column":61,"offset":8486},"end":{"line":207,"column":83,"offset":8508},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":207,"column":83,"offset":8508},"end":{"line":207,"column":188,"offset":8613},"indent":[]}}],"position":{"start":{"line":207,"column":1,"offset":8426},"end":{"line":207,"column":188,"offset":8613},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n true\n 5000\n \n","position":{"start":{"line":209,"column":1,"offset":8615},"end":{"line":216,"column":4,"offset":8753},"indent":[1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Active","position":{"start":{"line":218,"column":7,"offset":8761},"end":{"line":218,"column":13,"offset":8767},"indent":[]}}],"position":{"start":{"line":218,"column":1,"offset":8755},"end":{"line":218,"column":13,"offset":8767},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The active field is boolean value (true/false). When the active field is true, the machinery is enabled, if not it's disabled.","position":{"start":{"line":220,"column":1,"offset":8769},"end":{"line":220,"column":127,"offset":8895},"indent":[]}}],"position":{"start":{"line":220,"column":1,"offset":8769},"end":{"line":220,"column":127,"offset":8895},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Delay","position":{"start":{"line":222,"column":7,"offset":8903},"end":{"line":222,"column":12,"offset":8908},"indent":[]}}],"position":{"start":{"line":222,"column":1,"offset":8897},"end":{"line":222,"column":12,"offset":8908},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The delay value is used when the condition failed, so when the current time isn't in the selected time range for that day. In that case the machinery will idle for the specified delay time. The value of the delay is expressed in miliseconds.","position":{"start":{"line":224,"column":1,"offset":8910},"end":{"line":224,"column":242,"offset":9151},"indent":[]}}],"position":{"start":{"line":224,"column":1,"offset":8910},"end":{"line":224,"column":242,"offset":9151},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Time","position":{"start":{"line":226,"column":5,"offset":9157},"end":{"line":226,"column":9,"offset":9161},"indent":[]}}],"position":{"start":{"line":226,"column":1,"offset":9153},"end":{"line":226,"column":9,"offset":9161},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"It can be helpful to enable or disable the machinery at specific times. Therefore the time condition makes it possible to select a time range for each day of the week. When the current time is within the time range, the machinery will be enabled.","position":{"start":{"line":228,"column":1,"offset":9163},"end":{"line":228,"column":247,"offset":9409},"indent":[]}}],"position":{"start":{"line":228,"column":1,"offset":9163},"end":{"line":228,"column":247,"offset":9409},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":230,"column":6,"offset":9416},"end":{"line":230,"column":16,"offset":9426},"indent":[]}}],"position":{"start":{"line":230,"column":1,"offset":9411},"end":{"line":230,"column":16,"offset":9426},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Time condition can be found in the ","position":{"start":{"line":232,"column":1,"offset":9428},"end":{"line":232,"column":58,"offset":9485},"indent":[]}},{"type":"inlineCode","value":"config/condition.xml","position":{"start":{"line":232,"column":58,"offset":9485},"end":{"line":232,"column":80,"offset":9507},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":232,"column":80,"offset":9507},"end":{"line":232,"column":185,"offset":9612},"indent":[]}}],"position":{"start":{"line":232,"column":1,"offset":9428},"end":{"line":232,"column":185,"offset":9612},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n","position":{"start":{"line":234,"column":1,"offset":9614},"end":{"line":241,"column":4,"offset":9813},"indent":[1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Times","position":{"start":{"line":243,"column":7,"offset":9821},"end":{"line":243,"column":12,"offset":9826},"indent":[]}}],"position":{"start":{"line":243,"column":1,"offset":9815},"end":{"line":243,"column":12,"offset":9826},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The times property contains a list of times, delimited by a \"-\". The first item in the list will specify the time range for the first day of the week (Monday), the last item for the last day of the week (Sunday). The begin- and end-time, for a specific day, are delimited by a \",\" where the first element will specify that start time and the second one specifies the end time.","position":{"start":{"line":245,"column":1,"offset":9828},"end":{"line":245,"column":377,"offset":10204},"indent":[]}}],"position":{"start":{"line":245,"column":1,"offset":9828},"end":{"line":245,"column":377,"offset":10204},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Delay","position":{"start":{"line":247,"column":7,"offset":10212},"end":{"line":247,"column":12,"offset":10217},"indent":[]}}],"position":{"start":{"line":247,"column":1,"offset":10206},"end":{"line":247,"column":12,"offset":10217},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The delay value is used when the condition failed, so when the current time isn't in the selected time range for that day. In that case the machinery will idle for the specified delay time. The value of the delay is expressed in miliseconds.","position":{"start":{"line":249,"column":1,"offset":10219},"end":{"line":249,"column":242,"offset":10460},"indent":[]}}],"position":{"start":{"line":249,"column":1,"offset":10219},"end":{"line":249,"column":242,"offset":10460},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Algorithm","position":{"start":{"line":251,"column":4,"offset":10465},"end":{"line":251,"column":13,"offset":10474},"indent":[]}}],"position":{"start":{"line":251,"column":1,"offset":10462},"end":{"line":251,"column":13,"offset":10474},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The algorithm is the second step of the four passway. An algorithm will execute some kind of function on a sequence of images, and end up with a black and white image; just like the image below. An example of an algorithm would be one that does motion detection or one that would detect cats or dogs (using TensorFlow, ar any other Deep Learning framework).","position":{"start":{"line":253,"column":1,"offset":10476},"end":{"line":253,"column":358,"offset":10833},"indent":[]}}],"position":{"start":{"line":253,"column":1,"offset":10476},"end":{"line":253,"column":358,"offset":10833},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/machinery/algorithm.png","alt":"machinery algorithm","position":{"start":{"line":255,"column":1,"offset":10835},"end":{"line":255,"column":68,"offset":10902},"indent":[]}}],"position":{"start":{"line":255,"column":1,"offset":10835},"end":{"line":255,"column":68,"offset":10902},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The white pixels on the image will indicate the object of interest. For example, when looking for motion, the pixels that have been changed; it depends on what the algorithm is looking for. The black pixels are background pixels.","position":{"start":{"line":257,"column":1,"offset":10904},"end":{"line":257,"column":230,"offset":11133},"indent":[]}}],"position":{"start":{"line":257,"column":1,"offset":10904},"end":{"line":257,"column":230,"offset":11133},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The only convention that an algorithm should meet is that it should return a black and white image to the next step; the expositor. And of course that it requires a sequence of images as a parameter. Besides those conventions, an algorithm can do everything it wants to do. So you could create your own cat detection algorithm, marker detection, etc.","position":{"start":{"line":259,"column":1,"offset":11135},"end":{"line":259,"column":351,"offset":11485},"indent":[]}}],"position":{"start":{"line":259,"column":1,"offset":11135},"end":{"line":259,"column":351,"offset":11485},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can select the algortihm in the ","position":{"start":{"line":261,"column":1,"offset":11487},"end":{"line":261,"column":37,"offset":11523},"indent":[]}},{"type":"inlineCode","value":"config/config.xml","position":{"start":{"line":261,"column":37,"offset":11523},"end":{"line":261,"column":56,"offset":11542},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":261,"column":56,"offset":11542},"end":{"line":261,"column":57,"offset":11543},"indent":[]}}],"position":{"start":{"line":261,"column":1,"offset":11487},"end":{"line":261,"column":57,"offset":11543},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n ...\n DifferentialCollins\n ...\n \n","position":{"start":{"line":263,"column":1,"offset":11545},"end":{"line":272,"column":4,"offset":11711},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Differential images","position":{"start":{"line":274,"column":5,"offset":11717},"end":{"line":274,"column":24,"offset":11736},"indent":[]}}],"position":{"start":{"line":274,"column":1,"offset":11713},"end":{"line":274,"column":24,"offset":11736},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This algorithm is a very simple method to detect motion; in terms of understanding but also processing. Just like the name says, it's the result of comparing images. When the images are compared, we know the pixels that have been changed and if the amount of pixels that changed is big enough, one can say that something happened and thus motion was detected.","position":{"start":{"line":276,"column":1,"offset":11738},"end":{"line":276,"column":360,"offset":12097},"indent":[]}}],"position":{"start":{"line":276,"column":1,"offset":11738},"end":{"line":276,"column":360,"offset":12097},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To get a more technical explanation: the algoritm will substract 2 or more images, and once that is done it will end up with a black and white image. The white pixels will mark the pixels that where different/changed and the black pixels are the pixels that have not changed; background pixels. Please note that there are several different combinations of substracting images. However for the machinery, we will use the method of Collins et al. as this method erases the phenomenon \"ghosting\".","position":{"start":{"line":278,"column":1,"offset":12099},"end":{"line":278,"column":494,"offset":12592},"indent":[]}}],"position":{"start":{"line":278,"column":1,"offset":12099},"end":{"line":278,"column":494,"offset":12592},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/machinery/differential_images.png","alt":"machinery differential","position":{"start":{"line":280,"column":1,"offset":12594},"end":{"line":280,"column":81,"offset":12674},"indent":[]}}],"position":{"start":{"line":280,"column":1,"offset":12594},"end":{"line":280,"column":81,"offset":12674},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In the image above the method of Collins et al. is illustrated. For this method we will process three images. The images are a sequence (from left to right), so the first (A) image was taken before the second (B) one, and the second (B) before the third (C) one. Next we will do a first comparision (C-B) of the third (C) image and the second (B) image, and after that we will do a second comparison (C-A) of the third (C) image and first (A) image.","position":{"start":{"line":282,"column":1,"offset":12676},"end":{"line":282,"column":450,"offset":13125},"indent":[]}}],"position":{"start":{"line":282,"column":1,"offset":12676},"end":{"line":282,"column":450,"offset":13125},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After the comparison we will end up with two difference images (C-B) and (C-A); both will mark the white pixels as changed pixels and black as non-changed pixels. To finish the algorithm we will do a logical AND-operation of the two difference images; this will give us the final black and white image ((C-B)&&(C-A)).","position":{"start":{"line":284,"column":1,"offset":13127},"end":{"line":284,"column":318,"offset":13444},"indent":[]}}],"position":{"start":{"line":284,"column":1,"offset":13127},"end":{"line":284,"column":318,"offset":13444},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The main idea of the Colins et al. method, is that it will erase \"ghosting\". In the last step we are doing a logical AND-operation, by doing this we will only keep the pixels, that changed in the first two images; therefore we can elimante false positives.","position":{"start":{"line":286,"column":1,"offset":13446},"end":{"line":286,"column":257,"offset":13702},"indent":[]}}],"position":{"start":{"line":286,"column":1,"offset":13446},"end":{"line":286,"column":257,"offset":13702},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":288,"column":6,"offset":13709},"end":{"line":288,"column":16,"offset":13719},"indent":[]}}],"position":{"start":{"line":288,"column":1,"offset":13704},"end":{"line":288,"column":16,"offset":13719},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Differential images algorithm can be found in the config/algorithm.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":290,"column":1,"offset":13721},"end":{"line":290,"column":198,"offset":13918},"indent":[]}}],"position":{"start":{"line":290,"column":1,"offset":13721},"end":{"line":290,"column":198,"offset":13918},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n 5\n 20\n \n","position":{"start":{"line":292,"column":1,"offset":13920},"end":{"line":299,"column":4,"offset":14085},"indent":[1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Erode","position":{"start":{"line":301,"column":7,"offset":14093},"end":{"line":301,"column":12,"offset":14098},"indent":[]}}],"position":{"start":{"line":301,"column":1,"offset":14087},"end":{"line":301,"column":12,"offset":14098},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The erode parameter represents a structural element (a morphological operation), which will be used to minimize the changed pixels; more information about eroding can be found here. The idea of the eroding is that pixels which are isolated will be removed; this means that when only one pixel changed, that pixel will reverted to the non-changed state. But for example when a large change happens and a lot of adjacent pixels are changed, the eroding will not be able to revert them.","position":{"start":{"line":303,"column":1,"offset":14100},"end":{"line":303,"column":484,"offset":14583},"indent":[]}}],"position":{"start":{"line":303,"column":1,"offset":14100},"end":{"line":303,"column":484,"offset":14583},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The higher the number of the erode parameter, the more aggressive the eroding will be. So high erode values, will make it possible that also large changes will be reverted to the non-changed state.","position":{"start":{"line":305,"column":1,"offset":14585},"end":{"line":305,"column":198,"offset":14782},"indent":[]}}],"position":{"start":{"line":305,"column":1,"offset":14585},"end":{"line":305,"column":198,"offset":14782},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Threshold","position":{"start":{"line":307,"column":7,"offset":14790},"end":{"line":307,"column":16,"offset":14799},"indent":[]}}],"position":{"start":{"line":307,"column":1,"offset":14784},"end":{"line":307,"column":16,"offset":14799},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When doing the comparison of two images, we won't end up with a clean black and white image. In most of the cases the values will be between 0 and 255; so gray values. This means that the value 0 will mean that both pixels where the same in both image, and values 255 mean that both pixels where totally different in both images. Of course we will also have values between 0-255, so pixels that are a little bit different in both images. So to make the resulting black and white image, we will need to apply a threshold value.","position":{"start":{"line":309,"column":1,"offset":14801},"end":{"line":309,"column":527,"offset":15327},"indent":[]}}],"position":{"start":{"line":309,"column":1,"offset":14801},"end":{"line":309,"column":527,"offset":15327},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The threshold will specify how much a pixel has to be different in the two images. So for example when the threshold is 30, it means that the difference between two pixels has to be equal or more then 30. The higher the threshold the more the pixel needs to be different, to be marked as changed.","position":{"start":{"line":311,"column":1,"offset":15329},"end":{"line":311,"column":297,"offset":15625},"indent":[]}}],"position":{"start":{"line":311,"column":1,"offset":15329},"end":{"line":311,"column":297,"offset":15625},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Expositor","position":{"start":{"line":313,"column":4,"offset":15630},"end":{"line":313,"column":13,"offset":15639},"indent":[]}}],"position":{"start":{"line":313,"column":1,"offset":15627},"end":{"line":313,"column":13,"offset":15639},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After the algorithm is executed, the expositor will determine, a region, where the changes were detected. An expositor can constrain a region in terms of selecting a hull or defining a rectangle.","position":{"start":{"line":315,"column":1,"offset":15641},"end":{"line":315,"column":196,"offset":15836},"indent":[]}}],"position":{"start":{"line":315,"column":1,"offset":15641},"end":{"line":315,"column":196,"offset":15836},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"An expositor receives a black and white image as parameter and should modify a JSON object with all the information it processed. The JSON object must include: the bounding rectangle(s) of the positions where the pixels of interest are located and the number of pixels of interest. But can also include other optional parameters.","position":{"start":{"line":317,"column":1,"offset":15838},"end":{"line":317,"column":330,"offset":16167},"indent":[]}}],"position":{"start":{"line":317,"column":1,"offset":15838},"end":{"line":317,"column":330,"offset":16167},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can change the expositor by changing the ","position":{"start":{"line":319,"column":1,"offset":16169},"end":{"line":319,"column":46,"offset":16214},"indent":[]}},{"type":"inlineCode","value":"config/config.xml","position":{"start":{"line":319,"column":46,"offset":16214},"end":{"line":319,"column":65,"offset":16233},"indent":[]}},{"type":"text","value":" file, and choose one of the following:","position":{"start":{"line":319,"column":65,"offset":16233},"end":{"line":319,"column":104,"offset":16272},"indent":[]}}],"position":{"start":{"line":319,"column":1,"offset":16169},"end":{"line":319,"column":104,"offset":16272},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Hull","position":{"start":{"line":320,"column":3,"offset":16275},"end":{"line":320,"column":7,"offset":16279},"indent":[]}}],"position":{"start":{"line":320,"column":3,"offset":16275},"end":{"line":320,"column":7,"offset":16279},"indent":[]}}],"position":{"start":{"line":320,"column":1,"offset":16273},"end":{"line":320,"column":7,"offset":16279},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Rectangle","position":{"start":{"line":321,"column":3,"offset":16282},"end":{"line":321,"column":12,"offset":16291},"indent":[]}}],"position":{"start":{"line":321,"column":3,"offset":16282},"end":{"line":321,"column":12,"offset":16291},"indent":[]}}],"position":{"start":{"line":321,"column":1,"offset":16280},"end":{"line":321,"column":12,"offset":16291},"indent":[]}}],"position":{"start":{"line":320,"column":1,"offset":16273},"end":{"line":321,"column":12,"offset":16291},"indent":[1]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n ...\n Hull\n ...\n \n","position":{"start":{"line":323,"column":1,"offset":16293},"end":{"line":332,"column":4,"offset":16444},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Rectangle","position":{"start":{"line":334,"column":5,"offset":16450},"end":{"line":334,"column":14,"offset":16459},"indent":[]}}],"position":{"start":{"line":334,"column":1,"offset":16446},"end":{"line":334,"column":14,"offset":16459},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This is a trivial expositor. A rectangle region can be defined to constrain the locations of pixels of interest. The rectangle repositor will return the region of the pixels of interest.","position":{"start":{"line":336,"column":1,"offset":16461},"end":{"line":336,"column":187,"offset":16647},"indent":[]}}],"position":{"start":{"line":336,"column":1,"offset":16461},"end":{"line":336,"column":187,"offset":16647},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":338,"column":6,"offset":16654},"end":{"line":338,"column":16,"offset":16664},"indent":[]}}],"position":{"start":{"line":338,"column":1,"offset":16649},"end":{"line":338,"column":16,"offset":16664},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the rectangle expositor can be found in the config/expositor.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":340,"column":1,"offset":16666},"end":{"line":340,"column":188,"offset":16853},"indent":[]}}],"position":{"start":{"line":340,"column":1,"offset":16666},"end":{"line":340,"column":188,"offset":16853},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n \n 0\n 0\n 1280\n 720\n \n \n","position":{"start":{"line":342,"column":1,"offset":16855},"end":{"line":353,"column":4,"offset":17077},"indent":[1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Region","position":{"start":{"line":355,"column":7,"offset":17085},"end":{"line":355,"column":13,"offset":17091},"indent":[]}}],"position":{"start":{"line":355,"column":1,"offset":17079},"end":{"line":355,"column":13,"offset":17091},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The region parameter contains 4 values; x1, y1, x2 and y2 respectively. The values x1 and y1 indicate the x- and y-coordinate of the left upper starting point. The values x2 and y2 are the bottom right coordinates. A virtual rectangle will be drawn from (x1,y1) to (x2,y2). Pixels of interest that lie within this rectangle are valid pixels; if not they are invalid.","position":{"start":{"line":357,"column":1,"offset":17093},"end":{"line":357,"column":367,"offset":17459},"indent":[]}}],"position":{"start":{"line":357,"column":1,"offset":17093},"end":{"line":357,"column":367,"offset":17459},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Hull","position":{"start":{"line":359,"column":5,"offset":17465},"end":{"line":359,"column":9,"offset":17469},"indent":[]}}],"position":{"start":{"line":359,"column":1,"offset":17461},"end":{"line":359,"column":9,"offset":17469},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This hull is a more complex expositor than the rectangle. A hull can be selected with the web, you can select one or more coordinates to create a flexible region. The coordinates can be adjusted afterwards and be removed by double clicking on the coordinate. You can expand the hull by removing the start coordinate, which is marked by the white bullet.","position":{"start":{"line":361,"column":1,"offset":17471},"end":{"line":361,"column":354,"offset":17824},"indent":[]}}],"position":{"start":{"line":361,"column":1,"offset":17471},"end":{"line":361,"column":354,"offset":17824},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/machinery/hull.png","alt":"machinery hull","position":{"start":{"line":363,"column":1,"offset":17826},"end":{"line":363,"column":58,"offset":17883},"indent":[]}}],"position":{"start":{"line":363,"column":1,"offset":17826},"end":{"line":363,"column":58,"offset":17883},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":365,"column":6,"offset":17890},"end":{"line":365,"column":16,"offset":17900},"indent":[]}}],"position":{"start":{"line":365,"column":1,"offset":17885},"end":{"line":365,"column":16,"offset":17900},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the hull expositor can be found in the config/expositor.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":367,"column":1,"offset":17902},"end":{"line":367,"column":183,"offset":18084},"indent":[]}}],"position":{"start":{"line":367,"column":1,"offset":17902},"end":{"line":367,"column":183,"offset":18084},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n 347,361|627,266|975,328|1091,328|1148,413|1158,516|1121,534|962,567|699,648|531,700|243,613|423,550|665,453|850,470|666,361|467,385|325,460|165,372\n \n","position":{"start":{"line":369,"column":1,"offset":18086},"end":{"line":375,"column":4,"offset":18332},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Region","position":{"start":{"line":377,"column":7,"offset":18340},"end":{"line":377,"column":13,"offset":18346},"indent":[]}}],"position":{"start":{"line":377,"column":1,"offset":18334},"end":{"line":377,"column":13,"offset":18346},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The region parameter contains n values. Each value represents a coordinate (x,y) and are seperated by the \"|\" delimiter. These coordinates are used to calculate the concave hull. Pixels of interest that lie within the concave hull are valid pixels; if not they are invalid.","position":{"start":{"line":378,"column":1,"offset":18347},"end":{"line":378,"column":274,"offset":18620},"indent":[]}}],"position":{"start":{"line":378,"column":1,"offset":18347},"end":{"line":378,"column":274,"offset":18620},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Heuristic","position":{"start":{"line":380,"column":4,"offset":18625},"end":{"line":380,"column":13,"offset":18634},"indent":[]}}],"position":{"start":{"line":380,"column":1,"offset":18622},"end":{"line":380,"column":13,"offset":18634},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The heuristic is the last step in the four passway which will decide if the detection is valid or not. It will do this by using information from the previous steps (the expositor and the algorithm); e.g. number of changed pixels.","position":{"start":{"line":382,"column":1,"offset":18636},"end":{"line":382,"column":230,"offset":18865},"indent":[]}}],"position":{"start":{"line":382,"column":1,"offset":18636},"end":{"line":382,"column":230,"offset":18865},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can change the heuristic by changing the ","position":{"start":{"line":384,"column":1,"offset":18867},"end":{"line":384,"column":46,"offset":18912},"indent":[]}},{"type":"inlineCode","value":"config/config.xml","position":{"start":{"line":384,"column":46,"offset":18912},"end":{"line":384,"column":65,"offset":18931},"indent":[]}},{"type":"text","value":" file, and choose one of the following:","position":{"start":{"line":384,"column":65,"offset":18931},"end":{"line":384,"column":104,"offset":18970},"indent":[]}}],"position":{"start":{"line":384,"column":1,"offset":18867},"end":{"line":384,"column":104,"offset":18970},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Sequence","position":{"start":{"line":385,"column":3,"offset":18973},"end":{"line":385,"column":11,"offset":18981},"indent":[]}}],"position":{"start":{"line":385,"column":3,"offset":18973},"end":{"line":385,"column":11,"offset":18981},"indent":[]}}],"position":{"start":{"line":385,"column":1,"offset":18971},"end":{"line":385,"column":11,"offset":18981},"indent":[]}}],"position":{"start":{"line":385,"column":1,"offset":18971},"end":{"line":385,"column":11,"offset":18981},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n ...\n Sequence\n ...\n \n","position":{"start":{"line":387,"column":1,"offset":18983},"end":{"line":396,"column":4,"offset":19138},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Sequence","position":{"start":{"line":398,"column":5,"offset":19144},"end":{"line":398,"column":13,"offset":19152},"indent":[]}}],"position":{"start":{"line":398,"column":1,"offset":19140},"end":{"line":398,"column":13,"offset":19152},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This is a trivial heuristic. The sequence heuristic will store a single integer in memory, that will count the numbers of valid detections. When the heuristic will detect a false detection, it will decrease the count. The sequence heuristic will return true, if a threshold is reached; for example when something was detected three times in a row.","position":{"start":{"line":400,"column":1,"offset":19154},"end":{"line":400,"column":348,"offset":19501},"indent":[]}}],"position":{"start":{"line":400,"column":1,"offset":19154},"end":{"line":400,"column":348,"offset":19501},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":402,"column":6,"offset":19508},"end":{"line":402,"column":16,"offset":19518},"indent":[]}}],"position":{"start":{"line":402,"column":1,"offset":19503},"end":{"line":402,"column":16,"offset":19518},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Sequence heuristic can be found in the config/heuristic.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":404,"column":1,"offset":19520},"end":{"line":404,"column":187,"offset":19706},"indent":[]}}],"position":{"start":{"line":404,"column":1,"offset":19520},"end":{"line":404,"column":187,"offset":19706},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n 1\n 1\n 2000\n \n","position":{"start":{"line":406,"column":1,"offset":19708},"end":{"line":414,"column":4,"offset":19940},"indent":[1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Minimum changes","position":{"start":{"line":416,"column":7,"offset":19948},"end":{"line":416,"column":22,"offset":19963},"indent":[]}}],"position":{"start":{"line":416,"column":1,"offset":19942},"end":{"line":416,"column":22,"offset":19963},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The heuristic will only return true if enough changes have been detected. The minimum of changes indicates the minimum number of pixels that have to been changed, to be a valid detection.","position":{"start":{"line":418,"column":1,"offset":19965},"end":{"line":418,"column":188,"offset":20152},"indent":[]}}],"position":{"start":{"line":418,"column":1,"offset":19965},"end":{"line":418,"column":188,"offset":20152},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Minimum durations","position":{"start":{"line":420,"column":7,"offset":20160},"end":{"line":420,"column":24,"offset":20177},"indent":[]}}],"position":{"start":{"line":420,"column":1,"offset":20154},"end":{"line":420,"column":24,"offset":20177},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The minimum number of detections in a row to be a valid detection.","position":{"start":{"line":422,"column":1,"offset":20179},"end":{"line":422,"column":67,"offset":20245},"indent":[]}}],"position":{"start":{"line":422,"column":1,"offset":20179},"end":{"line":422,"column":67,"offset":20245},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"No motion delay time","position":{"start":{"line":424,"column":7,"offset":20253},"end":{"line":424,"column":27,"offset":20273},"indent":[]}}],"position":{"start":{"line":424,"column":1,"offset":20247},"end":{"line":424,"column":27,"offset":20273},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When the heuristic failed, due to not enough pixels changed or not x detections in a row, the heuristic will idle for some time.","position":{"start":{"line":426,"column":1,"offset":20275},"end":{"line":426,"column":129,"offset":20403},"indent":[]}}],"position":{"start":{"line":426,"column":1,"offset":20275},"end":{"line":426,"column":129,"offset":20403},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Output","position":{"start":{"line":428,"column":4,"offset":20408},"end":{"line":428,"column":10,"offset":20414},"indent":[]}}],"position":{"start":{"line":428,"column":1,"offset":20405},"end":{"line":428,"column":10,"offset":20414},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If the heuristic determined that the evaluation was valid, one or more output operations can be executed. You configure which ooutput operations that will be executed, by modifying the configuration file or using the web interface.","position":{"start":{"line":430,"column":1,"offset":20416},"end":{"line":430,"column":232,"offset":20647},"indent":[]}}],"position":{"start":{"line":430,"column":1,"offset":20416},"end":{"line":430,"column":232,"offset":20647},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n ...\n Video\n ...\n \n","position":{"start":{"line":432,"column":1,"offset":20649},"end":{"line":441,"column":4,"offset":20796},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"You can choose which output devices you will be using. If you select multiple outputs, seperate them with an ","position":{"start":{"line":443,"column":1,"offset":20798},"end":{"line":443,"column":110,"offset":20907},"indent":[]}},{"type":"inlineCode","value":",","position":{"start":{"line":443,"column":110,"offset":20907},"end":{"line":443,"column":113,"offset":20910},"indent":[]}},{"type":"text","value":". You can change the output device by changing the ","position":{"start":{"line":443,"column":113,"offset":20910},"end":{"line":443,"column":164,"offset":20961},"indent":[]}},{"type":"inlineCode","value":"config/config.xml","position":{"start":{"line":443,"column":164,"offset":20961},"end":{"line":443,"column":183,"offset":20980},"indent":[]}},{"type":"text","value":" file, and choose one of the following:","position":{"start":{"line":443,"column":183,"offset":20980},"end":{"line":443,"column":222,"offset":21019},"indent":[]}}],"position":{"start":{"line":443,"column":1,"offset":20798},"end":{"line":443,"column":222,"offset":21019},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Disk","position":{"start":{"line":444,"column":3,"offset":21022},"end":{"line":444,"column":7,"offset":21026},"indent":[]}}],"position":{"start":{"line":444,"column":3,"offset":21022},"end":{"line":444,"column":7,"offset":21026},"indent":[]}}],"position":{"start":{"line":444,"column":1,"offset":21020},"end":{"line":444,"column":7,"offset":21026},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Video","position":{"start":{"line":445,"column":3,"offset":21029},"end":{"line":445,"column":8,"offset":21034},"indent":[]}}],"position":{"start":{"line":445,"column":3,"offset":21029},"end":{"line":445,"column":8,"offset":21034},"indent":[]}}],"position":{"start":{"line":445,"column":1,"offset":21027},"end":{"line":445,"column":8,"offset":21034},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"GPIO","position":{"start":{"line":446,"column":3,"offset":21037},"end":{"line":446,"column":7,"offset":21041},"indent":[]}}],"position":{"start":{"line":446,"column":3,"offset":21037},"end":{"line":446,"column":7,"offset":21041},"indent":[]}}],"position":{"start":{"line":446,"column":1,"offset":21035},"end":{"line":446,"column":7,"offset":21041},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"TCPSocket","position":{"start":{"line":447,"column":3,"offset":21044},"end":{"line":447,"column":12,"offset":21053},"indent":[]}}],"position":{"start":{"line":447,"column":3,"offset":21044},"end":{"line":447,"column":12,"offset":21053},"indent":[]}}],"position":{"start":{"line":447,"column":1,"offset":21042},"end":{"line":447,"column":12,"offset":21053},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Webhook","position":{"start":{"line":448,"column":3,"offset":21056},"end":{"line":448,"column":10,"offset":21063},"indent":[]}}],"position":{"start":{"line":448,"column":3,"offset":21056},"end":{"line":448,"column":10,"offset":21063},"indent":[]}}],"position":{"start":{"line":448,"column":1,"offset":21054},"end":{"line":448,"column":10,"offset":21063},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MQTT","position":{"start":{"line":449,"column":3,"offset":21066},"end":{"line":449,"column":7,"offset":21070},"indent":[]}}],"position":{"start":{"line":449,"column":3,"offset":21066},"end":{"line":449,"column":7,"offset":21070},"indent":[]}}],"position":{"start":{"line":449,"column":1,"offset":21064},"end":{"line":449,"column":7,"offset":21070},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Script","position":{"start":{"line":450,"column":3,"offset":21073},"end":{"line":450,"column":9,"offset":21079},"indent":[]}}],"position":{"start":{"line":450,"column":3,"offset":21073},"end":{"line":450,"column":9,"offset":21079},"indent":[]}}],"position":{"start":{"line":450,"column":1,"offset":21071},"end":{"line":450,"column":9,"offset":21079},"indent":[]}}],"position":{"start":{"line":444,"column":1,"offset":21020},"end":{"line":450,"column":9,"offset":21079},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Disk","position":{"start":{"line":452,"column":5,"offset":21085},"end":{"line":452,"column":9,"offset":21089},"indent":[]}}],"position":{"start":{"line":452,"column":1,"offset":21081},"end":{"line":452,"column":9,"offset":21089},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"An image can be saved to disk.","position":{"start":{"line":454,"column":1,"offset":21091},"end":{"line":454,"column":31,"offset":21121},"indent":[]}}],"position":{"start":{"line":454,"column":1,"offset":21091},"end":{"line":454,"column":31,"offset":21121},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":456,"column":6,"offset":21128},"end":{"line":456,"column":16,"offset":21138},"indent":[]}}],"position":{"start":{"line":456,"column":1,"offset":21123},"end":{"line":456,"column":16,"offset":21138},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Disk output device can be found in the ","position":{"start":{"line":458,"column":1,"offset":21140},"end":{"line":458,"column":62,"offset":21201},"indent":[]}},{"type":"inlineCode","value":"config/io.xml","position":{"start":{"line":458,"column":62,"offset":21201},"end":{"line":458,"column":77,"offset":21216},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":458,"column":77,"offset":21216},"end":{"line":458,"column":182,"offset":21321},"indent":[]}}],"position":{"start":{"line":458,"column":1,"offset":21140},"end":{"line":458,"column":182,"offset":21321},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n timestamp_microseconds_instanceName_regionCoordinates_numberOfChanges_token.jpg\n /etc/opt/kerberosio/capture/\n false\n white\n false\n 0\n \n","position":{"start":{"line":460,"column":1,"offset":21323},"end":{"line":471,"column":4,"offset":21754},"indent":[1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"File format","position":{"start":{"line":473,"column":7,"offset":21762},"end":{"line":473,"column":18,"offset":21773},"indent":[]}}],"position":{"start":{"line":473,"column":1,"offset":21756},"end":{"line":473,"column":18,"offset":21773},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The format that will be used for the name of the image. One or more variables can be defined and will be replaced by the machinery. Note that when you're using a variables name in the file format, that this name should be defined in the JSON object.","position":{"start":{"line":475,"column":1,"offset":21775},"end":{"line":475,"column":250,"offset":22024},"indent":[]}}],"position":{"start":{"line":475,"column":1,"offset":21775},"end":{"line":475,"column":250,"offset":22024},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Directory","position":{"start":{"line":477,"column":7,"offset":22032},"end":{"line":477,"column":16,"offset":22041},"indent":[]}}],"position":{"start":{"line":477,"column":1,"offset":22026},"end":{"line":477,"column":16,"offset":22041},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The directory where the image will be saved to. By default images are saved to the /etc/opt/kerberosio/capture directory.","position":{"start":{"line":479,"column":1,"offset":22043},"end":{"line":479,"column":122,"offset":22164},"indent":[]}}],"position":{"start":{"line":479,"column":1,"offset":22043},"end":{"line":479,"column":122,"offset":22164},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Mark with timestamp","position":{"start":{"line":481,"column":7,"offset":22172},"end":{"line":481,"column":26,"offset":22191},"indent":[]}}],"position":{"start":{"line":481,"column":1,"offset":22166},"end":{"line":481,"column":26,"offset":22191},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When this settings is set to true, the image is marked with a timestamp.","position":{"start":{"line":483,"column":1,"offset":22193},"end":{"line":483,"column":73,"offset":22265},"indent":[]}}],"position":{"start":{"line":483,"column":1,"offset":22193},"end":{"line":483,"column":73,"offset":22265},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Timestamp color","position":{"start":{"line":485,"column":7,"offset":22273},"end":{"line":485,"column":22,"offset":22288},"indent":[]}}],"position":{"start":{"line":485,"column":1,"offset":22267},"end":{"line":485,"column":22,"offset":22288},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A color can be defined for timestamp: white, black, red, green and blue.","position":{"start":{"line":486,"column":1,"offset":22289},"end":{"line":486,"column":73,"offset":22361},"indent":[]}}],"position":{"start":{"line":486,"column":1,"offset":22289},"end":{"line":486,"column":73,"offset":22361},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Privacy","position":{"start":{"line":488,"column":7,"offset":22369},"end":{"line":488,"column":14,"offset":22376},"indent":[]}}],"position":{"start":{"line":488,"column":1,"offset":22363},"end":{"line":488,"column":14,"offset":22376},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The privacy mode can be activated to remove some parts from the image. This especially helpful if you want to filter out public areas. When this option is enabled you will seee that after configuring the Hull expositor, you'll see that the pixels outside your region of interest (Hull) are made black.","position":{"start":{"line":489,"column":1,"offset":22377},"end":{"line":489,"column":303,"offset":22679},"indent":[]}}],"position":{"start":{"line":489,"column":1,"offset":22377},"end":{"line":489,"column":303,"offset":22679},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":491,"column":7,"offset":22687},"end":{"line":491,"column":16,"offset":22696},"indent":[]}}],"position":{"start":{"line":491,"column":1,"offset":22681},"end":{"line":491,"column":16,"offset":22696},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Disk will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":492,"column":1,"offset":22697},"end":{"line":492,"column":187,"offset":22883},"indent":[]}}],"position":{"start":{"line":492,"column":1,"offset":22697},"end":{"line":492,"column":187,"offset":22883},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Video","position":{"start":{"line":494,"column":5,"offset":22889},"end":{"line":494,"column":10,"offset":22894},"indent":[]}}],"position":{"start":{"line":494,"column":1,"offset":22885},"end":{"line":494,"column":10,"offset":22894},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When a valid event is detected, a video will be recorded for x seconds. When more valid events are detected, while a video is recording, the video file will further record for x seconds; so no new video file be recorded, but the existing one will be expanded.","position":{"start":{"line":495,"column":1,"offset":22895},"end":{"line":495,"column":260,"offset":23154},"indent":[]}}],"position":{"start":{"line":495,"column":1,"offset":22895},"end":{"line":495,"column":260,"offset":23154},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":497,"column":6,"offset":23161},"end":{"line":497,"column":16,"offset":23171},"indent":[]}}],"position":{"start":{"line":497,"column":1,"offset":23156},"end":{"line":497,"column":16,"offset":23171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Video output device can be found in the ","position":{"start":{"line":498,"column":1,"offset":23172},"end":{"line":498,"column":63,"offset":23234},"indent":[]}},{"type":"inlineCode","value":"config/io.xml","position":{"start":{"line":498,"column":63,"offset":23234},"end":{"line":498,"column":78,"offset":23249},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":498,"column":78,"offset":23249},"end":{"line":498,"column":183,"offset":23354},"indent":[]}}],"position":{"start":{"line":498,"column":1,"offset":23172},"end":{"line":498,"column":183,"offset":23354},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n","position":{"start":{"line":500,"column":1,"offset":23356},"end":{"line":518,"column":4,"offset":24146},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"FPS","position":{"start":{"line":520,"column":7,"offset":24154},"end":{"line":520,"column":10,"offset":24157},"indent":[]}}],"position":{"start":{"line":520,"column":1,"offset":24148},"end":{"line":520,"column":10,"offset":24157},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The frames per second of the video being recorded. Please note that this number is limited and depends heavily on your hardware setup. You'll be receiving following warning in the systems logs, if the machinery can't write the desired FPS.","position":{"start":{"line":521,"column":1,"offset":24158},"end":{"line":521,"column":240,"offset":24397},"indent":[]}}],"position":{"start":{"line":521,"column":1,"offset":24158},"end":{"line":521,"column":240,"offset":24397},"indent":[]}},{"type":"code","lang":"text","meta":null,"value":"[trivial] IoVideo: framerate is too fast, can't record video at this speed (8/FPS)","position":{"start":{"line":523,"column":1,"offset":24399},"end":{"line":525,"column":4,"offset":24493},"indent":[1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Record after","position":{"start":{"line":526,"column":7,"offset":24500},"end":{"line":526,"column":19,"offset":24512},"indent":[]}}],"position":{"start":{"line":526,"column":1,"offset":24494},"end":{"line":526,"column":19,"offset":24512},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The number of seconds recorded after the last valid event was detected. This means that when a video is already recording, and a valid event was detected, the video will be expanded with x more seconds.","position":{"start":{"line":527,"column":1,"offset":24513},"end":{"line":527,"column":203,"offset":24715},"indent":[]}}],"position":{"start":{"line":527,"column":1,"offset":24513},"end":{"line":527,"column":203,"offset":24715},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Extensions","position":{"start":{"line":529,"column":7,"offset":24723},"end":{"line":529,"column":17,"offset":24733},"indent":[]}}],"position":{"start":{"line":529,"column":1,"offset":24717},"end":{"line":529,"column":17,"offset":24733},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The extension or container of the video file. We highly recommend to use the MP4 container if you want cross-browser support. Leave this setting by default, if you don't know what you're doing.","position":{"start":{"line":530,"column":1,"offset":24734},"end":{"line":530,"column":194,"offset":24927},"indent":[]}}],"position":{"start":{"line":530,"column":1,"offset":24734},"end":{"line":530,"column":194,"offset":24927},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Codec","position":{"start":{"line":532,"column":7,"offset":24935},"end":{"line":532,"column":12,"offset":24940},"indent":[]}}],"position":{"start":{"line":532,"column":1,"offset":24929},"end":{"line":532,"column":12,"offset":24940},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The codec that is used to encode the video file.","position":{"start":{"line":533,"column":1,"offset":24941},"end":{"line":533,"column":49,"offset":24989},"indent":[]}}],"position":{"start":{"line":533,"column":1,"offset":24941},"end":{"line":533,"column":49,"offset":24989},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"File format","position":{"start":{"line":535,"column":7,"offset":24997},"end":{"line":535,"column":18,"offset":25008},"indent":[]}}],"position":{"start":{"line":535,"column":1,"offset":24991},"end":{"line":535,"column":18,"offset":25008},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The format that will be used for the name of the image. One or more variables can be defined and will be replaced by the machinery. Note that when you're using a variables name in the file format, that this name should be defined in the JSON object.","position":{"start":{"line":536,"column":1,"offset":25009},"end":{"line":536,"column":250,"offset":25258},"indent":[]}}],"position":{"start":{"line":536,"column":1,"offset":25009},"end":{"line":536,"column":250,"offset":25258},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Directory","position":{"start":{"line":538,"column":7,"offset":25266},"end":{"line":538,"column":16,"offset":25275},"indent":[]}}],"position":{"start":{"line":538,"column":1,"offset":25260},"end":{"line":538,"column":16,"offset":25275},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The directory where the videos will be saved. By default videos are saved to the /etc/opt/kerberosio/capture directory.","position":{"start":{"line":539,"column":1,"offset":25276},"end":{"line":539,"column":120,"offset":25395},"indent":[]}}],"position":{"start":{"line":539,"column":1,"offset":25276},"end":{"line":539,"column":120,"offset":25395},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Hardware directory","position":{"start":{"line":541,"column":7,"offset":25403},"end":{"line":541,"column":25,"offset":25421},"indent":[]}}],"position":{"start":{"line":541,"column":1,"offset":25397},"end":{"line":541,"column":25,"offset":25421},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When using onboard hardware encoding (e.g. with Raspberry Pi camera), h264 video files are generated and stored in this directory. Afterwards these h264 files will be containerized to mp4 files, and stored in the Directory path.","position":{"start":{"line":542,"column":1,"offset":25422},"end":{"line":542,"column":229,"offset":25650},"indent":[]}}],"position":{"start":{"line":542,"column":1,"offset":25422},"end":{"line":542,"column":229,"offset":25650},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Enable Hardware encoding","position":{"start":{"line":544,"column":7,"offset":25658},"end":{"line":544,"column":31,"offset":25682},"indent":[]}}],"position":{"start":{"line":544,"column":1,"offset":25652},"end":{"line":544,"column":31,"offset":25682},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A boolean which can enable or disable hardware encoding. Please note that this option is enabled by default, but does not mean that it will work if you choose to use an USB camera.","position":{"start":{"line":545,"column":1,"offset":25683},"end":{"line":545,"column":181,"offset":25863},"indent":[]}}],"position":{"start":{"line":545,"column":1,"offset":25683},"end":{"line":545,"column":181,"offset":25863},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Mark with timestamp","position":{"start":{"line":547,"column":7,"offset":25871},"end":{"line":547,"column":26,"offset":25890},"indent":[]}}],"position":{"start":{"line":547,"column":1,"offset":25865},"end":{"line":547,"column":26,"offset":25890},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When this settings is set to true, the video is marked with a timestamp (similar to the Disk device).","position":{"start":{"line":548,"column":1,"offset":25891},"end":{"line":548,"column":102,"offset":25992},"indent":[]}}],"position":{"start":{"line":548,"column":1,"offset":25891},"end":{"line":548,"column":102,"offset":25992},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Timestamp color","position":{"start":{"line":550,"column":7,"offset":26000},"end":{"line":550,"column":22,"offset":26015},"indent":[]}}],"position":{"start":{"line":550,"column":1,"offset":25994},"end":{"line":550,"column":22,"offset":26015},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A color can be defined for timestamp: white, black, red, green and blue.","position":{"start":{"line":551,"column":1,"offset":26016},"end":{"line":551,"column":73,"offset":26088},"indent":[]}}],"position":{"start":{"line":551,"column":1,"offset":26016},"end":{"line":551,"column":73,"offset":26088},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Privacy","position":{"start":{"line":553,"column":7,"offset":26096},"end":{"line":553,"column":14,"offset":26103},"indent":[]}}],"position":{"start":{"line":553,"column":1,"offset":26090},"end":{"line":553,"column":14,"offset":26103},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The privacy mode can be activated to remove some parts from the video. This especially helpful if you want to filter out public areas.","position":{"start":{"line":554,"column":1,"offset":26104},"end":{"line":554,"column":135,"offset":26238},"indent":[]}}],"position":{"start":{"line":554,"column":1,"offset":26104},"end":{"line":554,"column":135,"offset":26238},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Video privacy","position":{"start":{"line":556,"column":7,"offset":26246},"end":{"line":556,"column":20,"offset":26259},"indent":[]}}],"position":{"start":{"line":556,"column":1,"offset":26240},"end":{"line":556,"column":20,"offset":26259},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After updating the configuration, you'll see that the pixels outside your region of interest (ROI) are made black; the image below illustrates this.","position":{"start":{"line":557,"column":1,"offset":26260},"end":{"line":557,"column":149,"offset":26408},"indent":[]}}],"position":{"start":{"line":557,"column":1,"offset":26260},"end":{"line":557,"column":149,"offset":26408},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":559,"column":7,"offset":26416},"end":{"line":559,"column":16,"offset":26425},"indent":[]}}],"position":{"start":{"line":559,"column":1,"offset":26410},"end":{"line":559,"column":16,"offset":26425},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Video will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":560,"column":1,"offset":26426},"end":{"line":560,"column":188,"offset":26613},"indent":[]}}],"position":{"start":{"line":560,"column":1,"offset":26426},"end":{"line":560,"column":188,"offset":26613},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"TCP/IP client","position":{"start":{"line":562,"column":5,"offset":26619},"end":{"line":562,"column":18,"offset":26632},"indent":[]}}],"position":{"start":{"line":562,"column":1,"offset":26615},"end":{"line":562,"column":18,"offset":26632},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The TCP/IP client will send a TCP packet to a server.","position":{"start":{"line":564,"column":1,"offset":26634},"end":{"line":564,"column":54,"offset":26687},"indent":[]}}],"position":{"start":{"line":564,"column":1,"offset":26634},"end":{"line":564,"column":54,"offset":26687},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":566,"column":6,"offset":26694},"end":{"line":566,"column":16,"offset":26704},"indent":[]}}],"position":{"start":{"line":566,"column":1,"offset":26689},"end":{"line":566,"column":16,"offset":26704},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the TCP/IP client can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":567,"column":1,"offset":26705},"end":{"line":567,"column":175,"offset":26879},"indent":[]}}],"position":{"start":{"line":567,"column":1,"offset":26705},"end":{"line":567,"column":175,"offset":26879},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n 127.0.0.1\n 1337\n it's so fluffy\n 0\n \n","position":{"start":{"line":569,"column":1,"offset":26881},"end":{"line":578,"column":4,"offset":27107},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Server","position":{"start":{"line":580,"column":7,"offset":27115},"end":{"line":580,"column":13,"offset":27121},"indent":[]}}],"position":{"start":{"line":580,"column":1,"offset":27109},"end":{"line":580,"column":13,"offset":27121},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The IP of the TCP server.","position":{"start":{"line":581,"column":1,"offset":27122},"end":{"line":581,"column":26,"offset":27147},"indent":[]}}],"position":{"start":{"line":581,"column":1,"offset":27122},"end":{"line":581,"column":26,"offset":27147},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Port","position":{"start":{"line":583,"column":7,"offset":27155},"end":{"line":583,"column":11,"offset":27159},"indent":[]}}],"position":{"start":{"line":583,"column":1,"offset":27149},"end":{"line":583,"column":11,"offset":27159},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This is the port of the TCP server.","position":{"start":{"line":584,"column":1,"offset":27160},"end":{"line":584,"column":36,"offset":27195},"indent":[]}}],"position":{"start":{"line":584,"column":1,"offset":27160},"end":{"line":584,"column":36,"offset":27195},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Message","position":{"start":{"line":586,"column":7,"offset":27203},"end":{"line":586,"column":14,"offset":27210},"indent":[]}}],"position":{"start":{"line":586,"column":1,"offset":27197},"end":{"line":586,"column":14,"offset":27210},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can send some data to a TCP server.","position":{"start":{"line":587,"column":1,"offset":27211},"end":{"line":587,"column":40,"offset":27250},"indent":[]}}],"position":{"start":{"line":587,"column":1,"offset":27211},"end":{"line":587,"column":40,"offset":27250},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":589,"column":7,"offset":27258},"end":{"line":589,"column":16,"offset":27267},"indent":[]}}],"position":{"start":{"line":589,"column":1,"offset":27252},"end":{"line":589,"column":16,"offset":27267},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the TCP will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":590,"column":1,"offset":27268},"end":{"line":590,"column":186,"offset":27453},"indent":[]}}],"position":{"start":{"line":590,"column":1,"offset":27268},"end":{"line":590,"column":186,"offset":27453},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"GPIO","position":{"start":{"line":592,"column":5,"offset":27459},"end":{"line":592,"column":9,"offset":27463},"indent":[]}}],"position":{"start":{"line":592,"column":1,"offset":27455},"end":{"line":592,"column":9,"offset":27463},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A GPIO pin can be set as output device.","position":{"start":{"line":593,"column":1,"offset":27464},"end":{"line":593,"column":40,"offset":27503},"indent":[]}}],"position":{"start":{"line":593,"column":1,"offset":27464},"end":{"line":593,"column":40,"offset":27503},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":595,"column":6,"offset":27510},"end":{"line":595,"column":16,"offset":27520},"indent":[]}}],"position":{"start":{"line":595,"column":1,"offset":27505},"end":{"line":595,"column":16,"offset":27520},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the GPIO pin can be found in the ","position":{"start":{"line":596,"column":1,"offset":27521},"end":{"line":596,"column":52,"offset":27572},"indent":[]}},{"type":"inlineCode","value":"config/io.xml","position":{"start":{"line":596,"column":52,"offset":27572},"end":{"line":596,"column":67,"offset":27587},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":596,"column":67,"offset":27587},"end":{"line":596,"column":172,"offset":27692},"indent":[]}}],"position":{"start":{"line":596,"column":1,"offset":27521},"end":{"line":596,"column":172,"offset":27692},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n 17\n 5\n 100000\n 0\n \n","position":{"start":{"line":598,"column":1,"offset":27694},"end":{"line":607,"column":4,"offset":27900},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Pin","position":{"start":{"line":609,"column":7,"offset":27908},"end":{"line":609,"column":10,"offset":27911},"indent":[]}}],"position":{"start":{"line":609,"column":1,"offset":27902},"end":{"line":609,"column":10,"offset":27911},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The pin that will be triggered.","position":{"start":{"line":610,"column":1,"offset":27912},"end":{"line":610,"column":32,"offset":27943},"indent":[]}}],"position":{"start":{"line":610,"column":1,"offset":27912},"end":{"line":610,"column":32,"offset":27943},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Periods","position":{"start":{"line":612,"column":7,"offset":27951},"end":{"line":612,"column":14,"offset":27958},"indent":[]}}],"position":{"start":{"line":612,"column":1,"offset":27945},"end":{"line":612,"column":14,"offset":27958},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The number of times the pin will be triggered.","position":{"start":{"line":613,"column":1,"offset":27959},"end":{"line":613,"column":47,"offset":28005},"indent":[]}}],"position":{"start":{"line":613,"column":1,"offset":27959},"end":{"line":613,"column":47,"offset":28005},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Period time","position":{"start":{"line":615,"column":7,"offset":28013},"end":{"line":615,"column":18,"offset":28024},"indent":[]}}],"position":{"start":{"line":615,"column":1,"offset":28007},"end":{"line":615,"column":18,"offset":28024},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The time in microseconds that the pin will be set high.","position":{"start":{"line":616,"column":1,"offset":28025},"end":{"line":616,"column":56,"offset":28080},"indent":[]}}],"position":{"start":{"line":616,"column":1,"offset":28025},"end":{"line":616,"column":56,"offset":28080},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":618,"column":7,"offset":28088},"end":{"line":618,"column":16,"offset":28097},"indent":[]}}],"position":{"start":{"line":618,"column":1,"offset":28082},"end":{"line":618,"column":16,"offset":28097},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the GPIO will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":619,"column":1,"offset":28098},"end":{"line":619,"column":187,"offset":28284},"indent":[]}}],"position":{"start":{"line":619,"column":1,"offset":28098},"end":{"line":619,"column":187,"offset":28284},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Webhook","position":{"start":{"line":621,"column":6,"offset":28291},"end":{"line":621,"column":13,"offset":28298},"indent":[]}}],"position":{"start":{"line":621,"column":1,"offset":28286},"end":{"line":621,"column":13,"offset":28298},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Detailed information (a JSON object) is send as a POST request to a webhook. The JSON object contains the number of changes, the region, the URL of the image, etc. This is useful if you want to integrate with your own application.","position":{"start":{"line":622,"column":1,"offset":28299},"end":{"line":622,"column":231,"offset":28529},"indent":[]}}],"position":{"start":{"line":622,"column":1,"offset":28299},"end":{"line":622,"column":231,"offset":28529},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Make sure that the Webhook comes after the Disk device, otherwise the URL of the image is not included.","position":{"start":{"line":624,"column":1,"offset":28531},"end":{"line":624,"column":104,"offset":28634},"indent":[]}}],"position":{"start":{"line":624,"column":1,"offset":28531},"end":{"line":624,"column":104,"offset":28634},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":626,"column":6,"offset":28641},"end":{"line":626,"column":16,"offset":28651},"indent":[]}}],"position":{"start":{"line":626,"column":1,"offset":28636},"end":{"line":626,"column":16,"offset":28651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the webhook can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":627,"column":1,"offset":28652},"end":{"line":627,"column":169,"offset":28820},"indent":[]}}],"position":{"start":{"line":627,"column":1,"offset":28652},"end":{"line":627,"column":169,"offset":28820},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n http://kerberos.web/api/v1/webhook\n 0\n \n","position":{"start":{"line":629,"column":1,"offset":28822},"end":{"line":636,"column":4,"offset":28975},"indent":[1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Url","position":{"start":{"line":638,"column":7,"offset":28983},"end":{"line":638,"column":10,"offset":28986},"indent":[]}}],"position":{"start":{"line":638,"column":1,"offset":28977},"end":{"line":638,"column":10,"offset":28986},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This is the URL, to which the machinery will send a JSON object (as a POST request).","position":{"start":{"line":639,"column":1,"offset":28987},"end":{"line":639,"column":85,"offset":29071},"indent":[]}}],"position":{"start":{"line":639,"column":1,"offset":28987},"end":{"line":639,"column":85,"offset":29071},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":641,"column":7,"offset":29079},"end":{"line":641,"column":16,"offset":29088},"indent":[]}}],"position":{"start":{"line":641,"column":1,"offset":29073},"end":{"line":641,"column":16,"offset":29088},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Webhook will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":642,"column":1,"offset":29089},"end":{"line":642,"column":190,"offset":29278},"indent":[]}}],"position":{"start":{"line":642,"column":1,"offset":29089},"end":{"line":642,"column":190,"offset":29278},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Output","position":{"start":{"line":644,"column":7,"offset":29286},"end":{"line":644,"column":13,"offset":29292},"indent":[]}}],"position":{"start":{"line":644,"column":1,"offset":29280},"end":{"line":644,"column":13,"offset":29292},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A JSON object is POSTed to the url you've defined.","position":{"start":{"line":645,"column":1,"offset":29293},"end":{"line":645,"column":51,"offset":29343},"indent":[]}}],"position":{"start":{"line":645,"column":1,"offset":29293},"end":{"line":645,"column":51,"offset":29343},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"[\n 'regionCoordinates' : [618, 317, 703, 493],\n 'numberOfChanges' : 5446,\n 'timestamp' : '1465894497',\n 'microseconds' : '5-97451',\n 'token' : 695,\n 'pathToImage' : '1465894497_5-97451_frontdoor_618-317-703-493_5446_695.jpg',\n 'instanceName' : 'frontdoor',\n]","position":{"start":{"line":647,"column":1,"offset":29345},"end":{"line":657,"column":4,"offset":29622},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Script","position":{"start":{"line":659,"column":5,"offset":29628},"end":{"line":659,"column":11,"offset":29634},"indent":[]}}],"position":{"start":{"line":659,"column":1,"offset":29624},"end":{"line":659,"column":11,"offset":29634},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A bash script can be executed after a valid event was detected. A JSON object is send in the first parameter to the script you've defined.","position":{"start":{"line":660,"column":1,"offset":29635},"end":{"line":660,"column":139,"offset":29773},"indent":[]}}],"position":{"start":{"line":660,"column":1,"offset":29635},"end":{"line":660,"column":139,"offset":29773},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":662,"column":6,"offset":29780},"end":{"line":662,"column":16,"offset":29790},"indent":[]}}],"position":{"start":{"line":662,"column":1,"offset":29775},"end":{"line":662,"column":16,"offset":29790},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Script output device can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":663,"column":1,"offset":29791},"end":{"line":663,"column":182,"offset":29972},"indent":[]}}],"position":{"start":{"line":663,"column":1,"offset":29791},"end":{"line":663,"column":182,"offset":29972},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n","position":{"start":{"line":665,"column":1,"offset":29974},"end":{"line":672,"column":4,"offset":30127},"indent":[1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Path","position":{"start":{"line":674,"column":7,"offset":30135},"end":{"line":674,"column":11,"offset":30139},"indent":[]}}],"position":{"start":{"line":674,"column":1,"offset":30129},"end":{"line":674,"column":11,"offset":30139},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The location of the script that will be executed on detection.","position":{"start":{"line":675,"column":1,"offset":30140},"end":{"line":675,"column":63,"offset":30202},"indent":[]}}],"position":{"start":{"line":675,"column":1,"offset":30140},"end":{"line":675,"column":63,"offset":30202},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":677,"column":7,"offset":30210},"end":{"line":677,"column":16,"offset":30219},"indent":[]}}],"position":{"start":{"line":677,"column":1,"offset":30204},"end":{"line":677,"column":16,"offset":30219},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Script will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":678,"column":1,"offset":30220},"end":{"line":678,"column":189,"offset":30408},"indent":[]}}],"position":{"start":{"line":678,"column":1,"offset":30220},"end":{"line":678,"column":189,"offset":30408},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Example","position":{"start":{"line":680,"column":7,"offset":30416},"end":{"line":680,"column":14,"offset":30423},"indent":[]}}],"position":{"start":{"line":680,"column":1,"offset":30410},"end":{"line":680,"column":14,"offset":30423},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By default the script will point to /etc/opt/kerberosio/scripts/run.sh, which contains a template how you should start your script. Note that when using KiOS, this script will be read-only, copy it to the /data folder and change the path parameter.","position":{"start":{"line":681,"column":1,"offset":30424},"end":{"line":681,"column":249,"offset":30672},"indent":[]}}],"position":{"start":{"line":681,"column":1,"offset":30424},"end":{"line":681,"column":249,"offset":30672},"indent":[]}},{"type":"code","lang":"python","meta":null,"value":"#!/bin/bash\n# -------------------------------------------\n# This is an example script which illustrates\n# how to use the Script IO device.\n#\n# --------------------------------------\n# The first parameter is the JSON object\n#\n# e.g. {\"regionCoordinates\":[308,250,346,329],\"numberOfChanges\":194,\"timestamp\":\"1486049622\",\"microseconds\":\"6-161868\",\"token\":344,\"pathToImage\":\"1486049622_6-161868_frontdoor_308-250-346-329_194_344.jpg\",\"instanceName\":\"frontdoor\"}\nJSON=$1\n# -------------------------------------------\n# You can use python to parse the JSON object\n# and get the required fields\nname=$(echo $JSON | python -c \"import sys, json; print json.load(sys.stdin)['instanceName']\")\ncoordinates=$(echo $JSON | python -c \"import sys, json; print json.load(sys.stdin)['regionCoordinates']\")\nchanges=$(echo $JSON | pythfon -c \"import sys, json; print json.load(sys.stdin)['numberOfChanges']\")\nimage=$(echo $JSON | python -c \"import sys, json; print json.load(sys.stdin)['pathToImage']\")\nThe idea is that you can use Python in your bash script, to parse the JSON object send as first parameter. Afterwards you can do with the output what you want.","position":{"start":{"line":683,"column":1,"offset":30674},"end":{"line":702,"column":4,"offset":31830},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"MQTT","position":{"start":{"line":704,"column":5,"offset":31836},"end":{"line":704,"column":9,"offset":31840},"indent":[]}}],"position":{"start":{"line":704,"column":1,"offset":31832},"end":{"line":704,"column":9,"offset":31840},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"MQTT protocol is a light-weight Machine to Machine (M2M) protocol widely used in Internet of things.\nDetailed information (a JSON object) is published to an MQTT topic. The JSON object contains the number of changes, the region, the URL of the image, etc.","position":{"start":{"line":705,"column":1,"offset":31841},"end":{"line":706,"column":155,"offset":32096},"indent":[1]}}],"position":{"start":{"line":705,"column":1,"offset":31841},"end":{"line":706,"column":155,"offset":32096},"indent":[1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":708,"column":6,"offset":32103},"end":{"line":708,"column":16,"offset":32113},"indent":[]}}],"position":{"start":{"line":708,"column":1,"offset":32098},"end":{"line":708,"column":16,"offset":32113},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the MQTT output can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":709,"column":1,"offset":32114},"end":{"line":709,"column":173,"offset":32286},"indent":[]}}],"position":{"start":{"line":709,"column":1,"offset":32114},"end":{"line":709,"column":173,"offset":32286},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n false\n false\n 127.0.0.1\n 1883\n kios/mqtt\n \n \n 0\n \n","position":{"start":{"line":711,"column":1,"offset":32288},"end":{"line":724,"column":4,"offset":32652},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Secure","position":{"start":{"line":726,"column":7,"offset":32660},"end":{"line":726,"column":13,"offset":32666},"indent":[]}}],"position":{"start":{"line":726,"column":1,"offset":32654},"end":{"line":726,"column":13,"offset":32666},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If checked, enable SSL/TLS support. Please note that when SSL/TLS support is enabled, the server certificate issuer is verified against the CA (Certification Authority) files available in /etc/ssl/certs.","position":{"start":{"line":727,"column":1,"offset":32667},"end":{"line":727,"column":204,"offset":32870},"indent":[]}}],"position":{"start":{"line":727,"column":1,"offset":32667},"end":{"line":727,"column":204,"offset":32870},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Verifycn","position":{"start":{"line":729,"column":7,"offset":32878},"end":{"line":729,"column":15,"offset":32886},"indent":[]}}],"position":{"start":{"line":729,"column":1,"offset":32872},"end":{"line":729,"column":15,"offset":32886},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If checked, the MQTT server FQDN or ip address must match the CN (Common Name) of the server certificate.","position":{"start":{"line":730,"column":1,"offset":32887},"end":{"line":730,"column":106,"offset":32992},"indent":[]}}],"position":{"start":{"line":730,"column":1,"offset":32887},"end":{"line":730,"column":106,"offset":32992},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Server","position":{"start":{"line":732,"column":7,"offset":33000},"end":{"line":732,"column":13,"offset":33006},"indent":[]}}],"position":{"start":{"line":732,"column":1,"offset":32994},"end":{"line":732,"column":13,"offset":33006},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"IP address or FQDN of the MQTT broker.","position":{"start":{"line":733,"column":1,"offset":33007},"end":{"line":733,"column":39,"offset":33045},"indent":[]}}],"position":{"start":{"line":733,"column":1,"offset":33007},"end":{"line":733,"column":39,"offset":33045},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Port","position":{"start":{"line":735,"column":7,"offset":33053},"end":{"line":735,"column":11,"offset":33057},"indent":[]}}],"position":{"start":{"line":735,"column":1,"offset":33047},"end":{"line":735,"column":11,"offset":33057},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"TCP port of the MQTT broker.","position":{"start":{"line":736,"column":1,"offset":33058},"end":{"line":736,"column":29,"offset":33086},"indent":[]}}],"position":{"start":{"line":736,"column":1,"offset":33058},"end":{"line":736,"column":29,"offset":33086},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Topic","position":{"start":{"line":738,"column":7,"offset":33094},"end":{"line":738,"column":12,"offset":33099},"indent":[]}}],"position":{"start":{"line":738,"column":1,"offset":33088},"end":{"line":738,"column":12,"offset":33099},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The topic to publish to.","position":{"start":{"line":739,"column":1,"offset":33100},"end":{"line":739,"column":25,"offset":33124},"indent":[]}}],"position":{"start":{"line":739,"column":1,"offset":33100},"end":{"line":739,"column":25,"offset":33124},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Username","position":{"start":{"line":741,"column":7,"offset":33132},"end":{"line":741,"column":15,"offset":33140},"indent":[]}}],"position":{"start":{"line":741,"column":1,"offset":33126},"end":{"line":741,"column":15,"offset":33140},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The username for authenticating to the MQTT broker. This is only supported by brokers that implement the MQTT spec v3.1. If username is not set (empty), the password argument is ignored. This is only needed if the MQTT broker is configured for authentication.","position":{"start":{"line":742,"column":1,"offset":33141},"end":{"line":742,"column":260,"offset":33400},"indent":[]}}],"position":{"start":{"line":742,"column":1,"offset":33141},"end":{"line":742,"column":260,"offset":33400},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Password","position":{"start":{"line":744,"column":7,"offset":33408},"end":{"line":744,"column":15,"offset":33416},"indent":[]}}],"position":{"start":{"line":744,"column":1,"offset":33402},"end":{"line":744,"column":15,"offset":33416},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The password to use, together with the username, for authenticating to the MQTT broker. This is only supported by brokers that implement the MQTT spec v3.1. This is only needed if the MQTT broker is configured for authentication.","position":{"start":{"line":745,"column":1,"offset":33417},"end":{"line":745,"column":230,"offset":33646},"indent":[]}}],"position":{"start":{"line":745,"column":1,"offset":33417},"end":{"line":745,"column":230,"offset":33646},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":747,"column":7,"offset":33654},"end":{"line":747,"column":16,"offset":33663},"indent":[]}}],"position":{"start":{"line":747,"column":1,"offset":33648},"end":{"line":747,"column":16,"offset":33663},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the MQTT will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":748,"column":1,"offset":33664},"end":{"line":748,"column":187,"offset":33850},"indent":[]}}],"position":{"start":{"line":748,"column":1,"offset":33664},"end":{"line":748,"column":187,"offset":33850},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Output","position":{"start":{"line":750,"column":7,"offset":33858},"end":{"line":750,"column":13,"offset":33864},"indent":[]}}],"position":{"start":{"line":750,"column":1,"offset":33852},"end":{"line":750,"column":13,"offset":33864},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A JSON object is published to the topic of the MQTT broker you have configured.","position":{"start":{"line":751,"column":1,"offset":33865},"end":{"line":751,"column":80,"offset":33944},"indent":[]}}],"position":{"start":{"line":751,"column":1,"offset":33865},"end":{"line":751,"column":80,"offset":33944},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"[\n 'regionCoordinates' : [618, 317, 703, 493],\n 'numberOfChanges' : 5446,\n 'timestamp' : '1465894497',\n 'microseconds' : '5-97451',\n 'token' : 695,\n 'pathToImage' : '1465894497_5-97451_frontdoor_618-317-703-493_5446_695.jpg',\n 'instanceName' : 'frontdoor',\n]","position":{"start":{"line":753,"column":1,"offset":33946},"end":{"line":763,"column":4,"offset":34223},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Example","position":{"start":{"line":765,"column":7,"offset":34231},"end":{"line":765,"column":14,"offset":34238},"indent":[]}}],"position":{"start":{"line":765,"column":1,"offset":34225},"end":{"line":765,"column":14,"offset":34238},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"It is possible to subscribe multiple distributed IoT devices to the same MQTT topic and perform specific actions upon the detection of a motion. Devices with more resources could fetch the image to perform further elaboration.","position":{"start":{"line":766,"column":1,"offset":34239},"end":{"line":766,"column":227,"offset":34465},"indent":[]}}],"position":{"start":{"line":766,"column":1,"offset":34239},"end":{"line":766,"column":227,"offset":34465},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Streaming","position":{"start":{"line":768,"column":4,"offset":34470},"end":{"line":768,"column":13,"offset":34479},"indent":[]}}],"position":{"start":{"line":768,"column":1,"offset":34467},"end":{"line":768,"column":13,"offset":34479},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The machinery has the ability to stream your capture device as a MJPG stream.","position":{"start":{"line":770,"column":1,"offset":34481},"end":{"line":770,"column":78,"offset":34558},"indent":[]}}],"position":{"start":{"line":770,"column":1,"offset":34481},"end":{"line":770,"column":78,"offset":34558},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":772,"column":5,"offset":34564},"end":{"line":772,"column":15,"offset":34574},"indent":[]}}],"position":{"start":{"line":772,"column":1,"offset":34560},"end":{"line":772,"column":15,"offset":34574},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters for the supported streaming protocols can be found in the ","position":{"start":{"line":774,"column":1,"offset":34576},"end":{"line":774,"column":74,"offset":34649},"indent":[]}},{"type":"inlineCode","value":"config/stream.xml","position":{"start":{"line":774,"column":74,"offset":34649},"end":{"line":774,"column":93,"offset":34668},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file; at the moment of writing only a MJPG stream is supported.","position":{"start":{"line":774,"column":93,"offset":34668},"end":{"line":774,"column":256,"offset":34831},"indent":[]}}],"position":{"start":{"line":774,"column":1,"offset":34576},"end":{"line":774,"column":256,"offset":34831},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\t\n \ttrue\n \t8889\n \t75\n \t\n \t75\n \n","position":{"start":{"line":776,"column":1,"offset":34833},"end":{"line":786,"column":4,"offset":35099},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Enabled","position":{"start":{"line":788,"column":6,"offset":35106},"end":{"line":788,"column":13,"offset":35113},"indent":[]}}],"position":{"start":{"line":788,"column":1,"offset":35101},"end":{"line":788,"column":13,"offset":35113},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A boolean which turns ON/OFF the stream. This is interesting when working with IP cameras, where you already have an RTSP/MJPG stream from the camera itself.","position":{"start":{"line":790,"column":1,"offset":35115},"end":{"line":790,"column":158,"offset":35272},"indent":[]}}],"position":{"start":{"line":790,"column":1,"offset":35115},"end":{"line":790,"column":158,"offset":35272},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Stream Port","position":{"start":{"line":792,"column":6,"offset":35279},"end":{"line":792,"column":17,"offset":35290},"indent":[]}}],"position":{"start":{"line":792,"column":1,"offset":35274},"end":{"line":792,"column":17,"offset":35290},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The port on which the stream is available.","position":{"start":{"line":794,"column":1,"offset":35292},"end":{"line":794,"column":43,"offset":35334},"indent":[]}}],"position":{"start":{"line":794,"column":1,"offset":35292},"end":{"line":794,"column":43,"offset":35334},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Quality","position":{"start":{"line":796,"column":6,"offset":35341},"end":{"line":796,"column":13,"offset":35348},"indent":[]}}],"position":{"start":{"line":796,"column":1,"offset":35336},"end":{"line":796,"column":13,"offset":35348},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The quality is a value between ","position":{"start":{"line":798,"column":1,"offset":35350},"end":{"line":798,"column":32,"offset":35381},"indent":[]}},{"type":"linkReference","identifier":"0-100","label":"0-100","referenceType":"shortcut","children":[{"type":"text","value":"0-100","position":{"start":{"line":798,"column":33,"offset":35382},"end":{"line":798,"column":38,"offset":35387},"indent":[]}}],"position":{"start":{"line":798,"column":32,"offset":35381},"end":{"line":798,"column":39,"offset":35388},"indent":[]}},{"type":"text","value":". The lower the quality, the more the image will be compressed. If you're using the RaspberryPi Camera module, this option will be ignored.","position":{"start":{"line":798,"column":39,"offset":35388},"end":{"line":798,"column":178,"offset":35527},"indent":[]}}],"position":{"start":{"line":798,"column":1,"offset":35350},"end":{"line":798,"column":178,"offset":35527},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Username/password","position":{"start":{"line":800,"column":6,"offset":35534},"end":{"line":800,"column":23,"offset":35551},"indent":[]}}],"position":{"start":{"line":800,"column":1,"offset":35529},"end":{"line":800,"column":23,"offset":35551},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can secure the MJPEG streaming with a username and password. These credentials will be used to authorize your requests using Basic Authentication. Please note that once enabled, the live stream on the dashboard page can fail; however it will work if you open it directly in your browser or ip camera client. The format of the streaming url, after authentication enabled, will look as following:","position":{"start":{"line":802,"column":1,"offset":35553},"end":{"line":802,"column":399,"offset":35951},"indent":[]}}],"position":{"start":{"line":802,"column":1,"offset":35553},"end":{"line":802,"column":399,"offset":35951},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"http://username:password@ip-camera:8899","position":{"start":{"line":804,"column":1,"offset":35953},"end":{"line":806,"column":4,"offset":36002},"indent":[1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":809,"column":1,"offset":36005},"end":{"line":809,"column":31,"offset":36035},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":809,"column":31,"offset":36035}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport { Playground, Props } from 'docz'\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Machinery`}

\n

{`The machinery is the processing engine of Kerberos Open Source. It's an image processing framework, written in C++, who benefits from other third party libraries (OpenCV, etc). It takes images from the type of camera (USB-, IP- or RPi-camera) you've configured in the configuration files and executes one ore more algorithms and post-processes (e.g. save a snapshot). The configuration files allow you to define the type of camera, post-processes, conditions and much more; it's highly configurable. It's important to note that the machinery, out-of-the-box, can handle only one camera at a time.`}

\n

{`Project structure`}

\n

{`The machinery is an image processing framework which is devided into four steps:`}

\n
    \n
  • {`condition`}
    • \n
  • {`algorithm`}
    • \n
  • {`expositor`}
    • \n
  • {`heuristic`}
    • \n
\n

{`The steps belong to a four passway; illustrated on the image below. In each cycle a sequence of images is processed. Each step will process the sequence, and will return some result to the next step. For example: an algorithm will process the images and returns an array to the Expositor, which contains boolean values. The steps are loosly coupled, so they have simple conventions, just like the example before.`}

\n

{`Thanks to the loosly coupling, each step can be developed indepently. So algorithms, expositors, heuristics and conditions can be switched on the fly. This makes it easier for other developers who want to contribute to the machinery. They can create a new algorithm without knowing how a specific expositor or heuristic works. They just need to be aware of the convention an algorithm should meet.`}

\n

\"machinery

\n

{`These different steps can be configured by editing a couple of configurationn files located at `}{`config/`}{`. The main configuration file `}{`config/config.xml`}{` looks like this:`}

\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    `}{`<`}{`name`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`frontdoor`}{`{`name`}{`>`}{`\n`}{`    `}{`<`}{`logging`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`logging`}{`>`}{`\n`}{`    `}{`<`}{`timezone`}{` `}{`type`}{`=`}{`\"timezone\"`}{`>`}{`Europe-Brussels`}{`{`timezone`}{`>`}{`\n`}{`    `}{`<`}{`capture`}{` `}{`file`}{`=`}{`\"capture.xml\"`}{`>`}{`RaspiCamera`}{`{`capture`}{`>`}{`\n`}{`    `}{`<`}{`stream`}{` `}{`file`}{`=`}{`\"stream.xml\"`}{`>`}{`Mjpg`}{`{`stream`}{`>`}{`\n`}{`    `}{`<`}{`condition`}{` `}{`file`}{`=`}{`\"condition.xml\"`}{` `}{`type`}{`=`}{`\"multiple\"`}{`>`}{`Enabled`}{`{`condition`}{`>`}{`\n`}{`    `}{`<`}{`algorithm`}{` `}{`file`}{`=`}{`\"algorithm.xml\"`}{`>`}{`DifferentialCollins`}{`{`algorithm`}{`>`}{`\n`}{`    `}{`<`}{`expositor`}{` `}{`file`}{`=`}{`\"expositor.xml\"`}{`>`}{`Hull`}{`{`expositor`}{`>`}{`\n`}{`    `}{`<`}{`heuristic`}{` `}{`file`}{`=`}{`\"heuristic.xml\"`}{`>`}{`Sequence`}{`{`heuristic`}{`>`}{`\n`}{`    `}{`<`}{`io`}{` `}{`file`}{`=`}{`\"io.xml\"`}{` `}{`type`}{`=`}{`\"multiple\"`}{`>`}{`Video`}{`{`io`}{`>`}{`\n`}{`    `}{`<`}{`cloud`}{` `}{`file`}{`=`}{`\"cloud.xml\"`}{`>`}{`S3`}{`{`cloud`}{`>`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`Capture`}

\n

{`You can choose which capture device you will be using, you can use your old USB webcam, the popular Raspberry Pi camera or a state-of-the-art IP camera. The capture device will take pictures and deliver them to the algorithm if the conditions (the first step of the four passway) are valid.`}

\n

{`You can change the capture device by changing the `}{`config/config.xml`}{` file, and choose one of the following:`}

\n
    \n
  • {`USBCamera`}
    • \n
  • {`RaspiCamera`}
    • \n
  • {`IPCamera`}
    • \n
\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    ...`}{`\n`}{`    `}{`<`}{`capture`}{` `}{`file`}{`=`}{`\"capture.xml\"`}{`>`}{`RaspiCamera`}{`{`capture`}{`>`}{`\n`}{`    ...`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`USB camera`}

\n

{`The machinery supports a whole range of USB cameras. You will find a complete list here. Make sure you have updated the web interface, to make the machinery aware you will be using an USB camera.`}

\n

{`Parameters`}

\n

{`The parameters of the USB camera can be found in the `}{`config/capture.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`captures`}{`>`}{`\n`}{`  `}{`<`}{`USBCamera`}{`>`}{`\n`}{`    `}{`<`}{`frameWidth`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1280`}{`{`frameWidth`}{`>`}{`\n`}{`    `}{`<`}{`frameHeight`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`720`}{`{`frameHeight`}{`>`}{`\n`}{`    `}{`<`}{`deviceNumber`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`deviceNumber`}{`>`}{`\n`}{`    `}{`<`}{`delay`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`delay`}{`>`}{`\n`}{`    `}{`<`}{`angle`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`angle`}{`>`}{`\n`}{`  `}{`{`USBCamera`}{`>`}{`\n`}{`{`captures`}{`>`}
\n
{`Framewidth and -height`}
\n

{`You can set the resolution of the capture device, make sure the resolution you've defined is valid with your camera. Please check the specs of the USB camera you're using.`}

\n
{`Device number`}
\n

{`If more than one device is connected, you can specify the index of the USB-camera. The index is an integer (1-5).`}

\n
{`Delay`}
\n

{`You can provide a delay/interval (milliseconds) between two captures.`}

\n
{`Angle`}
\n

{`By defining an angle (degrees), you can rotate the images taken by the capture device. For example if you would mount the camera upside down, than you could enter the value 180 as the angle; this will flip the images.`}

\n

{`Raspberry Pi Camera Module`}

\n

{`You can use the Raspberry Pi Camera Module with the machinery. You just need to attach the camera module and you're ready to go. The Raspberry Pi Camera Module is enabled by default in the web.`}

\n

{`Parameters`}

\n

{`The parameters of the Raspberry Pi Camera Module can be found in the config/capture.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`captures`}{`>`}{`\n`}{`  `}{`<`}{`RaspiCamera`}{`>`}{`\n`}{`    `}{`<`}{`frameWidth`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`640`}{`{`frameWidth`}{`>`}{`\n`}{`    `}{`<`}{`frameHeight`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`480`}{`{`frameHeight`}{`>`}{`\n`}{`    `}{`<`}{`delay`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1400`}{`{`delay`}{`>`}{`\n`}{`    `}{`<`}{`angle`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`angle`}{`>`}{`\n`}{`    `}{`<`}{`framerate`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`30`}{`{`framerate`}{`>`}{`\n`}{`    `}{`<`}{`sharpness`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`sharpness`}{`>`}{`\n`}{`    `}{`<`}{`saturation`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`saturation`}{`>`}{`\n`}{`    `}{`<`}{`contrast`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`contrast`}{`>`}{`\n`}{`    `}{`<`}{`brightness`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`50`}{`{`brightness`}{`>`}{`\n`}{`  `}{`{`RaspiCamera`}{`>`}{`\n`}{`{`captures`}{`>`}
\n
{`Framewidth and -height`}
\n

{`You can set the resolution of the camera module, make sure the resolution you've defined is valid.`}

\n
{`Delay`}
\n

{`You can provide a delay/interval (milliseconds) between two captures.`}

\n
{`Angle`}
\n

{`By defining an angle (degrees), you can rotate the images taken by the capture device. For example if you would mount the camera upside down, than you could enter the value 180 as the angle; this will flip the images.`}

\n
{`Framerate`}
\n

{`The number of frames captures per second. Please note that this parameter will also be used if you're recording video. E.g. if you set this parameter to 20, you're recorded videos will also be 20 FPS.`}

\n
{`Sharpness, saturation, contrast, brightness`}
\n

{`Camera properties which you can specify to tune the settings to your needs.`}

\n

{`IP camera`}

\n

{`The machinery can be used with any IP camera, that provides a RTSP (or MJPEG) stream. Make sure that you know the correct URL of your IP camera, you can `}{`find a list here`}{`.`}

\n

{`Parameters`}

\n

{`The parameters of the IP capture device can be found in the `}{`config/capture.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`captures`}{`>`}{`\n`}{`  `}{`<`}{`IPCamera`}{`>`}{`\n`}{`    `}{`<`}{`url`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`http://username:password@ipaddress/image.jpg`}{`{`url`}{`>`}{`\n`}{`    `}{`<`}{`frameWidth`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`800`}{`{`frameWidth`}{`>`}{`\n`}{`    `}{`<`}{`frameHeight`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`640`}{`{`frameHeight`}{`>`}{`\n`}{`    `}{`<`}{`delay`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`delay`}{`>`}{`\n`}{`    `}{`<`}{`angle`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`angle`}{`>`}{`\n`}{`  `}{`{`IPCamera`}{`>`}{`\n`}{`{`captures`}{`>`}
\n
{`URL`}
\n

{`To use your IP camera, you should provide a valid RTSP (or MJPEG) URL. The machinery will take snapshots from this stream.`}

\n
{`Framewidth and -height`}
\n

{`You can set the resolution of the capture device, make sure the resolution you've defined is equal to the resolution you've defined in your IP-camera software.`}

\n
{`Delay`}
\n

{`You can provide a delay/interval (milliseconds) between two captures.`}

\n
{`Angle`}
\n

{`By defining an angle (degrees), you can rotate the images taken by the capture device. For example if you would mount the camera upside down, than you could enter the value 180 as the angle; this will flip the images.`}

\n

{`Condition`}

\n

{`The condition is the first step of the four passway. In this step the machinery will determine if it's allowed to proceed to the next step. For example a condition can be a time constraint, a brightness threshold, etc; multiple conditions can be selected.`}

\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    ...`}{`\n`}{`    `}{`<`}{`condition`}{` `}{`file`}{`=`}{`\"condition.xml\"`}{` `}{`type`}{`=`}{`\"multiple\"`}{`>`}{`Enabled`}{`{`condition`}{`>`}{`\n`}{`    ...`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`Enabled`}

\n

{`It can be helpful to enable or disable the machinery at specific times. Therefore the time condition makes it possible to select a time range for each day of the week. When the current time is within the time range, the machinery will be enabled.`}

\n

{`Parameters`}

\n

{`The parameters of the Enabled condition can be found in the `}{`config/condition.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`conditions`}{`>`}{`\n`}{`  `}{`<`}{`Enabled`}{`>`}{`\n`}{`    `}{`<`}{`active`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`true`}{`{`active`}{`>`}{`\n`}{`    `}{`<`}{`delay`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`5000`}{`{`delay`}{`>`}{`\n`}{`  `}{`{`Enabled`}{`>`}{`\n`}{`{`conditions`}{`>`}
\n
{`Active`}
\n

{`The active field is boolean value (true/false). When the active field is true, the machinery is enabled, if not it's disabled.`}

\n
{`Delay`}
\n

{`The delay value is used when the condition failed, so when the current time isn't in the selected time range for that day. In that case the machinery will idle for the specified delay time. The value of the delay is expressed in miliseconds.`}

\n

{`Time`}

\n

{`It can be helpful to enable or disable the machinery at specific times. Therefore the time condition makes it possible to select a time range for each day of the week. When the current time is within the time range, the machinery will be enabled.`}

\n

{`Parameters`}

\n

{`The parameters of the Time condition can be found in the `}{`config/condition.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`conditions`}{`>`}{`\n`}{`  `}{`<`}{`Time`}{`>`}{`\n`}{`    `}{`<`}{`times`}{` `}{`type`}{`=`}{`\"timeselection\"`}{`>`}{`13:00,15:00-0:01,20:58-0:01,20:59-0:01,19:20-0:01,21:59-0,0-0,0`}{`{`times`}{`>`}{`\n`}{`    `}{`<`}{`delay`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`10000`}{`{`delay`}{`>`}{`\n`}{`  `}{`{`Time`}{`>`}{`\n`}{`{`conditions`}{`>`}
\n
{`Times`}
\n

{`The times property contains a list of times, delimited by a \"-\". The first item in the list will specify the time range for the first day of the week (Monday), the last item for the last day of the week (Sunday). The begin- and end-time, for a specific day, are delimited by a \",\" where the first element will specify that start time and the second one specifies the end time.`}

\n
{`Delay`}
\n

{`The delay value is used when the condition failed, so when the current time isn't in the selected time range for that day. In that case the machinery will idle for the specified delay time. The value of the delay is expressed in miliseconds.`}

\n

{`Algorithm`}

\n

{`The algorithm is the second step of the four passway. An algorithm will execute some kind of function on a sequence of images, and end up with a black and white image; just like the image below. An example of an algorithm would be one that does motion detection or one that would detect cats or dogs (using TensorFlow, ar any other Deep Learning framework).`}

\n

\"machinery

\n

{`The white pixels on the image will indicate the object of interest. For example, when looking for motion, the pixels that have been changed; it depends on what the algorithm is looking for. The black pixels are background pixels.`}

\n

{`The only convention that an algorithm should meet is that it should return a black and white image to the next step; the expositor. And of course that it requires a sequence of images as a parameter. Besides those conventions, an algorithm can do everything it wants to do. So you could create your own cat detection algorithm, marker detection, etc.`}

\n

{`You can select the algortihm in the `}{`config/config.xml`}{`.`}

\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    ...`}{`\n`}{`    `}{`<`}{`algorithm`}{` `}{`file`}{`=`}{`\"algorithm.xml\"`}{`>`}{`DifferentialCollins`}{`{`algorithm`}{`>`}{`\n`}{`    ...`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`Differential images`}

\n

{`This algorithm is a very simple method to detect motion; in terms of understanding but also processing. Just like the name says, it's the result of comparing images. When the images are compared, we know the pixels that have been changed and if the amount of pixels that changed is big enough, one can say that something happened and thus motion was detected.`}

\n

{`To get a more technical explanation: the algoritm will substract 2 or more images, and once that is done it will end up with a black and white image. The white pixels will mark the pixels that where different/changed and the black pixels are the pixels that have not changed; background pixels. Please note that there are several different combinations of substracting images. However for the machinery, we will use the method of Collins et al. as this method erases the phenomenon \"ghosting\".`}

\n

\"machinery

\n

{`In the image above the method of Collins et al. is illustrated. For this method we will process three images. The images are a sequence (from left to right), so the first (A) image was taken before the second (B) one, and the second (B) before the third (C) one. Next we will do a first comparision (C-B) of the third (C) image and the second (B) image, and after that we will do a second comparison (C-A) of the third (C) image and first (A) image.`}

\n

{`After the comparison we will end up with two difference images (C-B) and (C-A); both will mark the white pixels as changed pixels and black as non-changed pixels. To finish the algorithm we will do a logical AND-operation of the two difference images; this will give us the final black and white image ((C-B)&&(C-A)).`}

\n

{`The main idea of the Colins et al. method, is that it will erase \"ghosting\". In the last step we are doing a logical AND-operation, by doing this we will only keep the pixels, that changed in the first two images; therefore we can elimante false positives.`}

\n

{`Parameters`}

\n

{`The parameters of the Differential images algorithm can be found in the config/algorithm.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`algorithms`}{`>`}{`\n`}{`  `}{`<`}{`DifferentialCollins`}{`>`}{`\n`}{`    `}{`<`}{`erode`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`5`}{`{`erode`}{`>`}{`\n`}{`    `}{`<`}{`threshold`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`20`}{`{`threshold`}{`>`}{`\n`}{`  `}{`{`DifferentialCollins`}{`>`}{`\n`}{`{`algorithms`}{`>`}
\n
{`Erode`}
\n

{`The erode parameter represents a structural element (a morphological operation), which will be used to minimize the changed pixels; more information about eroding can be found here. The idea of the eroding is that pixels which are isolated will be removed; this means that when only one pixel changed, that pixel will reverted to the non-changed state. But for example when a large change happens and a lot of adjacent pixels are changed, the eroding will not be able to revert them.`}

\n

{`The higher the number of the erode parameter, the more aggressive the eroding will be. So high erode values, will make it possible that also large changes will be reverted to the non-changed state.`}

\n
{`Threshold`}
\n

{`When doing the comparison of two images, we won't end up with a clean black and white image. In most of the cases the values will be between 0 and 255; so gray values. This means that the value 0 will mean that both pixels where the same in both image, and values 255 mean that both pixels where totally different in both images. Of course we will also have values between 0-255, so pixels that are a little bit different in both images. So to make the resulting black and white image, we will need to apply a threshold value.`}

\n

{`The threshold will specify how much a pixel has to be different in the two images. So for example when the threshold is 30, it means that the difference between two pixels has to be equal or more then 30. The higher the threshold the more the pixel needs to be different, to be marked as changed.`}

\n

{`Expositor`}

\n

{`After the algorithm is executed, the expositor will determine, a region, where the changes were detected. An expositor can constrain a region in terms of selecting a hull or defining a rectangle.`}

\n

{`An expositor receives a black and white image as parameter and should modify a JSON object with all the information it processed. The JSON object must include: the bounding rectangle(s) of the positions where the pixels of interest are located and the number of pixels of interest. But can also include other optional parameters.`}

\n

{`You can change the expositor by changing the `}{`config/config.xml`}{` file, and choose one of the following:`}

\n
    \n
  • {`Hull`}
    • \n
  • {`Rectangle`}
    • \n
\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    ...`}{`\n`}{`    `}{`<`}{`expositor`}{` `}{`file`}{`=`}{`\"expositor.xml\"`}{`>`}{`Hull`}{`{`expositor`}{`>`}{`\n`}{`    ...`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`Rectangle`}

\n

{`This is a trivial expositor. A rectangle region can be defined to constrain the locations of pixels of interest. The rectangle repositor will return the region of the pixels of interest.`}

\n

{`Parameters`}

\n

{`The parameters of the rectangle expositor can be found in the config/expositor.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`expositors`}{`>`}{`\n`}{`  `}{`<`}{`Rectangle`}{`>`}{`\n`}{`    `}{`<`}{`region`}{`>`}{`\n`}{`      `}{`<`}{`x1`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`x1`}{`>`}{`\n`}{`      `}{`<`}{`y1`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`y1`}{`>`}{`\n`}{`      `}{`<`}{`x2`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1280`}{`{`x2`}{`>`}{`\n`}{`      `}{`<`}{`y2`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`720`}{`{`y2`}{`>`}{`\n`}{`    `}{`{`region`}{`>`}{`\n`}{`  `}{`{`Rectangle`}{`>`}{`\n`}{`{`expositors`}{`>`}
\n
{`Region`}
\n

{`The region parameter contains 4 values; x1, y1, x2 and y2 respectively. The values x1 and y1 indicate the x- and y-coordinate of the left upper starting point. The values x2 and y2 are the bottom right coordinates. A virtual rectangle will be drawn from (x1,y1) to (x2,y2). Pixels of interest that lie within this rectangle are valid pixels; if not they are invalid.`}

\n

{`Hull`}

\n

{`This hull is a more complex expositor than the rectangle. A hull can be selected with the web, you can select one or more coordinates to create a flexible region. The coordinates can be adjusted afterwards and be removed by double clicking on the coordinate. You can expand the hull by removing the start coordinate, which is marked by the white bullet.`}

\n

\"machinery

\n

{`Parameters`}

\n

{`The parameters of the hull expositor can be found in the config/expositor.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`expositors`}{`>`}{`\n`}{`  `}{`<`}{`Hull`}{`>`}{`\n`}{`    `}{`<`}{`region`}{` `}{`type`}{`=`}{`\"hullselection\"`}{`>`}{`347,361|627,266|975,328|1091,328|1148,413|1158,516|1121,534|962,567|699,648|531,700|243,613|423,550|665,453|850,470|666,361|467,385|325,460|165,372`}{`{`region`}{`>`}{`\n`}{`  `}{`{`Hull`}{`>`}{`\n`}{`{`expositors`}{`>`}
\n
{`Region`}
\n

{`The region parameter contains n values. Each value represents a coordinate (x,y) and are seperated by the \"|\" delimiter. These coordinates are used to calculate the concave hull. Pixels of interest that lie within the concave hull are valid pixels; if not they are invalid.`}

\n

{`Heuristic`}

\n

{`The heuristic is the last step in the four passway which will decide if the detection is valid or not. It will do this by using information from the previous steps (the expositor and the algorithm); e.g. number of changed pixels.`}

\n

{`You can change the heuristic by changing the `}{`config/config.xml`}{` file, and choose one of the following:`}

\n
    \n
  • {`Sequence`}
    • \n
\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    ...`}{`\n`}{`    `}{`<`}{`heuristic`}{` `}{`file`}{`=`}{`\"heuristic.xml\"`}{`>`}{`Sequence`}{`{`heuristic`}{`>`}{`\n`}{`    ...`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`Sequence`}

\n

{`This is a trivial heuristic. The sequence heuristic will store a single integer in memory, that will count the numbers of valid detections. When the heuristic will detect a false detection, it will decrease the count. The sequence heuristic will return true, if a threshold is reached; for example when something was detected three times in a row.`}

\n

{`Parameters`}

\n

{`The parameters of the Sequence heuristic can be found in the config/heuristic.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`heuristics`}{`>`}{`\n`}{`<`}{`Sequence`}{`>`}{`\n`}{`    `}{`<`}{`minimumChanges`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1`}{`{`minimumChanges`}{`>`}{`\n`}{`    `}{`<`}{`minimumDuration`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1`}{`{`minimumDuration`}{`>`}{`\n`}{`    `}{`<`}{`noMotionDelayTime`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`2000`}{`{`noMotionDelayTime`}{`>`}{`\n`}{`  `}{`{`Sequence`}{`>`}{`\n`}{`{`heuristics`}{`>`}
\n
{`Minimum changes`}
\n

{`The heuristic will only return true if enough changes have been detected. The minimum of changes indicates the minimum number of pixels that have to been changed, to be a valid detection.`}

\n
{`Minimum durations`}
\n

{`The minimum number of detections in a row to be a valid detection.`}

\n
{`No motion delay time`}
\n

{`When the heuristic failed, due to not enough pixels changed or not x detections in a row, the heuristic will idle for some time.`}

\n

{`Output`}

\n

{`If the heuristic determined that the evaluation was valid, one or more output operations can be executed. You configure which ooutput operations that will be executed, by modifying the configuration file or using the web interface.`}

\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    ...`}{`\n`}{`    `}{`<`}{`io`}{` `}{`file`}{`=`}{`\"io.xml\"`}{` `}{`type`}{`=`}{`\"multiple\"`}{`>`}{`Video`}{`{`io`}{`>`}{`\n`}{`    ...`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`You can choose which output devices you will be using. If you select multiple outputs, seperate them with an `}{`,`}{`. You can change the output device by changing the `}{`config/config.xml`}{` file, and choose one of the following:`}

\n
    \n
  • {`Disk`}
    • \n
  • {`Video`}
    • \n
  • {`GPIO`}
    • \n
  • {`TCPSocket`}
    • \n
  • {`Webhook`}
    • \n
  • {`MQTT`}
    • \n
  • {`Script`}
    • \n
\n

{`Disk`}

\n

{`An image can be saved to disk.`}

\n

{`Parameters`}

\n

{`The parameters of the Disk output device can be found in the `}{`config/io.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`>`}{`\n`}{`  `}{`<`}{`Disk`}{`>`}{`\n`}{`    `}{`<`}{`fileFormat`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`timestamp_microseconds_instanceName_regionCoordinates_numberOfChanges_token.jpg`}{`{`fileFormat`}{`>`}{`\n`}{`    `}{`<`}{`directory`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`/etc/opt/kerberosio/capture/`}{`{`directory`}{`>`}{`\n`}{`    `}{`<`}{`markWithTimestamp`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`markWithTimestamp`}{`>`}{`\n`}{`    `}{`<`}{`timestampColor`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`white`}{`{`timestampColor`}{`>`}{`\n`}{`    `}{`<`}{`privacy`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`privacy`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`Disk`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`File format`}
\n

{`The format that will be used for the name of the image. One or more variables can be defined and will be replaced by the machinery. Note that when you're using a variables name in the file format, that this name should be defined in the JSON object.`}

\n
{`Directory`}
\n

{`The directory where the image will be saved to. By default images are saved to the /etc/opt/kerberosio/capture directory.`}

\n
{`Mark with timestamp`}
\n

{`When this settings is set to true, the image is marked with a timestamp.`}

\n
{`Timestamp color`}
\n

{`A color can be defined for timestamp: white, black, red, green and blue.`}

\n
{`Privacy`}
\n

{`The privacy mode can be activated to remove some parts from the image. This especially helpful if you want to filter out public areas. When this option is enabled you will seee that after configuring the Hull expositor, you'll see that the pixels outside your region of interest (Hull) are made black.`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Disk will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n

{`Video`}

\n

{`When a valid event is detected, a video will be recorded for x seconds. When more valid events are detected, while a video is recording, the video file will further record for x seconds; so no new video file be recorded, but the existing one will be expanded.`}

\n

{`Parameters`}

\n

{`The parameters of the Video output device can be found in the `}{`config/io.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`>`}{`\n`}{`  `}{`<`}{`Video`}{`>`}{`\n`}{`    `}{`<`}{`fps`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`3`}{`{`fps`}{`>`}{`\n`}{`    `}{`<`}{`recordAfter`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`5`}{`{`recordAfter`}{`>`}{`\n`}{`    `}{`<`}{`maxDuration`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`120`}{`{`maxDuration`}{`>`}{`\n`}{`    `}{`<`}{`extension`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`mp4`}{`{`extension`}{`>`}{`\n`}{`    `}{`<`}{`codec`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`h264`}{`{`codec`}{`>`}{`\n`}{`    `}{`<`}{`fileFormat`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`timestamp_microseconds_instanceName_regionCoordinates_numberOfChanges_token`}{`{`fileFormat`}{`>`}{`\n`}{`    `}{`<`}{`directory`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`/etc/opt/kerberosio/capture/`}{`{`directory`}{`>`}{`\n`}{`    `}{`<`}{`hardwareDirectory`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`/etc/opt/kerberosio/h264/`}{`{`hardwareDirectory`}{`>`}{`\n`}{`    `}{`<`}{`enableHardwareEncoding`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`true`}{`{`enableHardwareEncoding`}{`>`}{`\n`}{`    `}{`<`}{`markWithTimestamp`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`markWithTimestamp`}{`>`}{`\n`}{`    `}{`<`}{`timestampColor`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`white`}{`{`timestampColor`}{`>`}{`\n`}{`    `}{`<`}{`privacy`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`privacy`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`Video`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`FPS`}
\n

{`The frames per second of the video being recorded. Please note that this number is limited and depends heavily on your hardware setup. You'll be receiving following warning in the systems logs, if the machinery can't write the desired FPS.`}

\n 
{`[trivial] IoVideo: framerate is too fast, can't record video at this speed (8/FPS)`}
\n
{`Record after`}
\n

{`The number of seconds recorded after the last valid event was detected. This means that when a video is already recording, and a valid event was detected, the video will be expanded with x more seconds.`}

\n
{`Extensions`}
\n

{`The extension or container of the video file. We highly recommend to use the MP4 container if you want cross-browser support. Leave this setting by default, if you don't know what you're doing.`}

\n
{`Codec`}
\n

{`The codec that is used to encode the video file.`}

\n
{`File format`}
\n

{`The format that will be used for the name of the image. One or more variables can be defined and will be replaced by the machinery. Note that when you're using a variables name in the file format, that this name should be defined in the JSON object.`}

\n
{`Directory`}
\n

{`The directory where the videos will be saved. By default videos are saved to the /etc/opt/kerberosio/capture directory.`}

\n
{`Hardware directory`}
\n

{`When using onboard hardware encoding (e.g. with Raspberry Pi camera), h264 video files are generated and stored in this directory. Afterwards these h264 files will be containerized to mp4 files, and stored in the Directory path.`}

\n
{`Enable Hardware encoding`}
\n

{`A boolean which can enable or disable hardware encoding. Please note that this option is enabled by default, but does not mean that it will work if you choose to use an USB camera.`}

\n
{`Mark with timestamp`}
\n

{`When this settings is set to true, the video is marked with a timestamp (similar to the Disk device).`}

\n
{`Timestamp color`}
\n

{`A color can be defined for timestamp: white, black, red, green and blue.`}

\n
{`Privacy`}
\n

{`The privacy mode can be activated to remove some parts from the video. This especially helpful if you want to filter out public areas.`}

\n
{`Video privacy`}
\n

{`After updating the configuration, you'll see that the pixels outside your region of interest (ROI) are made black; the image below illustrates this.`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Video will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n

{`TCP/IP client`}

\n

{`The TCP/IP client will send a TCP packet to a server.`}

\n

{`Parameters`}

\n

{`The parameters of the TCP/IP client can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`>`}{`\n`}{`  `}{`<`}{`TCPSocket`}{`>`}{`\n`}{`    `}{`<`}{`server`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`127.0.0.1`}{`{`server`}{`>`}{`\n`}{`    `}{`<`}{`port`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1337`}{`{`port`}{`>`}{`\n`}{`    `}{`<`}{`message`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`it's so fluffy`}{`{`message`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`TCPSocket`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`Server`}
\n

{`The IP of the TCP server.`}

\n
{`Port`}
\n

{`This is the port of the TCP server.`}

\n
{`Message`}
\n

{`You can send some data to a TCP server.`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the TCP will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n

{`GPIO`}

\n

{`A GPIO pin can be set as output device.`}

\n

{`Parameters`}

\n

{`The parameters of the GPIO pin can be found in the `}{`config/io.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`>`}{`\n`}{`  `}{`<`}{`GPIO`}{`>`}{`\n`}{`    `}{`<`}{`pin`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`17`}{`{`pin`}{`>`}{`\n`}{`    `}{`<`}{`periods`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`5`}{`{`periods`}{`>`}{`\n`}{`    `}{`<`}{`periodTime`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`100000`}{`{`periodTime`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`GPIO`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`Pin`}
\n

{`The pin that will be triggered.`}

\n
{`Periods`}
\n

{`The number of times the pin will be triggered.`}

\n
{`Period time`}
\n

{`The time in microseconds that the pin will be set high.`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the GPIO will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n

{`Webhook`}

\n

{`Detailed information (a JSON object) is send as a POST request to a webhook. The JSON object contains the number of changes, the region, the URL of the image, etc. This is useful if you want to integrate with your own application.`}

\n

{`Make sure that the Webhook comes after the Disk device, otherwise the URL of the image is not included.`}

\n

{`Parameters`}

\n

{`The parameters of the webhook can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`>`}{`\n`}{`  `}{`<`}{`Webhook`}{`>`}{`\n`}{`    `}{`<`}{`url`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`http://kerberos.web/api/v1/webhook`}{`{`url`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`Webhook`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`Url`}
\n

{`This is the URL, to which the machinery will send a JSON object (as a POST request).`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Webhook will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n
{`Output`}
\n

{`A JSON object is POSTed to the url you've defined.`}

\n 
{`[`}{`\n`}{`  `}{`'regionCoordinates'`}{` `}{`:`}{` [`}{`618`}{`, `}{`317`}{`, `}{`703`}{`, `}{`493`}{`],`}{`\n`}{`  `}{`'numberOfChanges'`}{` `}{`:`}{` `}{`5446`}{`,`}{`\n`}{`  `}{`'timestamp'`}{` `}{`:`}{` `}{`'`}{`1465894497`}{`'`}{`,`}{`\n`}{`  `}{`'microseconds'`}{` `}{`:`}{` `}{`'`}{`5-97451`}{`'`}{`,`}{`\n`}{`  `}{`'token'`}{` `}{`:`}{` `}{`695`}{`,`}{`\n`}{`  `}{`'pathToImage'`}{` `}{`:`}{` `}{`'`}{`1465894497`}{`_`}{`5-97451`}{`_frontdoor_`}{`618-317-703-493`}{`_`}{`5446`}{`_`}{`695`}{`.jpg'`}{`,`}{`\n`}{`  `}{`'instanceName'`}{` `}{`:`}{` `}{`'frontdoor'`}{`,`}{`\n`}{`]`}
\n

{`Script`}

\n

{`A bash script can be executed after a valid event was detected. A JSON object is send in the first parameter to the script you've defined.`}

\n

{`Parameters`}

\n

{`The parameters of the Script output device can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`>`}{`\n`}{`  `}{`<`}{`Script`}{`>`}{`\n`}{`    `}{`<`}{`path`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`/etc/opt/kerberosio/scripts/run.sh`}{`{`path`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`Script`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`Path`}
\n

{`The location of the script that will be executed on detection.`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Script will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n
{`Example`}
\n

{`By default the script will point to /etc/opt/kerberosio/scripts/run.sh, which contains a template how you should start your script. Note that when using KiOS, this script will be read-only, copy it to the /data folder and change the path parameter.`}

\n 
{`#!/bin/bash`}{`\n`}{`# -------------------------------------------`}{`\n`}{`# This is an example script which illustrates`}{`\n`}{`# how to use the Script IO device.`}{`\n`}{`#`}{`\n`}{`# --------------------------------------`}{`\n`}{`# The first parameter is the JSON object`}{`\n`}{`#`}{`\n`}{`# e.g. {\"regionCoordinates\":[308,250,346,329],\"numberOfChanges\":194,\"timestamp\":\"1486049622\",\"microseconds\":\"6-161868\",\"token\":344,\"pathToImage\":\"1486049622_6-161868_frontdoor_308-250-346-329_194_344.jpg\",\"instanceName\":\"frontdoor\"}`}{`\n`}{`JSON=`}{`$`}{`1`}{`\n`}{`# -------------------------------------------`}{`\n`}{`# You can use python to parse the JSON object`}{`\n`}{`# and get the required fields`}{`\n`}{`name=`}{`$`}{`(echo `}{`$`}{`JSON | python -c `}{`\"import sys, json; print json.load(sys.stdin)['instanceName']\"`}{`)`}{`\n`}{`coordinates=`}{`$`}{`(echo `}{`$`}{`JSON | python -c `}{`\"import sys, json; print json.load(sys.stdin)['regionCoordinates']\"`}{`)`}{`\n`}{`changes=`}{`$`}{`(echo `}{`$`}{`JSON | pythfon -c `}{`\"import sys, json; print json.load(sys.stdin)['numberOfChanges']\"`}{`)`}{`\n`}{`image=`}{`$`}{`(echo `}{`$`}{`JSON | python -c `}{`\"import sys, json; print json.load(sys.stdin)['pathToImage']\"`}{`)`}{`\n`}{`The idea `}{`is`}{` that you can use Python `}{`in`}{` your bash script, to parse the JSON `}{`object`}{` send `}{`as`}{` first parameter. Afterwards you can do `}{`with`}{` the output what you want.`}
\n

{`MQTT`}

\n

{`MQTT protocol is a light-weight Machine to Machine (M2M) protocol widely used in Internet of things.\nDetailed information (a JSON object) is published to an MQTT topic. The JSON object contains the number of changes, the region, the URL of the image, etc.`}

\n

{`Parameters`}

\n

{`The parameters of the MQTT output can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`\n`}{`  {`>`}{`\n`}{`    `}{`<`}{`secure`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`secure`}{`>`}{`\n`}{`    `}{`<`}{`verifycn`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`verifycn`}{`>`}{`\n`}{`    `}{`<`}{`server`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`127.0.0.1`}{`{`server`}{`>`}{`\n`}{`    `}{`<`}{`port`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1883`}{`{`port`}{`>`}{`\n`}{`    `}{`<`}{`topic`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`kios/mqtt`}{`{`topic`}{`>`}{`\n`}{`    `}{`<`}{`username`}{` `}{`type`}{`=`}{`\"text\"`}{`>{`username`}{`>`}{`\n`}{`    `}{`<`}{`password`}{` `}{`type`}{`=`}{`\"text\"`}{`>{`password`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`MQTT`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`Secure`}
\n

{`If checked, enable SSL/TLS support. Please note that when SSL/TLS support is enabled, the server certificate issuer is verified against the CA (Certification Authority) files available in /etc/ssl/certs.`}

\n
{`Verifycn`}
\n

{`If checked, the MQTT server FQDN or ip address must match the CN (Common Name) of the server certificate.`}

\n
{`Server`}
\n

{`IP address or FQDN of the MQTT broker.`}

\n
{`Port`}
\n

{`TCP port of the MQTT broker.`}

\n
{`Topic`}
\n

{`The topic to publish to.`}

\n
{`Username`}
\n

{`The username for authenticating to the MQTT broker. This is only supported by brokers that implement the MQTT spec v3.1. If username is not set (empty), the password argument is ignored. This is only needed if the MQTT broker is configured for authentication.`}

\n
{`Password`}
\n

{`The password to use, together with the username, for authenticating to the MQTT broker. This is only supported by brokers that implement the MQTT spec v3.1. This is only needed if the MQTT broker is configured for authentication.`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the MQTT will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n
{`Output`}
\n

{`A JSON object is published to the topic of the MQTT broker you have configured.`}

\n 
{`[`}{`\n`}{`  `}{`'regionCoordinates'`}{` `}{`:`}{` [`}{`618`}{`, `}{`317`}{`, `}{`703`}{`, `}{`493`}{`],`}{`\n`}{`  `}{`'numberOfChanges'`}{` `}{`:`}{` `}{`5446`}{`,`}{`\n`}{`  `}{`'timestamp'`}{` `}{`:`}{` `}{`'`}{`1465894497`}{`'`}{`,`}{`\n`}{`  `}{`'microseconds'`}{` `}{`:`}{` `}{`'`}{`5-97451`}{`'`}{`,`}{`\n`}{`  `}{`'token'`}{` `}{`:`}{` `}{`695`}{`,`}{`\n`}{`  `}{`'pathToImage'`}{` `}{`:`}{` `}{`'`}{`1465894497`}{`_`}{`5-97451`}{`_frontdoor_`}{`618-317-703-493`}{`_`}{`5446`}{`_`}{`695`}{`.jpg'`}{`,`}{`\n`}{`  `}{`'instanceName'`}{` `}{`:`}{` `}{`'frontdoor'`}{`,`}{`\n`}{`]`}
\n
{`Example`}
\n

{`It is possible to subscribe multiple distributed IoT devices to the same MQTT topic and perform specific actions upon the detection of a motion. Devices with more resources could fetch the image to perform further elaboration.`}

\n

{`Streaming`}

\n

{`The machinery has the ability to stream your capture device as a MJPG stream.`}

\n

{`Parameters`}

\n

{`The parameters for the supported streaming protocols can be found in the `}{`config/stream.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file; at the moment of writing only a MJPG stream is supported.`}

\n 
{`<`}{`streams`}{`>`}{`\n`}{`\t`}{`<`}{`Mjpg`}{`>`}{`\n`}{`    \t`}{`<`}{`enabled`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`true`}{`{`enabled`}{`>`}{`\n`}{`    \t`}{`<`}{`streamPort`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`8889`}{`{`streamPort`}{`>`}{`\n`}{`    \t`}{`<`}{`quality`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`75`}{`{`quality`}{`>`}{`\n`}{`    \t`}{`<`}{`username`}{` `}{`type`}{`=`}{`\"number\"`}{`>{`username`}{`>`}{`\n`}{`    \t`}{`<`}{`password`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`75`}{`{`password`}{`>`}{`\n`}{`    `}{`{`Mjpg`}{`>`}{`\n`}{`{`streams`}{`>`}
\n

{`Enabled`}

\n

{`A boolean which turns ON/OFF the stream. This is interesting when working with IP cameras, where you already have an RTSP/MJPG stream from the camera itself.`}

\n

{`Stream Port`}

\n

{`The port on which the stream is available.`}

\n

{`Quality`}

\n

{`The quality is a value between `}{`[0-100]`}{`. The lower the quality, the more the image will be compressed. If you're using the RaspberryPi Camera module, this option will be ignored.`}

\n

{`Username/password`}

\n

{`You can secure the MJPEG streaming with a username and password. These credentials will be used to authorize your requests using Basic Authentication. Please note that once enabled, the live stream on the dashboard page can fail; however it will work if you open it directly in your browser or ip camera client. The format of the streaming url, after authentication enabled, will look as following:`}

\n 
{`http:`}{`//username:password@ip-camera:8899`}
\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file +{"expireTime":9007200861750192000,"key":"gatsby-plugin-mdx-entire-payload-a79531575b5a9e24fdd84c6824bcabed-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"import","value":"import { Playground, Props } from 'docz'","position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":41,"offset":199},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Machinery","position":{"start":{"line":10,"column":3,"offset":203},"end":{"line":10,"column":12,"offset":212},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":201},"end":{"line":10,"column":12,"offset":212},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The machinery is the processing engine of Kerberos Open Source. It's an image processing framework, written in C++, who benefits from other third party libraries (OpenCV, etc). It takes images from the type of camera (USB-, IP- or RPi-camera) you've configured in the configuration files and executes one ore more algorithms and post-processes (e.g. save a snapshot). The configuration files allow you to define the type of camera, post-processes, conditions and much more; it's highly configurable. It's important to note that the machinery, out-of-the-box, can handle only one camera at a time.","position":{"start":{"line":12,"column":1,"offset":214},"end":{"line":12,"column":597,"offset":810},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":214},"end":{"line":12,"column":597,"offset":810},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Project structure","position":{"start":{"line":14,"column":4,"offset":815},"end":{"line":14,"column":21,"offset":832},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":812},"end":{"line":14,"column":21,"offset":832},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The machinery is an image processing framework which is devided into four steps:","position":{"start":{"line":16,"column":1,"offset":834},"end":{"line":16,"column":81,"offset":914},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":834},"end":{"line":16,"column":81,"offset":914},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"condition","position":{"start":{"line":18,"column":3,"offset":918},"end":{"line":18,"column":12,"offset":927},"indent":[]}}],"position":{"start":{"line":18,"column":3,"offset":918},"end":{"line":18,"column":12,"offset":927},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":916},"end":{"line":18,"column":12,"offset":927},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"algorithm","position":{"start":{"line":19,"column":3,"offset":930},"end":{"line":19,"column":12,"offset":939},"indent":[]}}],"position":{"start":{"line":19,"column":3,"offset":930},"end":{"line":19,"column":12,"offset":939},"indent":[]}}],"position":{"start":{"line":19,"column":1,"offset":928},"end":{"line":19,"column":12,"offset":939},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"expositor","position":{"start":{"line":20,"column":3,"offset":942},"end":{"line":20,"column":12,"offset":951},"indent":[]}}],"position":{"start":{"line":20,"column":3,"offset":942},"end":{"line":20,"column":12,"offset":951},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":940},"end":{"line":20,"column":12,"offset":951},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"heuristic","position":{"start":{"line":21,"column":3,"offset":954},"end":{"line":21,"column":12,"offset":963},"indent":[]}}],"position":{"start":{"line":21,"column":3,"offset":954},"end":{"line":21,"column":12,"offset":963},"indent":[]}}],"position":{"start":{"line":21,"column":1,"offset":952},"end":{"line":21,"column":12,"offset":963},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":916},"end":{"line":21,"column":12,"offset":963},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"The steps belong to a four passway; illustrated on the image below. In each cycle a sequence of images is processed. Each step will process the sequence, and will return some result to the next step. For example: an algorithm will process the images and returns an array to the Expositor, which contains boolean values. The steps are loosly coupled, so they have simple conventions, just like the example before.","position":{"start":{"line":23,"column":1,"offset":965},"end":{"line":23,"column":413,"offset":1377},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":965},"end":{"line":23,"column":413,"offset":1377},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Thanks to the loosly coupling, each step can be developed indepently. So algorithms, expositors, heuristics and conditions can be switched on the fly. This makes it easier for other developers who want to contribute to the machinery. They can create a new algorithm without knowing how a specific expositor or heuristic works. They just need to be aware of the convention an algorithm should meet.","position":{"start":{"line":25,"column":1,"offset":1379},"end":{"line":25,"column":398,"offset":1776},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1379},"end":{"line":25,"column":398,"offset":1776},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/machinery/project_structure.png","alt":"machinery project structure","position":{"start":{"line":27,"column":1,"offset":1778},"end":{"line":27,"column":84,"offset":1861},"indent":[]}}],"position":{"start":{"line":27,"column":1,"offset":1778},"end":{"line":27,"column":84,"offset":1861},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"These different steps can be configured by editing a couple of configurationn files located at ","position":{"start":{"line":29,"column":1,"offset":1863},"end":{"line":29,"column":96,"offset":1958},"indent":[]}},{"type":"inlineCode","value":"config/","position":{"start":{"line":29,"column":96,"offset":1958},"end":{"line":29,"column":105,"offset":1967},"indent":[]}},{"type":"text","value":". The main configuration file ","position":{"start":{"line":29,"column":105,"offset":1967},"end":{"line":29,"column":135,"offset":1997},"indent":[]}},{"type":"inlineCode","value":"config/config.xml","position":{"start":{"line":29,"column":135,"offset":1997},"end":{"line":29,"column":154,"offset":2016},"indent":[]}},{"type":"text","value":" looks like this:","position":{"start":{"line":29,"column":154,"offset":2016},"end":{"line":29,"column":171,"offset":2033},"indent":[]}}],"position":{"start":{"line":29,"column":1,"offset":1863},"end":{"line":29,"column":171,"offset":2033},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n frontdoor\n false\n Europe-Brussels\n RaspiCamera\n Mjpg\n Enabled\n DifferentialCollins\n Hull\n Sequence\n Video\n S3\n \n","position":{"start":{"line":31,"column":1,"offset":2035},"end":{"line":48,"column":4,"offset":2690},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Capture","position":{"start":{"line":50,"column":4,"offset":2695},"end":{"line":50,"column":11,"offset":2702},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":2692},"end":{"line":50,"column":11,"offset":2702},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can choose which capture device you will be using, you can use your old USB webcam, the popular Raspberry Pi camera or a state-of-the-art IP camera. The capture device will take pictures and deliver them to the algorithm if the conditions (the first step of the four passway) are valid.","position":{"start":{"line":52,"column":1,"offset":2704},"end":{"line":52,"column":291,"offset":2994},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":2704},"end":{"line":52,"column":291,"offset":2994},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can change the capture device by changing the ","position":{"start":{"line":54,"column":1,"offset":2996},"end":{"line":54,"column":51,"offset":3046},"indent":[]}},{"type":"inlineCode","value":"config/config.xml","position":{"start":{"line":54,"column":51,"offset":3046},"end":{"line":54,"column":70,"offset":3065},"indent":[]}},{"type":"text","value":" file, and choose one of the following:","position":{"start":{"line":54,"column":70,"offset":3065},"end":{"line":54,"column":109,"offset":3104},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":2996},"end":{"line":54,"column":109,"offset":3104},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"USBCamera","position":{"start":{"line":55,"column":3,"offset":3107},"end":{"line":55,"column":12,"offset":3116},"indent":[]}}],"position":{"start":{"line":55,"column":3,"offset":3107},"end":{"line":55,"column":12,"offset":3116},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":3105},"end":{"line":55,"column":12,"offset":3116},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"RaspiCamera","position":{"start":{"line":56,"column":3,"offset":3119},"end":{"line":56,"column":14,"offset":3130},"indent":[]}}],"position":{"start":{"line":56,"column":3,"offset":3119},"end":{"line":56,"column":14,"offset":3130},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3117},"end":{"line":56,"column":14,"offset":3130},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"IPCamera","position":{"start":{"line":57,"column":3,"offset":3133},"end":{"line":57,"column":11,"offset":3141},"indent":[]}}],"position":{"start":{"line":57,"column":3,"offset":3133},"end":{"line":57,"column":11,"offset":3141},"indent":[]}}],"position":{"start":{"line":57,"column":1,"offset":3131},"end":{"line":57,"column":11,"offset":3141},"indent":[]}}],"position":{"start":{"line":55,"column":1,"offset":3105},"end":{"line":57,"column":11,"offset":3141},"indent":[1,1]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n ...\n RaspiCamera\n ...\n \n","position":{"start":{"line":59,"column":1,"offset":3143},"end":{"line":68,"column":4,"offset":3295},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"USB camera","position":{"start":{"line":70,"column":5,"offset":3301},"end":{"line":70,"column":15,"offset":3311},"indent":[]}}],"position":{"start":{"line":70,"column":1,"offset":3297},"end":{"line":70,"column":15,"offset":3311},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The machinery supports a whole range of USB cameras. You will find a complete list here. Make sure you have updated the web interface, to make the machinery aware you will be using an USB camera.","position":{"start":{"line":72,"column":1,"offset":3313},"end":{"line":72,"column":196,"offset":3508},"indent":[]}}],"position":{"start":{"line":72,"column":1,"offset":3313},"end":{"line":72,"column":196,"offset":3508},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":74,"column":6,"offset":3515},"end":{"line":74,"column":16,"offset":3525},"indent":[]}}],"position":{"start":{"line":74,"column":1,"offset":3510},"end":{"line":74,"column":16,"offset":3525},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the USB camera can be found in the ","position":{"start":{"line":76,"column":1,"offset":3527},"end":{"line":76,"column":54,"offset":3580},"indent":[]}},{"type":"inlineCode","value":"config/capture.xml","position":{"start":{"line":76,"column":54,"offset":3580},"end":{"line":76,"column":74,"offset":3600},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":76,"column":74,"offset":3600},"end":{"line":76,"column":179,"offset":3705},"indent":[]}}],"position":{"start":{"line":76,"column":1,"offset":3527},"end":{"line":76,"column":179,"offset":3705},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n 1280\n 720\n 0\n 0\n 0\n \n","position":{"start":{"line":78,"column":1,"offset":3707},"end":{"line":88,"column":4,"offset":3985},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Framewidth and -height","position":{"start":{"line":90,"column":7,"offset":3993},"end":{"line":90,"column":29,"offset":4015},"indent":[]}}],"position":{"start":{"line":90,"column":1,"offset":3987},"end":{"line":90,"column":29,"offset":4015},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can set the resolution of the capture device, make sure the resolution you've defined is valid with your camera. Please check the specs of the USB camera you're using.","position":{"start":{"line":92,"column":1,"offset":4017},"end":{"line":92,"column":172,"offset":4188},"indent":[]}}],"position":{"start":{"line":92,"column":1,"offset":4017},"end":{"line":92,"column":172,"offset":4188},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Device number","position":{"start":{"line":94,"column":7,"offset":4196},"end":{"line":94,"column":20,"offset":4209},"indent":[]}}],"position":{"start":{"line":94,"column":1,"offset":4190},"end":{"line":94,"column":20,"offset":4209},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If more than one device is connected, you can specify the index of the USB-camera. The index is an integer (1-5).","position":{"start":{"line":96,"column":1,"offset":4211},"end":{"line":96,"column":114,"offset":4324},"indent":[]}}],"position":{"start":{"line":96,"column":1,"offset":4211},"end":{"line":96,"column":114,"offset":4324},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Delay","position":{"start":{"line":98,"column":7,"offset":4332},"end":{"line":98,"column":12,"offset":4337},"indent":[]}}],"position":{"start":{"line":98,"column":1,"offset":4326},"end":{"line":98,"column":12,"offset":4337},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can provide a delay/interval (milliseconds) between two captures.","position":{"start":{"line":100,"column":1,"offset":4339},"end":{"line":100,"column":70,"offset":4408},"indent":[]}}],"position":{"start":{"line":100,"column":1,"offset":4339},"end":{"line":100,"column":70,"offset":4408},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Angle","position":{"start":{"line":102,"column":7,"offset":4416},"end":{"line":102,"column":12,"offset":4421},"indent":[]}}],"position":{"start":{"line":102,"column":1,"offset":4410},"end":{"line":102,"column":12,"offset":4421},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By defining an angle (degrees), you can rotate the images taken by the capture device. For example if you would mount the camera upside down, than you could enter the value 180 as the angle; this will flip the images.","position":{"start":{"line":104,"column":1,"offset":4423},"end":{"line":104,"column":218,"offset":4640},"indent":[]}}],"position":{"start":{"line":104,"column":1,"offset":4423},"end":{"line":104,"column":218,"offset":4640},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Raspberry Pi Camera Module","position":{"start":{"line":106,"column":5,"offset":4646},"end":{"line":106,"column":31,"offset":4672},"indent":[]}}],"position":{"start":{"line":106,"column":1,"offset":4642},"end":{"line":106,"column":31,"offset":4672},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can use the Raspberry Pi Camera Module with the machinery. You just need to attach the camera module and you're ready to go. The Raspberry Pi Camera Module is enabled by default in the web.","position":{"start":{"line":108,"column":1,"offset":4674},"end":{"line":108,"column":194,"offset":4867},"indent":[]}}],"position":{"start":{"line":108,"column":1,"offset":4674},"end":{"line":108,"column":194,"offset":4867},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":110,"column":6,"offset":4874},"end":{"line":110,"column":16,"offset":4884},"indent":[]}}],"position":{"start":{"line":110,"column":1,"offset":4869},"end":{"line":110,"column":16,"offset":4884},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Raspberry Pi Camera Module can be found in the config/capture.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":112,"column":1,"offset":4886},"end":{"line":112,"column":193,"offset":5078},"indent":[]}}],"position":{"start":{"line":112,"column":1,"offset":4886},"end":{"line":112,"column":193,"offset":5078},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n 640\n 480\n 1400\n 0\n 30\n 0\n 0\n 0\n 50\n \n","position":{"start":{"line":114,"column":1,"offset":5080},"end":{"line":128,"column":4,"offset":5534},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Framewidth and -height","position":{"start":{"line":130,"column":7,"offset":5542},"end":{"line":130,"column":29,"offset":5564},"indent":[]}}],"position":{"start":{"line":130,"column":1,"offset":5536},"end":{"line":130,"column":29,"offset":5564},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can set the resolution of the camera module, make sure the resolution you've defined is valid.","position":{"start":{"line":132,"column":1,"offset":5566},"end":{"line":132,"column":99,"offset":5664},"indent":[]}}],"position":{"start":{"line":132,"column":1,"offset":5566},"end":{"line":132,"column":99,"offset":5664},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Delay","position":{"start":{"line":134,"column":7,"offset":5672},"end":{"line":134,"column":12,"offset":5677},"indent":[]}}],"position":{"start":{"line":134,"column":1,"offset":5666},"end":{"line":134,"column":12,"offset":5677},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can provide a delay/interval (milliseconds) between two captures.","position":{"start":{"line":136,"column":1,"offset":5679},"end":{"line":136,"column":70,"offset":5748},"indent":[]}}],"position":{"start":{"line":136,"column":1,"offset":5679},"end":{"line":136,"column":70,"offset":5748},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Angle","position":{"start":{"line":138,"column":7,"offset":5756},"end":{"line":138,"column":12,"offset":5761},"indent":[]}}],"position":{"start":{"line":138,"column":1,"offset":5750},"end":{"line":138,"column":12,"offset":5761},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By defining an angle (degrees), you can rotate the images taken by the capture device. For example if you would mount the camera upside down, than you could enter the value 180 as the angle; this will flip the images.","position":{"start":{"line":140,"column":1,"offset":5763},"end":{"line":140,"column":218,"offset":5980},"indent":[]}}],"position":{"start":{"line":140,"column":1,"offset":5763},"end":{"line":140,"column":218,"offset":5980},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Framerate","position":{"start":{"line":142,"column":7,"offset":5988},"end":{"line":142,"column":16,"offset":5997},"indent":[]}}],"position":{"start":{"line":142,"column":1,"offset":5982},"end":{"line":142,"column":16,"offset":5997},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The number of frames captures per second. Please note that this parameter will also be used if you're recording video. E.g. if you set this parameter to 20, you're recorded videos will also be 20 FPS.","position":{"start":{"line":144,"column":1,"offset":5999},"end":{"line":144,"column":201,"offset":6199},"indent":[]}}],"position":{"start":{"line":144,"column":1,"offset":5999},"end":{"line":144,"column":201,"offset":6199},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Sharpness, saturation, contrast, brightness","position":{"start":{"line":146,"column":7,"offset":6207},"end":{"line":146,"column":50,"offset":6250},"indent":[]}}],"position":{"start":{"line":146,"column":1,"offset":6201},"end":{"line":146,"column":50,"offset":6250},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Camera properties which you can specify to tune the settings to your needs.","position":{"start":{"line":148,"column":1,"offset":6252},"end":{"line":148,"column":76,"offset":6327},"indent":[]}}],"position":{"start":{"line":148,"column":1,"offset":6252},"end":{"line":148,"column":76,"offset":6327},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"IP camera","position":{"start":{"line":150,"column":5,"offset":6333},"end":{"line":150,"column":14,"offset":6342},"indent":[]}}],"position":{"start":{"line":150,"column":1,"offset":6329},"end":{"line":150,"column":14,"offset":6342},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The machinery can be used with any IP camera, that provides a RTSP (or MJPEG) stream. Make sure that you know the correct URL of your IP camera, you can ","position":{"start":{"line":152,"column":1,"offset":6344},"end":{"line":152,"column":154,"offset":6497},"indent":[]}},{"type":"link","title":null,"url":"http://www.ispyconnect.com/sources.aspx","children":[{"type":"text","value":"find a list here","position":{"start":{"line":152,"column":155,"offset":6498},"end":{"line":152,"column":171,"offset":6514},"indent":[]}}],"position":{"start":{"line":152,"column":154,"offset":6497},"end":{"line":152,"column":213,"offset":6556},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":152,"column":213,"offset":6556},"end":{"line":152,"column":214,"offset":6557},"indent":[]}}],"position":{"start":{"line":152,"column":1,"offset":6344},"end":{"line":152,"column":214,"offset":6557},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":154,"column":6,"offset":6564},"end":{"line":154,"column":16,"offset":6574},"indent":[]}}],"position":{"start":{"line":154,"column":1,"offset":6559},"end":{"line":154,"column":16,"offset":6574},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the IP capture device can be found in the ","position":{"start":{"line":156,"column":1,"offset":6576},"end":{"line":156,"column":61,"offset":6636},"indent":[]}},{"type":"inlineCode","value":"config/capture.xml","position":{"start":{"line":156,"column":61,"offset":6636},"end":{"line":156,"column":81,"offset":6656},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":156,"column":81,"offset":6656},"end":{"line":156,"column":186,"offset":6761},"indent":[]}}],"position":{"start":{"line":156,"column":1,"offset":6576},"end":{"line":156,"column":186,"offset":6761},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n http://username:password@ipaddress/image.jpg\n 800\n 640\n 0\n 0\n \n","position":{"start":{"line":158,"column":1,"offset":6763},"end":{"line":168,"column":4,"offset":7061},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"URL","position":{"start":{"line":170,"column":7,"offset":7069},"end":{"line":170,"column":10,"offset":7072},"indent":[]}}],"position":{"start":{"line":170,"column":1,"offset":7063},"end":{"line":170,"column":10,"offset":7072},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To use your IP camera, you should provide a valid RTSP (or MJPEG) URL. The machinery will take snapshots from this stream.","position":{"start":{"line":172,"column":1,"offset":7074},"end":{"line":172,"column":123,"offset":7196},"indent":[]}}],"position":{"start":{"line":172,"column":1,"offset":7074},"end":{"line":172,"column":123,"offset":7196},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Framewidth and -height","position":{"start":{"line":174,"column":7,"offset":7204},"end":{"line":174,"column":29,"offset":7226},"indent":[]}}],"position":{"start":{"line":174,"column":1,"offset":7198},"end":{"line":174,"column":29,"offset":7226},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can set the resolution of the capture device, make sure the resolution you've defined is equal to the resolution you've defined in your IP-camera software.","position":{"start":{"line":176,"column":1,"offset":7228},"end":{"line":176,"column":160,"offset":7387},"indent":[]}}],"position":{"start":{"line":176,"column":1,"offset":7228},"end":{"line":176,"column":160,"offset":7387},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Delay","position":{"start":{"line":178,"column":7,"offset":7395},"end":{"line":178,"column":12,"offset":7400},"indent":[]}}],"position":{"start":{"line":178,"column":1,"offset":7389},"end":{"line":178,"column":12,"offset":7400},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can provide a delay/interval (milliseconds) between two captures.","position":{"start":{"line":180,"column":1,"offset":7402},"end":{"line":180,"column":70,"offset":7471},"indent":[]}}],"position":{"start":{"line":180,"column":1,"offset":7402},"end":{"line":180,"column":70,"offset":7471},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Angle","position":{"start":{"line":182,"column":7,"offset":7479},"end":{"line":182,"column":12,"offset":7484},"indent":[]}}],"position":{"start":{"line":182,"column":1,"offset":7473},"end":{"line":182,"column":12,"offset":7484},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By defining an angle (degrees), you can rotate the images taken by the capture device. For example if you would mount the camera upside down, than you could enter the value 180 as the angle; this will flip the images.","position":{"start":{"line":184,"column":1,"offset":7486},"end":{"line":184,"column":218,"offset":7703},"indent":[]}}],"position":{"start":{"line":184,"column":1,"offset":7486},"end":{"line":184,"column":218,"offset":7703},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Condition","position":{"start":{"line":186,"column":4,"offset":7708},"end":{"line":186,"column":13,"offset":7717},"indent":[]}}],"position":{"start":{"line":186,"column":1,"offset":7705},"end":{"line":186,"column":13,"offset":7717},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The condition is the first step of the four passway. In this step the machinery will determine if it's allowed to proceed to the next step. For example a condition can be a time constraint, a brightness threshold, etc; multiple conditions can be selected.","position":{"start":{"line":188,"column":1,"offset":7719},"end":{"line":188,"column":256,"offset":7974},"indent":[]}}],"position":{"start":{"line":188,"column":1,"offset":7719},"end":{"line":188,"column":256,"offset":7974},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n ...\n Enabled\n ...\n \n","position":{"start":{"line":190,"column":1,"offset":7976},"end":{"line":199,"column":4,"offset":8146},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Enabled","position":{"start":{"line":201,"column":5,"offset":8152},"end":{"line":201,"column":12,"offset":8159},"indent":[]}}],"position":{"start":{"line":201,"column":1,"offset":8148},"end":{"line":201,"column":12,"offset":8159},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"It can be helpful to enable or disable the machinery at specific times. Therefore the time condition makes it possible to select a time range for each day of the week. When the current time is within the time range, the machinery will be enabled.","position":{"start":{"line":203,"column":1,"offset":8161},"end":{"line":203,"column":247,"offset":8407},"indent":[]}}],"position":{"start":{"line":203,"column":1,"offset":8161},"end":{"line":203,"column":247,"offset":8407},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":205,"column":6,"offset":8414},"end":{"line":205,"column":16,"offset":8424},"indent":[]}}],"position":{"start":{"line":205,"column":1,"offset":8409},"end":{"line":205,"column":16,"offset":8424},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Enabled condition can be found in the ","position":{"start":{"line":207,"column":1,"offset":8426},"end":{"line":207,"column":61,"offset":8486},"indent":[]}},{"type":"inlineCode","value":"config/condition.xml","position":{"start":{"line":207,"column":61,"offset":8486},"end":{"line":207,"column":83,"offset":8508},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":207,"column":83,"offset":8508},"end":{"line":207,"column":188,"offset":8613},"indent":[]}}],"position":{"start":{"line":207,"column":1,"offset":8426},"end":{"line":207,"column":188,"offset":8613},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n true\n 5000\n \n","position":{"start":{"line":209,"column":1,"offset":8615},"end":{"line":216,"column":4,"offset":8753},"indent":[1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Active","position":{"start":{"line":218,"column":7,"offset":8761},"end":{"line":218,"column":13,"offset":8767},"indent":[]}}],"position":{"start":{"line":218,"column":1,"offset":8755},"end":{"line":218,"column":13,"offset":8767},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The active field is boolean value (true/false). When the active field is true, the machinery is enabled, if not it's disabled.","position":{"start":{"line":220,"column":1,"offset":8769},"end":{"line":220,"column":127,"offset":8895},"indent":[]}}],"position":{"start":{"line":220,"column":1,"offset":8769},"end":{"line":220,"column":127,"offset":8895},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Delay","position":{"start":{"line":222,"column":7,"offset":8903},"end":{"line":222,"column":12,"offset":8908},"indent":[]}}],"position":{"start":{"line":222,"column":1,"offset":8897},"end":{"line":222,"column":12,"offset":8908},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The delay value is used when the condition failed, so when the current time isn't in the selected time range for that day. In that case the machinery will idle for the specified delay time. The value of the delay is expressed in miliseconds.","position":{"start":{"line":224,"column":1,"offset":8910},"end":{"line":224,"column":242,"offset":9151},"indent":[]}}],"position":{"start":{"line":224,"column":1,"offset":8910},"end":{"line":224,"column":242,"offset":9151},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Time","position":{"start":{"line":226,"column":5,"offset":9157},"end":{"line":226,"column":9,"offset":9161},"indent":[]}}],"position":{"start":{"line":226,"column":1,"offset":9153},"end":{"line":226,"column":9,"offset":9161},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"It can be helpful to enable or disable the machinery at specific times. Therefore the time condition makes it possible to select a time range for each day of the week. When the current time is within the time range, the machinery will be enabled.","position":{"start":{"line":228,"column":1,"offset":9163},"end":{"line":228,"column":247,"offset":9409},"indent":[]}}],"position":{"start":{"line":228,"column":1,"offset":9163},"end":{"line":228,"column":247,"offset":9409},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":230,"column":6,"offset":9416},"end":{"line":230,"column":16,"offset":9426},"indent":[]}}],"position":{"start":{"line":230,"column":1,"offset":9411},"end":{"line":230,"column":16,"offset":9426},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Time condition can be found in the ","position":{"start":{"line":232,"column":1,"offset":9428},"end":{"line":232,"column":58,"offset":9485},"indent":[]}},{"type":"inlineCode","value":"config/condition.xml","position":{"start":{"line":232,"column":58,"offset":9485},"end":{"line":232,"column":80,"offset":9507},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":232,"column":80,"offset":9507},"end":{"line":232,"column":185,"offset":9612},"indent":[]}}],"position":{"start":{"line":232,"column":1,"offset":9428},"end":{"line":232,"column":185,"offset":9612},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n","position":{"start":{"line":234,"column":1,"offset":9614},"end":{"line":241,"column":4,"offset":9813},"indent":[1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Times","position":{"start":{"line":243,"column":7,"offset":9821},"end":{"line":243,"column":12,"offset":9826},"indent":[]}}],"position":{"start":{"line":243,"column":1,"offset":9815},"end":{"line":243,"column":12,"offset":9826},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The times property contains a list of times, delimited by a \"-\". The first item in the list will specify the time range for the first day of the week (Monday), the last item for the last day of the week (Sunday). The begin- and end-time, for a specific day, are delimited by a \",\" where the first element will specify that start time and the second one specifies the end time.","position":{"start":{"line":245,"column":1,"offset":9828},"end":{"line":245,"column":377,"offset":10204},"indent":[]}}],"position":{"start":{"line":245,"column":1,"offset":9828},"end":{"line":245,"column":377,"offset":10204},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Delay","position":{"start":{"line":247,"column":7,"offset":10212},"end":{"line":247,"column":12,"offset":10217},"indent":[]}}],"position":{"start":{"line":247,"column":1,"offset":10206},"end":{"line":247,"column":12,"offset":10217},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The delay value is used when the condition failed, so when the current time isn't in the selected time range for that day. In that case the machinery will idle for the specified delay time. The value of the delay is expressed in miliseconds.","position":{"start":{"line":249,"column":1,"offset":10219},"end":{"line":249,"column":242,"offset":10460},"indent":[]}}],"position":{"start":{"line":249,"column":1,"offset":10219},"end":{"line":249,"column":242,"offset":10460},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Algorithm","position":{"start":{"line":251,"column":4,"offset":10465},"end":{"line":251,"column":13,"offset":10474},"indent":[]}}],"position":{"start":{"line":251,"column":1,"offset":10462},"end":{"line":251,"column":13,"offset":10474},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The algorithm is the second step of the four passway. An algorithm will execute some kind of function on a sequence of images, and end up with a black and white image; just like the image below. An example of an algorithm would be one that does motion detection or one that would detect cats or dogs (using TensorFlow, ar any other Deep Learning framework).","position":{"start":{"line":253,"column":1,"offset":10476},"end":{"line":253,"column":358,"offset":10833},"indent":[]}}],"position":{"start":{"line":253,"column":1,"offset":10476},"end":{"line":253,"column":358,"offset":10833},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/machinery/algorithm.png","alt":"machinery algorithm","position":{"start":{"line":255,"column":1,"offset":10835},"end":{"line":255,"column":68,"offset":10902},"indent":[]}}],"position":{"start":{"line":255,"column":1,"offset":10835},"end":{"line":255,"column":68,"offset":10902},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The white pixels on the image will indicate the object of interest. For example, when looking for motion, the pixels that have been changed; it depends on what the algorithm is looking for. The black pixels are background pixels.","position":{"start":{"line":257,"column":1,"offset":10904},"end":{"line":257,"column":230,"offset":11133},"indent":[]}}],"position":{"start":{"line":257,"column":1,"offset":10904},"end":{"line":257,"column":230,"offset":11133},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The only convention that an algorithm should meet is that it should return a black and white image to the next step; the expositor. And of course that it requires a sequence of images as a parameter. Besides those conventions, an algorithm can do everything it wants to do. So you could create your own cat detection algorithm, marker detection, etc.","position":{"start":{"line":259,"column":1,"offset":11135},"end":{"line":259,"column":351,"offset":11485},"indent":[]}}],"position":{"start":{"line":259,"column":1,"offset":11135},"end":{"line":259,"column":351,"offset":11485},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can select the algortihm in the ","position":{"start":{"line":261,"column":1,"offset":11487},"end":{"line":261,"column":37,"offset":11523},"indent":[]}},{"type":"inlineCode","value":"config/config.xml","position":{"start":{"line":261,"column":37,"offset":11523},"end":{"line":261,"column":56,"offset":11542},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":261,"column":56,"offset":11542},"end":{"line":261,"column":57,"offset":11543},"indent":[]}}],"position":{"start":{"line":261,"column":1,"offset":11487},"end":{"line":261,"column":57,"offset":11543},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n ...\n DifferentialCollins\n ...\n \n","position":{"start":{"line":263,"column":1,"offset":11545},"end":{"line":272,"column":4,"offset":11711},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Differential images","position":{"start":{"line":274,"column":5,"offset":11717},"end":{"line":274,"column":24,"offset":11736},"indent":[]}}],"position":{"start":{"line":274,"column":1,"offset":11713},"end":{"line":274,"column":24,"offset":11736},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This algorithm is a very simple method to detect motion; in terms of understanding but also processing. Just like the name says, it's the result of comparing images. When the images are compared, we know the pixels that have been changed and if the amount of pixels that changed is big enough, one can say that something happened and thus motion was detected.","position":{"start":{"line":276,"column":1,"offset":11738},"end":{"line":276,"column":360,"offset":12097},"indent":[]}}],"position":{"start":{"line":276,"column":1,"offset":11738},"end":{"line":276,"column":360,"offset":12097},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To get a more technical explanation: the algoritm will substract 2 or more images, and once that is done it will end up with a black and white image. The white pixels will mark the pixels that where different/changed and the black pixels are the pixels that have not changed; background pixels. Please note that there are several different combinations of substracting images. However for the machinery, we will use the method of Collins et al. as this method erases the phenomenon \"ghosting\".","position":{"start":{"line":278,"column":1,"offset":12099},"end":{"line":278,"column":494,"offset":12592},"indent":[]}}],"position":{"start":{"line":278,"column":1,"offset":12099},"end":{"line":278,"column":494,"offset":12592},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/machinery/differential_images.png","alt":"machinery differential","position":{"start":{"line":280,"column":1,"offset":12594},"end":{"line":280,"column":81,"offset":12674},"indent":[]}}],"position":{"start":{"line":280,"column":1,"offset":12594},"end":{"line":280,"column":81,"offset":12674},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In the image above the method of Collins et al. is illustrated. For this method we will process three images. The images are a sequence (from left to right), so the first (A) image was taken before the second (B) one, and the second (B) before the third (C) one. Next we will do a first comparision (C-B) of the third (C) image and the second (B) image, and after that we will do a second comparison (C-A) of the third (C) image and first (A) image.","position":{"start":{"line":282,"column":1,"offset":12676},"end":{"line":282,"column":450,"offset":13125},"indent":[]}}],"position":{"start":{"line":282,"column":1,"offset":12676},"end":{"line":282,"column":450,"offset":13125},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After the comparison we will end up with two difference images (C-B) and (C-A); both will mark the white pixels as changed pixels and black as non-changed pixels. To finish the algorithm we will do a logical AND-operation of the two difference images; this will give us the final black and white image ((C-B)&&(C-A)).","position":{"start":{"line":284,"column":1,"offset":13127},"end":{"line":284,"column":318,"offset":13444},"indent":[]}}],"position":{"start":{"line":284,"column":1,"offset":13127},"end":{"line":284,"column":318,"offset":13444},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The main idea of the Colins et al. method, is that it will erase \"ghosting\". In the last step we are doing a logical AND-operation, by doing this we will only keep the pixels, that changed in the first two images; therefore we can elimante false positives.","position":{"start":{"line":286,"column":1,"offset":13446},"end":{"line":286,"column":257,"offset":13702},"indent":[]}}],"position":{"start":{"line":286,"column":1,"offset":13446},"end":{"line":286,"column":257,"offset":13702},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":288,"column":6,"offset":13709},"end":{"line":288,"column":16,"offset":13719},"indent":[]}}],"position":{"start":{"line":288,"column":1,"offset":13704},"end":{"line":288,"column":16,"offset":13719},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Differential images algorithm can be found in the config/algorithm.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":290,"column":1,"offset":13721},"end":{"line":290,"column":198,"offset":13918},"indent":[]}}],"position":{"start":{"line":290,"column":1,"offset":13721},"end":{"line":290,"column":198,"offset":13918},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n 5\n 20\n \n","position":{"start":{"line":292,"column":1,"offset":13920},"end":{"line":299,"column":4,"offset":14085},"indent":[1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Erode","position":{"start":{"line":301,"column":7,"offset":14093},"end":{"line":301,"column":12,"offset":14098},"indent":[]}}],"position":{"start":{"line":301,"column":1,"offset":14087},"end":{"line":301,"column":12,"offset":14098},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The erode parameter represents a structural element (a morphological operation), which will be used to minimize the changed pixels; more information about eroding can be found here. The idea of the eroding is that pixels which are isolated will be removed; this means that when only one pixel changed, that pixel will reverted to the non-changed state. But for example when a large change happens and a lot of adjacent pixels are changed, the eroding will not be able to revert them.","position":{"start":{"line":303,"column":1,"offset":14100},"end":{"line":303,"column":484,"offset":14583},"indent":[]}}],"position":{"start":{"line":303,"column":1,"offset":14100},"end":{"line":303,"column":484,"offset":14583},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The higher the number of the erode parameter, the more aggressive the eroding will be. So high erode values, will make it possible that also large changes will be reverted to the non-changed state.","position":{"start":{"line":305,"column":1,"offset":14585},"end":{"line":305,"column":198,"offset":14782},"indent":[]}}],"position":{"start":{"line":305,"column":1,"offset":14585},"end":{"line":305,"column":198,"offset":14782},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Threshold","position":{"start":{"line":307,"column":7,"offset":14790},"end":{"line":307,"column":16,"offset":14799},"indent":[]}}],"position":{"start":{"line":307,"column":1,"offset":14784},"end":{"line":307,"column":16,"offset":14799},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When doing the comparison of two images, we won't end up with a clean black and white image. In most of the cases the values will be between 0 and 255; so gray values. This means that the value 0 will mean that both pixels where the same in both image, and values 255 mean that both pixels where totally different in both images. Of course we will also have values between 0-255, so pixels that are a little bit different in both images. So to make the resulting black and white image, we will need to apply a threshold value.","position":{"start":{"line":309,"column":1,"offset":14801},"end":{"line":309,"column":527,"offset":15327},"indent":[]}}],"position":{"start":{"line":309,"column":1,"offset":14801},"end":{"line":309,"column":527,"offset":15327},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The threshold will specify how much a pixel has to be different in the two images. So for example when the threshold is 30, it means that the difference between two pixels has to be equal or more then 30. The higher the threshold the more the pixel needs to be different, to be marked as changed.","position":{"start":{"line":311,"column":1,"offset":15329},"end":{"line":311,"column":297,"offset":15625},"indent":[]}}],"position":{"start":{"line":311,"column":1,"offset":15329},"end":{"line":311,"column":297,"offset":15625},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Expositor","position":{"start":{"line":313,"column":4,"offset":15630},"end":{"line":313,"column":13,"offset":15639},"indent":[]}}],"position":{"start":{"line":313,"column":1,"offset":15627},"end":{"line":313,"column":13,"offset":15639},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After the algorithm is executed, the expositor will determine, a region, where the changes were detected. An expositor can constrain a region in terms of selecting a hull or defining a rectangle.","position":{"start":{"line":315,"column":1,"offset":15641},"end":{"line":315,"column":196,"offset":15836},"indent":[]}}],"position":{"start":{"line":315,"column":1,"offset":15641},"end":{"line":315,"column":196,"offset":15836},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"An expositor receives a black and white image as parameter and should modify a JSON object with all the information it processed. The JSON object must include: the bounding rectangle(s) of the positions where the pixels of interest are located and the number of pixels of interest. But can also include other optional parameters.","position":{"start":{"line":317,"column":1,"offset":15838},"end":{"line":317,"column":330,"offset":16167},"indent":[]}}],"position":{"start":{"line":317,"column":1,"offset":15838},"end":{"line":317,"column":330,"offset":16167},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can change the expositor by changing the ","position":{"start":{"line":319,"column":1,"offset":16169},"end":{"line":319,"column":46,"offset":16214},"indent":[]}},{"type":"inlineCode","value":"config/config.xml","position":{"start":{"line":319,"column":46,"offset":16214},"end":{"line":319,"column":65,"offset":16233},"indent":[]}},{"type":"text","value":" file, and choose one of the following:","position":{"start":{"line":319,"column":65,"offset":16233},"end":{"line":319,"column":104,"offset":16272},"indent":[]}}],"position":{"start":{"line":319,"column":1,"offset":16169},"end":{"line":319,"column":104,"offset":16272},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Hull","position":{"start":{"line":320,"column":3,"offset":16275},"end":{"line":320,"column":7,"offset":16279},"indent":[]}}],"position":{"start":{"line":320,"column":3,"offset":16275},"end":{"line":320,"column":7,"offset":16279},"indent":[]}}],"position":{"start":{"line":320,"column":1,"offset":16273},"end":{"line":320,"column":7,"offset":16279},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Rectangle","position":{"start":{"line":321,"column":3,"offset":16282},"end":{"line":321,"column":12,"offset":16291},"indent":[]}}],"position":{"start":{"line":321,"column":3,"offset":16282},"end":{"line":321,"column":12,"offset":16291},"indent":[]}}],"position":{"start":{"line":321,"column":1,"offset":16280},"end":{"line":321,"column":12,"offset":16291},"indent":[]}}],"position":{"start":{"line":320,"column":1,"offset":16273},"end":{"line":321,"column":12,"offset":16291},"indent":[1]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n ...\n Hull\n ...\n \n","position":{"start":{"line":323,"column":1,"offset":16293},"end":{"line":332,"column":4,"offset":16444},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Rectangle","position":{"start":{"line":334,"column":5,"offset":16450},"end":{"line":334,"column":14,"offset":16459},"indent":[]}}],"position":{"start":{"line":334,"column":1,"offset":16446},"end":{"line":334,"column":14,"offset":16459},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This is a trivial expositor. A rectangle region can be defined to constrain the locations of pixels of interest. The rectangle repositor will return the region of the pixels of interest.","position":{"start":{"line":336,"column":1,"offset":16461},"end":{"line":336,"column":187,"offset":16647},"indent":[]}}],"position":{"start":{"line":336,"column":1,"offset":16461},"end":{"line":336,"column":187,"offset":16647},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":338,"column":6,"offset":16654},"end":{"line":338,"column":16,"offset":16664},"indent":[]}}],"position":{"start":{"line":338,"column":1,"offset":16649},"end":{"line":338,"column":16,"offset":16664},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the rectangle expositor can be found in the config/expositor.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":340,"column":1,"offset":16666},"end":{"line":340,"column":188,"offset":16853},"indent":[]}}],"position":{"start":{"line":340,"column":1,"offset":16666},"end":{"line":340,"column":188,"offset":16853},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n \n 0\n 0\n 1280\n 720\n \n \n","position":{"start":{"line":342,"column":1,"offset":16855},"end":{"line":353,"column":4,"offset":17077},"indent":[1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Region","position":{"start":{"line":355,"column":7,"offset":17085},"end":{"line":355,"column":13,"offset":17091},"indent":[]}}],"position":{"start":{"line":355,"column":1,"offset":17079},"end":{"line":355,"column":13,"offset":17091},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The region parameter contains 4 values; x1, y1, x2 and y2 respectively. The values x1 and y1 indicate the x- and y-coordinate of the left upper starting point. The values x2 and y2 are the bottom right coordinates. A virtual rectangle will be drawn from (x1,y1) to (x2,y2). Pixels of interest that lie within this rectangle are valid pixels; if not they are invalid.","position":{"start":{"line":357,"column":1,"offset":17093},"end":{"line":357,"column":367,"offset":17459},"indent":[]}}],"position":{"start":{"line":357,"column":1,"offset":17093},"end":{"line":357,"column":367,"offset":17459},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Hull","position":{"start":{"line":359,"column":5,"offset":17465},"end":{"line":359,"column":9,"offset":17469},"indent":[]}}],"position":{"start":{"line":359,"column":1,"offset":17461},"end":{"line":359,"column":9,"offset":17469},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This hull is a more complex expositor than the rectangle. A hull can be selected with the web, you can select one or more coordinates to create a flexible region. The coordinates can be adjusted afterwards and be removed by double clicking on the coordinate. You can expand the hull by removing the start coordinate, which is marked by the white bullet.","position":{"start":{"line":361,"column":1,"offset":17471},"end":{"line":361,"column":354,"offset":17824},"indent":[]}}],"position":{"start":{"line":361,"column":1,"offset":17471},"end":{"line":361,"column":354,"offset":17824},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/machinery/hull.png","alt":"machinery hull","position":{"start":{"line":363,"column":1,"offset":17826},"end":{"line":363,"column":58,"offset":17883},"indent":[]}}],"position":{"start":{"line":363,"column":1,"offset":17826},"end":{"line":363,"column":58,"offset":17883},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":365,"column":6,"offset":17890},"end":{"line":365,"column":16,"offset":17900},"indent":[]}}],"position":{"start":{"line":365,"column":1,"offset":17885},"end":{"line":365,"column":16,"offset":17900},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the hull expositor can be found in the config/expositor.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":367,"column":1,"offset":17902},"end":{"line":367,"column":183,"offset":18084},"indent":[]}}],"position":{"start":{"line":367,"column":1,"offset":17902},"end":{"line":367,"column":183,"offset":18084},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n 347,361|627,266|975,328|1091,328|1148,413|1158,516|1121,534|962,567|699,648|531,700|243,613|423,550|665,453|850,470|666,361|467,385|325,460|165,372\n \n","position":{"start":{"line":369,"column":1,"offset":18086},"end":{"line":375,"column":4,"offset":18332},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Region","position":{"start":{"line":377,"column":7,"offset":18340},"end":{"line":377,"column":13,"offset":18346},"indent":[]}}],"position":{"start":{"line":377,"column":1,"offset":18334},"end":{"line":377,"column":13,"offset":18346},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The region parameter contains n values. Each value represents a coordinate (x,y) and are seperated by the \"|\" delimiter. These coordinates are used to calculate the concave hull. Pixels of interest that lie within the concave hull are valid pixels; if not they are invalid.","position":{"start":{"line":378,"column":1,"offset":18347},"end":{"line":378,"column":274,"offset":18620},"indent":[]}}],"position":{"start":{"line":378,"column":1,"offset":18347},"end":{"line":378,"column":274,"offset":18620},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Heuristic","position":{"start":{"line":380,"column":4,"offset":18625},"end":{"line":380,"column":13,"offset":18634},"indent":[]}}],"position":{"start":{"line":380,"column":1,"offset":18622},"end":{"line":380,"column":13,"offset":18634},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The heuristic is the last step in the four passway which will decide if the detection is valid or not. It will do this by using information from the previous steps (the expositor and the algorithm); e.g. number of changed pixels.","position":{"start":{"line":382,"column":1,"offset":18636},"end":{"line":382,"column":230,"offset":18865},"indent":[]}}],"position":{"start":{"line":382,"column":1,"offset":18636},"end":{"line":382,"column":230,"offset":18865},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can change the heuristic by changing the ","position":{"start":{"line":384,"column":1,"offset":18867},"end":{"line":384,"column":46,"offset":18912},"indent":[]}},{"type":"inlineCode","value":"config/config.xml","position":{"start":{"line":384,"column":46,"offset":18912},"end":{"line":384,"column":65,"offset":18931},"indent":[]}},{"type":"text","value":" file, and choose one of the following:","position":{"start":{"line":384,"column":65,"offset":18931},"end":{"line":384,"column":104,"offset":18970},"indent":[]}}],"position":{"start":{"line":384,"column":1,"offset":18867},"end":{"line":384,"column":104,"offset":18970},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Sequence","position":{"start":{"line":385,"column":3,"offset":18973},"end":{"line":385,"column":11,"offset":18981},"indent":[]}}],"position":{"start":{"line":385,"column":3,"offset":18973},"end":{"line":385,"column":11,"offset":18981},"indent":[]}}],"position":{"start":{"line":385,"column":1,"offset":18971},"end":{"line":385,"column":11,"offset":18981},"indent":[]}}],"position":{"start":{"line":385,"column":1,"offset":18971},"end":{"line":385,"column":11,"offset":18981},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n ...\n Sequence\n ...\n \n","position":{"start":{"line":387,"column":1,"offset":18983},"end":{"line":396,"column":4,"offset":19138},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Sequence","position":{"start":{"line":398,"column":5,"offset":19144},"end":{"line":398,"column":13,"offset":19152},"indent":[]}}],"position":{"start":{"line":398,"column":1,"offset":19140},"end":{"line":398,"column":13,"offset":19152},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This is a trivial heuristic. The sequence heuristic will store a single integer in memory, that will count the numbers of valid detections. When the heuristic will detect a false detection, it will decrease the count. The sequence heuristic will return true, if a threshold is reached; for example when something was detected three times in a row.","position":{"start":{"line":400,"column":1,"offset":19154},"end":{"line":400,"column":348,"offset":19501},"indent":[]}}],"position":{"start":{"line":400,"column":1,"offset":19154},"end":{"line":400,"column":348,"offset":19501},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":402,"column":6,"offset":19508},"end":{"line":402,"column":16,"offset":19518},"indent":[]}}],"position":{"start":{"line":402,"column":1,"offset":19503},"end":{"line":402,"column":16,"offset":19518},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Sequence heuristic can be found in the config/heuristic.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":404,"column":1,"offset":19520},"end":{"line":404,"column":187,"offset":19706},"indent":[]}}],"position":{"start":{"line":404,"column":1,"offset":19520},"end":{"line":404,"column":187,"offset":19706},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n 1\n 1\n 2000\n \n","position":{"start":{"line":406,"column":1,"offset":19708},"end":{"line":414,"column":4,"offset":19940},"indent":[1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Minimum changes","position":{"start":{"line":416,"column":7,"offset":19948},"end":{"line":416,"column":22,"offset":19963},"indent":[]}}],"position":{"start":{"line":416,"column":1,"offset":19942},"end":{"line":416,"column":22,"offset":19963},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The heuristic will only return true if enough changes have been detected. The minimum of changes indicates the minimum number of pixels that have to been changed, to be a valid detection.","position":{"start":{"line":418,"column":1,"offset":19965},"end":{"line":418,"column":188,"offset":20152},"indent":[]}}],"position":{"start":{"line":418,"column":1,"offset":19965},"end":{"line":418,"column":188,"offset":20152},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Minimum durations","position":{"start":{"line":420,"column":7,"offset":20160},"end":{"line":420,"column":24,"offset":20177},"indent":[]}}],"position":{"start":{"line":420,"column":1,"offset":20154},"end":{"line":420,"column":24,"offset":20177},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The minimum number of detections in a row to be a valid detection.","position":{"start":{"line":422,"column":1,"offset":20179},"end":{"line":422,"column":67,"offset":20245},"indent":[]}}],"position":{"start":{"line":422,"column":1,"offset":20179},"end":{"line":422,"column":67,"offset":20245},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"No motion delay time","position":{"start":{"line":424,"column":7,"offset":20253},"end":{"line":424,"column":27,"offset":20273},"indent":[]}}],"position":{"start":{"line":424,"column":1,"offset":20247},"end":{"line":424,"column":27,"offset":20273},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When the heuristic failed, due to not enough pixels changed or not x detections in a row, the heuristic will idle for some time.","position":{"start":{"line":426,"column":1,"offset":20275},"end":{"line":426,"column":129,"offset":20403},"indent":[]}}],"position":{"start":{"line":426,"column":1,"offset":20275},"end":{"line":426,"column":129,"offset":20403},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Output","position":{"start":{"line":428,"column":4,"offset":20408},"end":{"line":428,"column":10,"offset":20414},"indent":[]}}],"position":{"start":{"line":428,"column":1,"offset":20405},"end":{"line":428,"column":10,"offset":20414},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If the heuristic determined that the evaluation was valid, one or more output operations can be executed. You configure which ooutput operations that will be executed, by modifying the configuration file or using the web interface.","position":{"start":{"line":430,"column":1,"offset":20416},"end":{"line":430,"column":232,"offset":20647},"indent":[]}}],"position":{"start":{"line":430,"column":1,"offset":20416},"end":{"line":430,"column":232,"offset":20647},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\n \n ...\n Video\n ...\n \n","position":{"start":{"line":432,"column":1,"offset":20649},"end":{"line":441,"column":4,"offset":20796},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"You can choose which output devices you will be using. If you select multiple outputs, seperate them with an ","position":{"start":{"line":443,"column":1,"offset":20798},"end":{"line":443,"column":110,"offset":20907},"indent":[]}},{"type":"inlineCode","value":",","position":{"start":{"line":443,"column":110,"offset":20907},"end":{"line":443,"column":113,"offset":20910},"indent":[]}},{"type":"text","value":". You can change the output device by changing the ","position":{"start":{"line":443,"column":113,"offset":20910},"end":{"line":443,"column":164,"offset":20961},"indent":[]}},{"type":"inlineCode","value":"config/config.xml","position":{"start":{"line":443,"column":164,"offset":20961},"end":{"line":443,"column":183,"offset":20980},"indent":[]}},{"type":"text","value":" file, and choose one of the following:","position":{"start":{"line":443,"column":183,"offset":20980},"end":{"line":443,"column":222,"offset":21019},"indent":[]}}],"position":{"start":{"line":443,"column":1,"offset":20798},"end":{"line":443,"column":222,"offset":21019},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Disk","position":{"start":{"line":444,"column":3,"offset":21022},"end":{"line":444,"column":7,"offset":21026},"indent":[]}}],"position":{"start":{"line":444,"column":3,"offset":21022},"end":{"line":444,"column":7,"offset":21026},"indent":[]}}],"position":{"start":{"line":444,"column":1,"offset":21020},"end":{"line":444,"column":7,"offset":21026},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Video","position":{"start":{"line":445,"column":3,"offset":21029},"end":{"line":445,"column":8,"offset":21034},"indent":[]}}],"position":{"start":{"line":445,"column":3,"offset":21029},"end":{"line":445,"column":8,"offset":21034},"indent":[]}}],"position":{"start":{"line":445,"column":1,"offset":21027},"end":{"line":445,"column":8,"offset":21034},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"GPIO","position":{"start":{"line":446,"column":3,"offset":21037},"end":{"line":446,"column":7,"offset":21041},"indent":[]}}],"position":{"start":{"line":446,"column":3,"offset":21037},"end":{"line":446,"column":7,"offset":21041},"indent":[]}}],"position":{"start":{"line":446,"column":1,"offset":21035},"end":{"line":446,"column":7,"offset":21041},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"TCPSocket","position":{"start":{"line":447,"column":3,"offset":21044},"end":{"line":447,"column":12,"offset":21053},"indent":[]}}],"position":{"start":{"line":447,"column":3,"offset":21044},"end":{"line":447,"column":12,"offset":21053},"indent":[]}}],"position":{"start":{"line":447,"column":1,"offset":21042},"end":{"line":447,"column":12,"offset":21053},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Webhook","position":{"start":{"line":448,"column":3,"offset":21056},"end":{"line":448,"column":10,"offset":21063},"indent":[]}}],"position":{"start":{"line":448,"column":3,"offset":21056},"end":{"line":448,"column":10,"offset":21063},"indent":[]}}],"position":{"start":{"line":448,"column":1,"offset":21054},"end":{"line":448,"column":10,"offset":21063},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"MQTT","position":{"start":{"line":449,"column":3,"offset":21066},"end":{"line":449,"column":7,"offset":21070},"indent":[]}}],"position":{"start":{"line":449,"column":3,"offset":21066},"end":{"line":449,"column":7,"offset":21070},"indent":[]}}],"position":{"start":{"line":449,"column":1,"offset":21064},"end":{"line":449,"column":7,"offset":21070},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Script","position":{"start":{"line":450,"column":3,"offset":21073},"end":{"line":450,"column":9,"offset":21079},"indent":[]}}],"position":{"start":{"line":450,"column":3,"offset":21073},"end":{"line":450,"column":9,"offset":21079},"indent":[]}}],"position":{"start":{"line":450,"column":1,"offset":21071},"end":{"line":450,"column":9,"offset":21079},"indent":[]}}],"position":{"start":{"line":444,"column":1,"offset":21020},"end":{"line":450,"column":9,"offset":21079},"indent":[1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Disk","position":{"start":{"line":452,"column":5,"offset":21085},"end":{"line":452,"column":9,"offset":21089},"indent":[]}}],"position":{"start":{"line":452,"column":1,"offset":21081},"end":{"line":452,"column":9,"offset":21089},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"An image can be saved to disk.","position":{"start":{"line":454,"column":1,"offset":21091},"end":{"line":454,"column":31,"offset":21121},"indent":[]}}],"position":{"start":{"line":454,"column":1,"offset":21091},"end":{"line":454,"column":31,"offset":21121},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":456,"column":6,"offset":21128},"end":{"line":456,"column":16,"offset":21138},"indent":[]}}],"position":{"start":{"line":456,"column":1,"offset":21123},"end":{"line":456,"column":16,"offset":21138},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Disk output device can be found in the ","position":{"start":{"line":458,"column":1,"offset":21140},"end":{"line":458,"column":62,"offset":21201},"indent":[]}},{"type":"inlineCode","value":"config/io.xml","position":{"start":{"line":458,"column":62,"offset":21201},"end":{"line":458,"column":77,"offset":21216},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":458,"column":77,"offset":21216},"end":{"line":458,"column":182,"offset":21321},"indent":[]}}],"position":{"start":{"line":458,"column":1,"offset":21140},"end":{"line":458,"column":182,"offset":21321},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n timestamp_microseconds_instanceName_regionCoordinates_numberOfChanges_token.jpg\n /etc/opt/kerberosio/capture/\n false\n white\n false\n 0\n \n","position":{"start":{"line":460,"column":1,"offset":21323},"end":{"line":471,"column":4,"offset":21754},"indent":[1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"File format","position":{"start":{"line":473,"column":7,"offset":21762},"end":{"line":473,"column":18,"offset":21773},"indent":[]}}],"position":{"start":{"line":473,"column":1,"offset":21756},"end":{"line":473,"column":18,"offset":21773},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The format that will be used for the name of the image. One or more variables can be defined and will be replaced by the machinery. Note that when you're using a variables name in the file format, that this name should be defined in the JSON object.","position":{"start":{"line":475,"column":1,"offset":21775},"end":{"line":475,"column":250,"offset":22024},"indent":[]}}],"position":{"start":{"line":475,"column":1,"offset":21775},"end":{"line":475,"column":250,"offset":22024},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Directory","position":{"start":{"line":477,"column":7,"offset":22032},"end":{"line":477,"column":16,"offset":22041},"indent":[]}}],"position":{"start":{"line":477,"column":1,"offset":22026},"end":{"line":477,"column":16,"offset":22041},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The directory where the image will be saved to. By default images are saved to the /etc/opt/kerberosio/capture directory.","position":{"start":{"line":479,"column":1,"offset":22043},"end":{"line":479,"column":122,"offset":22164},"indent":[]}}],"position":{"start":{"line":479,"column":1,"offset":22043},"end":{"line":479,"column":122,"offset":22164},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Mark with timestamp","position":{"start":{"line":481,"column":7,"offset":22172},"end":{"line":481,"column":26,"offset":22191},"indent":[]}}],"position":{"start":{"line":481,"column":1,"offset":22166},"end":{"line":481,"column":26,"offset":22191},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When this settings is set to true, the image is marked with a timestamp.","position":{"start":{"line":483,"column":1,"offset":22193},"end":{"line":483,"column":73,"offset":22265},"indent":[]}}],"position":{"start":{"line":483,"column":1,"offset":22193},"end":{"line":483,"column":73,"offset":22265},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Timestamp color","position":{"start":{"line":485,"column":7,"offset":22273},"end":{"line":485,"column":22,"offset":22288},"indent":[]}}],"position":{"start":{"line":485,"column":1,"offset":22267},"end":{"line":485,"column":22,"offset":22288},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A color can be defined for timestamp: white, black, red, green and blue.","position":{"start":{"line":486,"column":1,"offset":22289},"end":{"line":486,"column":73,"offset":22361},"indent":[]}}],"position":{"start":{"line":486,"column":1,"offset":22289},"end":{"line":486,"column":73,"offset":22361},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Privacy","position":{"start":{"line":488,"column":7,"offset":22369},"end":{"line":488,"column":14,"offset":22376},"indent":[]}}],"position":{"start":{"line":488,"column":1,"offset":22363},"end":{"line":488,"column":14,"offset":22376},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The privacy mode can be activated to remove some parts from the image. This especially helpful if you want to filter out public areas. When this option is enabled you will seee that after configuring the Hull expositor, you'll see that the pixels outside your region of interest (Hull) are made black.","position":{"start":{"line":489,"column":1,"offset":22377},"end":{"line":489,"column":303,"offset":22679},"indent":[]}}],"position":{"start":{"line":489,"column":1,"offset":22377},"end":{"line":489,"column":303,"offset":22679},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":491,"column":7,"offset":22687},"end":{"line":491,"column":16,"offset":22696},"indent":[]}}],"position":{"start":{"line":491,"column":1,"offset":22681},"end":{"line":491,"column":16,"offset":22696},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Disk will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":492,"column":1,"offset":22697},"end":{"line":492,"column":187,"offset":22883},"indent":[]}}],"position":{"start":{"line":492,"column":1,"offset":22697},"end":{"line":492,"column":187,"offset":22883},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Video","position":{"start":{"line":494,"column":5,"offset":22889},"end":{"line":494,"column":10,"offset":22894},"indent":[]}}],"position":{"start":{"line":494,"column":1,"offset":22885},"end":{"line":494,"column":10,"offset":22894},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When a valid event is detected, a video will be recorded for x seconds. When more valid events are detected, while a video is recording, the video file will further record for x seconds; so no new video file be recorded, but the existing one will be expanded.","position":{"start":{"line":495,"column":1,"offset":22895},"end":{"line":495,"column":260,"offset":23154},"indent":[]}}],"position":{"start":{"line":495,"column":1,"offset":22895},"end":{"line":495,"column":260,"offset":23154},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":497,"column":6,"offset":23161},"end":{"line":497,"column":16,"offset":23171},"indent":[]}}],"position":{"start":{"line":497,"column":1,"offset":23156},"end":{"line":497,"column":16,"offset":23171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Video output device can be found in the ","position":{"start":{"line":498,"column":1,"offset":23172},"end":{"line":498,"column":63,"offset":23234},"indent":[]}},{"type":"inlineCode","value":"config/io.xml","position":{"start":{"line":498,"column":63,"offset":23234},"end":{"line":498,"column":78,"offset":23249},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":498,"column":78,"offset":23249},"end":{"line":498,"column":183,"offset":23354},"indent":[]}}],"position":{"start":{"line":498,"column":1,"offset":23172},"end":{"line":498,"column":183,"offset":23354},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n","position":{"start":{"line":500,"column":1,"offset":23356},"end":{"line":518,"column":4,"offset":24146},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"FPS","position":{"start":{"line":520,"column":7,"offset":24154},"end":{"line":520,"column":10,"offset":24157},"indent":[]}}],"position":{"start":{"line":520,"column":1,"offset":24148},"end":{"line":520,"column":10,"offset":24157},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The frames per second of the video being recorded. Please note that this number is limited and depends heavily on your hardware setup. You'll be receiving following warning in the systems logs, if the machinery can't write the desired FPS.","position":{"start":{"line":521,"column":1,"offset":24158},"end":{"line":521,"column":240,"offset":24397},"indent":[]}}],"position":{"start":{"line":521,"column":1,"offset":24158},"end":{"line":521,"column":240,"offset":24397},"indent":[]}},{"type":"code","lang":"text","meta":null,"value":"[trivial] IoVideo: framerate is too fast, can't record video at this speed (8/FPS)","position":{"start":{"line":523,"column":1,"offset":24399},"end":{"line":525,"column":4,"offset":24493},"indent":[1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Record after","position":{"start":{"line":526,"column":7,"offset":24500},"end":{"line":526,"column":19,"offset":24512},"indent":[]}}],"position":{"start":{"line":526,"column":1,"offset":24494},"end":{"line":526,"column":19,"offset":24512},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The number of seconds recorded after the last valid event was detected. This means that when a video is already recording, and a valid event was detected, the video will be expanded with x more seconds.","position":{"start":{"line":527,"column":1,"offset":24513},"end":{"line":527,"column":203,"offset":24715},"indent":[]}}],"position":{"start":{"line":527,"column":1,"offset":24513},"end":{"line":527,"column":203,"offset":24715},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Extensions","position":{"start":{"line":529,"column":7,"offset":24723},"end":{"line":529,"column":17,"offset":24733},"indent":[]}}],"position":{"start":{"line":529,"column":1,"offset":24717},"end":{"line":529,"column":17,"offset":24733},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The extension or container of the video file. We highly recommend to use the MP4 container if you want cross-browser support. Leave this setting by default, if you don't know what you're doing.","position":{"start":{"line":530,"column":1,"offset":24734},"end":{"line":530,"column":194,"offset":24927},"indent":[]}}],"position":{"start":{"line":530,"column":1,"offset":24734},"end":{"line":530,"column":194,"offset":24927},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Codec","position":{"start":{"line":532,"column":7,"offset":24935},"end":{"line":532,"column":12,"offset":24940},"indent":[]}}],"position":{"start":{"line":532,"column":1,"offset":24929},"end":{"line":532,"column":12,"offset":24940},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The codec that is used to encode the video file.","position":{"start":{"line":533,"column":1,"offset":24941},"end":{"line":533,"column":49,"offset":24989},"indent":[]}}],"position":{"start":{"line":533,"column":1,"offset":24941},"end":{"line":533,"column":49,"offset":24989},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"File format","position":{"start":{"line":535,"column":7,"offset":24997},"end":{"line":535,"column":18,"offset":25008},"indent":[]}}],"position":{"start":{"line":535,"column":1,"offset":24991},"end":{"line":535,"column":18,"offset":25008},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The format that will be used for the name of the image. One or more variables can be defined and will be replaced by the machinery. Note that when you're using a variables name in the file format, that this name should be defined in the JSON object.","position":{"start":{"line":536,"column":1,"offset":25009},"end":{"line":536,"column":250,"offset":25258},"indent":[]}}],"position":{"start":{"line":536,"column":1,"offset":25009},"end":{"line":536,"column":250,"offset":25258},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Directory","position":{"start":{"line":538,"column":7,"offset":25266},"end":{"line":538,"column":16,"offset":25275},"indent":[]}}],"position":{"start":{"line":538,"column":1,"offset":25260},"end":{"line":538,"column":16,"offset":25275},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The directory where the videos will be saved. By default videos are saved to the /etc/opt/kerberosio/capture directory.","position":{"start":{"line":539,"column":1,"offset":25276},"end":{"line":539,"column":120,"offset":25395},"indent":[]}}],"position":{"start":{"line":539,"column":1,"offset":25276},"end":{"line":539,"column":120,"offset":25395},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Hardware directory","position":{"start":{"line":541,"column":7,"offset":25403},"end":{"line":541,"column":25,"offset":25421},"indent":[]}}],"position":{"start":{"line":541,"column":1,"offset":25397},"end":{"line":541,"column":25,"offset":25421},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When using onboard hardware encoding (e.g. with Raspberry Pi camera), h264 video files are generated and stored in this directory. Afterwards these h264 files will be containerized to mp4 files, and stored in the Directory path.","position":{"start":{"line":542,"column":1,"offset":25422},"end":{"line":542,"column":229,"offset":25650},"indent":[]}}],"position":{"start":{"line":542,"column":1,"offset":25422},"end":{"line":542,"column":229,"offset":25650},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Enable Hardware encoding","position":{"start":{"line":544,"column":7,"offset":25658},"end":{"line":544,"column":31,"offset":25682},"indent":[]}}],"position":{"start":{"line":544,"column":1,"offset":25652},"end":{"line":544,"column":31,"offset":25682},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A boolean which can enable or disable hardware encoding. Please note that this option is enabled by default, but does not mean that it will work if you choose to use an USB camera.","position":{"start":{"line":545,"column":1,"offset":25683},"end":{"line":545,"column":181,"offset":25863},"indent":[]}}],"position":{"start":{"line":545,"column":1,"offset":25683},"end":{"line":545,"column":181,"offset":25863},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Mark with timestamp","position":{"start":{"line":547,"column":7,"offset":25871},"end":{"line":547,"column":26,"offset":25890},"indent":[]}}],"position":{"start":{"line":547,"column":1,"offset":25865},"end":{"line":547,"column":26,"offset":25890},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"When this settings is set to true, the video is marked with a timestamp (similar to the Disk device).","position":{"start":{"line":548,"column":1,"offset":25891},"end":{"line":548,"column":102,"offset":25992},"indent":[]}}],"position":{"start":{"line":548,"column":1,"offset":25891},"end":{"line":548,"column":102,"offset":25992},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Timestamp color","position":{"start":{"line":550,"column":7,"offset":26000},"end":{"line":550,"column":22,"offset":26015},"indent":[]}}],"position":{"start":{"line":550,"column":1,"offset":25994},"end":{"line":550,"column":22,"offset":26015},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A color can be defined for timestamp: white, black, red, green and blue.","position":{"start":{"line":551,"column":1,"offset":26016},"end":{"line":551,"column":73,"offset":26088},"indent":[]}}],"position":{"start":{"line":551,"column":1,"offset":26016},"end":{"line":551,"column":73,"offset":26088},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Privacy","position":{"start":{"line":553,"column":7,"offset":26096},"end":{"line":553,"column":14,"offset":26103},"indent":[]}}],"position":{"start":{"line":553,"column":1,"offset":26090},"end":{"line":553,"column":14,"offset":26103},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The privacy mode can be activated to remove some parts from the video. This especially helpful if you want to filter out public areas.","position":{"start":{"line":554,"column":1,"offset":26104},"end":{"line":554,"column":135,"offset":26238},"indent":[]}}],"position":{"start":{"line":554,"column":1,"offset":26104},"end":{"line":554,"column":135,"offset":26238},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Video privacy","position":{"start":{"line":556,"column":7,"offset":26246},"end":{"line":556,"column":20,"offset":26259},"indent":[]}}],"position":{"start":{"line":556,"column":1,"offset":26240},"end":{"line":556,"column":20,"offset":26259},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"After updating the configuration, you'll see that the pixels outside your region of interest (ROI) are made black; the image below illustrates this.","position":{"start":{"line":557,"column":1,"offset":26260},"end":{"line":557,"column":149,"offset":26408},"indent":[]}}],"position":{"start":{"line":557,"column":1,"offset":26260},"end":{"line":557,"column":149,"offset":26408},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":559,"column":7,"offset":26416},"end":{"line":559,"column":16,"offset":26425},"indent":[]}}],"position":{"start":{"line":559,"column":1,"offset":26410},"end":{"line":559,"column":16,"offset":26425},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Video will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":560,"column":1,"offset":26426},"end":{"line":560,"column":188,"offset":26613},"indent":[]}}],"position":{"start":{"line":560,"column":1,"offset":26426},"end":{"line":560,"column":188,"offset":26613},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"TCP/IP client","position":{"start":{"line":562,"column":5,"offset":26619},"end":{"line":562,"column":18,"offset":26632},"indent":[]}}],"position":{"start":{"line":562,"column":1,"offset":26615},"end":{"line":562,"column":18,"offset":26632},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The TCP/IP client will send a TCP packet to a server.","position":{"start":{"line":564,"column":1,"offset":26634},"end":{"line":564,"column":54,"offset":26687},"indent":[]}}],"position":{"start":{"line":564,"column":1,"offset":26634},"end":{"line":564,"column":54,"offset":26687},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":566,"column":6,"offset":26694},"end":{"line":566,"column":16,"offset":26704},"indent":[]}}],"position":{"start":{"line":566,"column":1,"offset":26689},"end":{"line":566,"column":16,"offset":26704},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the TCP/IP client can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":567,"column":1,"offset":26705},"end":{"line":567,"column":175,"offset":26879},"indent":[]}}],"position":{"start":{"line":567,"column":1,"offset":26705},"end":{"line":567,"column":175,"offset":26879},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n 127.0.0.1\n 1337\n it's so fluffy\n 0\n \n","position":{"start":{"line":569,"column":1,"offset":26881},"end":{"line":578,"column":4,"offset":27107},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Server","position":{"start":{"line":580,"column":7,"offset":27115},"end":{"line":580,"column":13,"offset":27121},"indent":[]}}],"position":{"start":{"line":580,"column":1,"offset":27109},"end":{"line":580,"column":13,"offset":27121},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The IP of the TCP server.","position":{"start":{"line":581,"column":1,"offset":27122},"end":{"line":581,"column":26,"offset":27147},"indent":[]}}],"position":{"start":{"line":581,"column":1,"offset":27122},"end":{"line":581,"column":26,"offset":27147},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Port","position":{"start":{"line":583,"column":7,"offset":27155},"end":{"line":583,"column":11,"offset":27159},"indent":[]}}],"position":{"start":{"line":583,"column":1,"offset":27149},"end":{"line":583,"column":11,"offset":27159},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This is the port of the TCP server.","position":{"start":{"line":584,"column":1,"offset":27160},"end":{"line":584,"column":36,"offset":27195},"indent":[]}}],"position":{"start":{"line":584,"column":1,"offset":27160},"end":{"line":584,"column":36,"offset":27195},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Message","position":{"start":{"line":586,"column":7,"offset":27203},"end":{"line":586,"column":14,"offset":27210},"indent":[]}}],"position":{"start":{"line":586,"column":1,"offset":27197},"end":{"line":586,"column":14,"offset":27210},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can send some data to a TCP server.","position":{"start":{"line":587,"column":1,"offset":27211},"end":{"line":587,"column":40,"offset":27250},"indent":[]}}],"position":{"start":{"line":587,"column":1,"offset":27211},"end":{"line":587,"column":40,"offset":27250},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":589,"column":7,"offset":27258},"end":{"line":589,"column":16,"offset":27267},"indent":[]}}],"position":{"start":{"line":589,"column":1,"offset":27252},"end":{"line":589,"column":16,"offset":27267},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the TCP will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":590,"column":1,"offset":27268},"end":{"line":590,"column":186,"offset":27453},"indent":[]}}],"position":{"start":{"line":590,"column":1,"offset":27268},"end":{"line":590,"column":186,"offset":27453},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"GPIO","position":{"start":{"line":592,"column":5,"offset":27459},"end":{"line":592,"column":9,"offset":27463},"indent":[]}}],"position":{"start":{"line":592,"column":1,"offset":27455},"end":{"line":592,"column":9,"offset":27463},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A GPIO pin can be set as output device.","position":{"start":{"line":593,"column":1,"offset":27464},"end":{"line":593,"column":40,"offset":27503},"indent":[]}}],"position":{"start":{"line":593,"column":1,"offset":27464},"end":{"line":593,"column":40,"offset":27503},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":595,"column":6,"offset":27510},"end":{"line":595,"column":16,"offset":27520},"indent":[]}}],"position":{"start":{"line":595,"column":1,"offset":27505},"end":{"line":595,"column":16,"offset":27520},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the GPIO pin can be found in the ","position":{"start":{"line":596,"column":1,"offset":27521},"end":{"line":596,"column":52,"offset":27572},"indent":[]}},{"type":"inlineCode","value":"config/io.xml","position":{"start":{"line":596,"column":52,"offset":27572},"end":{"line":596,"column":67,"offset":27587},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":596,"column":67,"offset":27587},"end":{"line":596,"column":172,"offset":27692},"indent":[]}}],"position":{"start":{"line":596,"column":1,"offset":27521},"end":{"line":596,"column":172,"offset":27692},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n 17\n 5\n 100000\n 0\n \n","position":{"start":{"line":598,"column":1,"offset":27694},"end":{"line":607,"column":4,"offset":27900},"indent":[1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Pin","position":{"start":{"line":609,"column":7,"offset":27908},"end":{"line":609,"column":10,"offset":27911},"indent":[]}}],"position":{"start":{"line":609,"column":1,"offset":27902},"end":{"line":609,"column":10,"offset":27911},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The pin that will be triggered.","position":{"start":{"line":610,"column":1,"offset":27912},"end":{"line":610,"column":32,"offset":27943},"indent":[]}}],"position":{"start":{"line":610,"column":1,"offset":27912},"end":{"line":610,"column":32,"offset":27943},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Periods","position":{"start":{"line":612,"column":7,"offset":27951},"end":{"line":612,"column":14,"offset":27958},"indent":[]}}],"position":{"start":{"line":612,"column":1,"offset":27945},"end":{"line":612,"column":14,"offset":27958},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The number of times the pin will be triggered.","position":{"start":{"line":613,"column":1,"offset":27959},"end":{"line":613,"column":47,"offset":28005},"indent":[]}}],"position":{"start":{"line":613,"column":1,"offset":27959},"end":{"line":613,"column":47,"offset":28005},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Period time","position":{"start":{"line":615,"column":7,"offset":28013},"end":{"line":615,"column":18,"offset":28024},"indent":[]}}],"position":{"start":{"line":615,"column":1,"offset":28007},"end":{"line":615,"column":18,"offset":28024},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The time in microseconds that the pin will be set high.","position":{"start":{"line":616,"column":1,"offset":28025},"end":{"line":616,"column":56,"offset":28080},"indent":[]}}],"position":{"start":{"line":616,"column":1,"offset":28025},"end":{"line":616,"column":56,"offset":28080},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":618,"column":7,"offset":28088},"end":{"line":618,"column":16,"offset":28097},"indent":[]}}],"position":{"start":{"line":618,"column":1,"offset":28082},"end":{"line":618,"column":16,"offset":28097},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the GPIO will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":619,"column":1,"offset":28098},"end":{"line":619,"column":187,"offset":28284},"indent":[]}}],"position":{"start":{"line":619,"column":1,"offset":28098},"end":{"line":619,"column":187,"offset":28284},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Webhook","position":{"start":{"line":621,"column":6,"offset":28291},"end":{"line":621,"column":13,"offset":28298},"indent":[]}}],"position":{"start":{"line":621,"column":1,"offset":28286},"end":{"line":621,"column":13,"offset":28298},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Detailed information (a JSON object) is send as a POST request to a webhook. The JSON object contains the number of changes, the region, the URL of the image, etc. This is useful if you want to integrate with your own application.","position":{"start":{"line":622,"column":1,"offset":28299},"end":{"line":622,"column":231,"offset":28529},"indent":[]}}],"position":{"start":{"line":622,"column":1,"offset":28299},"end":{"line":622,"column":231,"offset":28529},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Make sure that the Webhook comes after the Disk device, otherwise the URL of the image is not included.","position":{"start":{"line":624,"column":1,"offset":28531},"end":{"line":624,"column":104,"offset":28634},"indent":[]}}],"position":{"start":{"line":624,"column":1,"offset":28531},"end":{"line":624,"column":104,"offset":28634},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":626,"column":6,"offset":28641},"end":{"line":626,"column":16,"offset":28651},"indent":[]}}],"position":{"start":{"line":626,"column":1,"offset":28636},"end":{"line":626,"column":16,"offset":28651},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the webhook can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":627,"column":1,"offset":28652},"end":{"line":627,"column":169,"offset":28820},"indent":[]}}],"position":{"start":{"line":627,"column":1,"offset":28652},"end":{"line":627,"column":169,"offset":28820},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n http://kerberos.web/api/v1/webhook\n 0\n \n","position":{"start":{"line":629,"column":1,"offset":28822},"end":{"line":636,"column":4,"offset":28975},"indent":[1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Url","position":{"start":{"line":638,"column":7,"offset":28983},"end":{"line":638,"column":10,"offset":28986},"indent":[]}}],"position":{"start":{"line":638,"column":1,"offset":28977},"end":{"line":638,"column":10,"offset":28986},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"This is the URL, to which the machinery will send a JSON object (as a POST request).","position":{"start":{"line":639,"column":1,"offset":28987},"end":{"line":639,"column":85,"offset":29071},"indent":[]}}],"position":{"start":{"line":639,"column":1,"offset":28987},"end":{"line":639,"column":85,"offset":29071},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":641,"column":7,"offset":29079},"end":{"line":641,"column":16,"offset":29088},"indent":[]}}],"position":{"start":{"line":641,"column":1,"offset":29073},"end":{"line":641,"column":16,"offset":29088},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Webhook will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":642,"column":1,"offset":29089},"end":{"line":642,"column":190,"offset":29278},"indent":[]}}],"position":{"start":{"line":642,"column":1,"offset":29089},"end":{"line":642,"column":190,"offset":29278},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Output","position":{"start":{"line":644,"column":7,"offset":29286},"end":{"line":644,"column":13,"offset":29292},"indent":[]}}],"position":{"start":{"line":644,"column":1,"offset":29280},"end":{"line":644,"column":13,"offset":29292},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A JSON object is POSTed to the url you've defined.","position":{"start":{"line":645,"column":1,"offset":29293},"end":{"line":645,"column":51,"offset":29343},"indent":[]}}],"position":{"start":{"line":645,"column":1,"offset":29293},"end":{"line":645,"column":51,"offset":29343},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"[\n 'regionCoordinates' : [618, 317, 703, 493],\n 'numberOfChanges' : 5446,\n 'timestamp' : '1465894497',\n 'microseconds' : '5-97451',\n 'token' : 695,\n 'pathToImage' : '1465894497_5-97451_frontdoor_618-317-703-493_5446_695.jpg',\n 'instanceName' : 'frontdoor',\n]","position":{"start":{"line":647,"column":1,"offset":29345},"end":{"line":657,"column":4,"offset":29622},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Script","position":{"start":{"line":659,"column":5,"offset":29628},"end":{"line":659,"column":11,"offset":29634},"indent":[]}}],"position":{"start":{"line":659,"column":1,"offset":29624},"end":{"line":659,"column":11,"offset":29634},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A bash script can be executed after a valid event was detected. A JSON object is send in the first parameter to the script you've defined.","position":{"start":{"line":660,"column":1,"offset":29635},"end":{"line":660,"column":139,"offset":29773},"indent":[]}}],"position":{"start":{"line":660,"column":1,"offset":29635},"end":{"line":660,"column":139,"offset":29773},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":662,"column":6,"offset":29780},"end":{"line":662,"column":16,"offset":29790},"indent":[]}}],"position":{"start":{"line":662,"column":1,"offset":29775},"end":{"line":662,"column":16,"offset":29790},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the Script output device can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":663,"column":1,"offset":29791},"end":{"line":663,"column":182,"offset":29972},"indent":[]}}],"position":{"start":{"line":663,"column":1,"offset":29791},"end":{"line":663,"column":182,"offset":29972},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n \n","position":{"start":{"line":665,"column":1,"offset":29974},"end":{"line":672,"column":4,"offset":30127},"indent":[1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Path","position":{"start":{"line":674,"column":7,"offset":30135},"end":{"line":674,"column":11,"offset":30139},"indent":[]}}],"position":{"start":{"line":674,"column":1,"offset":30129},"end":{"line":674,"column":11,"offset":30139},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The location of the script that will be executed on detection.","position":{"start":{"line":675,"column":1,"offset":30140},"end":{"line":675,"column":63,"offset":30202},"indent":[]}}],"position":{"start":{"line":675,"column":1,"offset":30140},"end":{"line":675,"column":63,"offset":30202},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":677,"column":7,"offset":30210},"end":{"line":677,"column":16,"offset":30219},"indent":[]}}],"position":{"start":{"line":677,"column":1,"offset":30204},"end":{"line":677,"column":16,"offset":30219},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Script will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":678,"column":1,"offset":30220},"end":{"line":678,"column":189,"offset":30408},"indent":[]}}],"position":{"start":{"line":678,"column":1,"offset":30220},"end":{"line":678,"column":189,"offset":30408},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Example","position":{"start":{"line":680,"column":7,"offset":30416},"end":{"line":680,"column":14,"offset":30423},"indent":[]}}],"position":{"start":{"line":680,"column":1,"offset":30410},"end":{"line":680,"column":14,"offset":30423},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By default the script will point to /etc/opt/kerberosio/scripts/run.sh, which contains a template how you should start your script. Note that when using KiOS, this script will be read-only, copy it to the /data folder and change the path parameter.","position":{"start":{"line":681,"column":1,"offset":30424},"end":{"line":681,"column":249,"offset":30672},"indent":[]}}],"position":{"start":{"line":681,"column":1,"offset":30424},"end":{"line":681,"column":249,"offset":30672},"indent":[]}},{"type":"code","lang":"python","meta":null,"value":"#!/bin/bash\n# -------------------------------------------\n# This is an example script which illustrates\n# how to use the Script IO device.\n#\n# --------------------------------------\n# The first parameter is the JSON object\n#\n# e.g. {\"regionCoordinates\":[308,250,346,329],\"numberOfChanges\":194,\"timestamp\":\"1486049622\",\"microseconds\":\"6-161868\",\"token\":344,\"pathToImage\":\"1486049622_6-161868_frontdoor_308-250-346-329_194_344.jpg\",\"instanceName\":\"frontdoor\"}\nJSON=$1\n# -------------------------------------------\n# You can use python to parse the JSON object\n# and get the required fields\nname=$(echo $JSON | python -c \"import sys, json; print json.load(sys.stdin)['instanceName']\")\ncoordinates=$(echo $JSON | python -c \"import sys, json; print json.load(sys.stdin)['regionCoordinates']\")\nchanges=$(echo $JSON | pythfon -c \"import sys, json; print json.load(sys.stdin)['numberOfChanges']\")\nimage=$(echo $JSON | python -c \"import sys, json; print json.load(sys.stdin)['pathToImage']\")\nThe idea is that you can use Python in your bash script, to parse the JSON object send as first parameter. Afterwards you can do with the output what you want.","position":{"start":{"line":683,"column":1,"offset":30674},"end":{"line":702,"column":4,"offset":31830},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"MQTT","position":{"start":{"line":704,"column":5,"offset":31836},"end":{"line":704,"column":9,"offset":31840},"indent":[]}}],"position":{"start":{"line":704,"column":1,"offset":31832},"end":{"line":704,"column":9,"offset":31840},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"MQTT protocol is a light-weight Machine to Machine (M2M) protocol widely used in Internet of things.\nDetailed information (a JSON object) is published to an MQTT topic. The JSON object contains the number of changes, the region, the URL of the image, etc.","position":{"start":{"line":705,"column":1,"offset":31841},"end":{"line":706,"column":155,"offset":32096},"indent":[1]}}],"position":{"start":{"line":705,"column":1,"offset":31841},"end":{"line":706,"column":155,"offset":32096},"indent":[1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":708,"column":6,"offset":32103},"end":{"line":708,"column":16,"offset":32113},"indent":[]}}],"position":{"start":{"line":708,"column":1,"offset":32098},"end":{"line":708,"column":16,"offset":32113},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters of the MQTT output can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.","position":{"start":{"line":709,"column":1,"offset":32114},"end":{"line":709,"column":173,"offset":32286},"indent":[]}}],"position":{"start":{"line":709,"column":1,"offset":32114},"end":{"line":709,"column":173,"offset":32286},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n false\n false\n 127.0.0.1\n 1883\n kios/mqtt\n \n \n 0\n \n","position":{"start":{"line":711,"column":1,"offset":32288},"end":{"line":724,"column":4,"offset":32652},"indent":[1,1,1,1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Secure","position":{"start":{"line":726,"column":7,"offset":32660},"end":{"line":726,"column":13,"offset":32666},"indent":[]}}],"position":{"start":{"line":726,"column":1,"offset":32654},"end":{"line":726,"column":13,"offset":32666},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If checked, enable SSL/TLS support. Please note that when SSL/TLS support is enabled, the server certificate issuer is verified against the CA (Certification Authority) files available in /etc/ssl/certs.","position":{"start":{"line":727,"column":1,"offset":32667},"end":{"line":727,"column":204,"offset":32870},"indent":[]}}],"position":{"start":{"line":727,"column":1,"offset":32667},"end":{"line":727,"column":204,"offset":32870},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Verifycn","position":{"start":{"line":729,"column":7,"offset":32878},"end":{"line":729,"column":15,"offset":32886},"indent":[]}}],"position":{"start":{"line":729,"column":1,"offset":32872},"end":{"line":729,"column":15,"offset":32886},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If checked, the MQTT server FQDN or ip address must match the CN (Common Name) of the server certificate.","position":{"start":{"line":730,"column":1,"offset":32887},"end":{"line":730,"column":106,"offset":32992},"indent":[]}}],"position":{"start":{"line":730,"column":1,"offset":32887},"end":{"line":730,"column":106,"offset":32992},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Server","position":{"start":{"line":732,"column":7,"offset":33000},"end":{"line":732,"column":13,"offset":33006},"indent":[]}}],"position":{"start":{"line":732,"column":1,"offset":32994},"end":{"line":732,"column":13,"offset":33006},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"IP address or FQDN of the MQTT broker.","position":{"start":{"line":733,"column":1,"offset":33007},"end":{"line":733,"column":39,"offset":33045},"indent":[]}}],"position":{"start":{"line":733,"column":1,"offset":33007},"end":{"line":733,"column":39,"offset":33045},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Port","position":{"start":{"line":735,"column":7,"offset":33053},"end":{"line":735,"column":11,"offset":33057},"indent":[]}}],"position":{"start":{"line":735,"column":1,"offset":33047},"end":{"line":735,"column":11,"offset":33057},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"TCP port of the MQTT broker.","position":{"start":{"line":736,"column":1,"offset":33058},"end":{"line":736,"column":29,"offset":33086},"indent":[]}}],"position":{"start":{"line":736,"column":1,"offset":33058},"end":{"line":736,"column":29,"offset":33086},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Topic","position":{"start":{"line":738,"column":7,"offset":33094},"end":{"line":738,"column":12,"offset":33099},"indent":[]}}],"position":{"start":{"line":738,"column":1,"offset":33088},"end":{"line":738,"column":12,"offset":33099},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The topic to publish to.","position":{"start":{"line":739,"column":1,"offset":33100},"end":{"line":739,"column":25,"offset":33124},"indent":[]}}],"position":{"start":{"line":739,"column":1,"offset":33100},"end":{"line":739,"column":25,"offset":33124},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Username","position":{"start":{"line":741,"column":7,"offset":33132},"end":{"line":741,"column":15,"offset":33140},"indent":[]}}],"position":{"start":{"line":741,"column":1,"offset":33126},"end":{"line":741,"column":15,"offset":33140},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The username for authenticating to the MQTT broker. This is only supported by brokers that implement the MQTT spec v3.1. If username is not set (empty), the password argument is ignored. This is only needed if the MQTT broker is configured for authentication.","position":{"start":{"line":742,"column":1,"offset":33141},"end":{"line":742,"column":260,"offset":33400},"indent":[]}}],"position":{"start":{"line":742,"column":1,"offset":33141},"end":{"line":742,"column":260,"offset":33400},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Password","position":{"start":{"line":744,"column":7,"offset":33408},"end":{"line":744,"column":15,"offset":33416},"indent":[]}}],"position":{"start":{"line":744,"column":1,"offset":33402},"end":{"line":744,"column":15,"offset":33416},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The password to use, together with the username, for authenticating to the MQTT broker. This is only supported by brokers that implement the MQTT spec v3.1. This is only needed if the MQTT broker is configured for authentication.","position":{"start":{"line":745,"column":1,"offset":33417},"end":{"line":745,"column":230,"offset":33646},"indent":[]}}],"position":{"start":{"line":745,"column":1,"offset":33417},"end":{"line":745,"column":230,"offset":33646},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Throttler","position":{"start":{"line":747,"column":7,"offset":33654},"end":{"line":747,"column":16,"offset":33663},"indent":[]}}],"position":{"start":{"line":747,"column":1,"offset":33648},"end":{"line":747,"column":16,"offset":33663},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the MQTT will only be triggered once in 5 seconds, nevertheless more detections occurred.","position":{"start":{"line":748,"column":1,"offset":33664},"end":{"line":748,"column":187,"offset":33850},"indent":[]}}],"position":{"start":{"line":748,"column":1,"offset":33664},"end":{"line":748,"column":187,"offset":33850},"indent":[]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Output","position":{"start":{"line":750,"column":7,"offset":33858},"end":{"line":750,"column":13,"offset":33864},"indent":[]}}],"position":{"start":{"line":750,"column":1,"offset":33852},"end":{"line":750,"column":13,"offset":33864},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A JSON object is published to the topic of the MQTT broker you have configured.","position":{"start":{"line":751,"column":1,"offset":33865},"end":{"line":751,"column":80,"offset":33944},"indent":[]}}],"position":{"start":{"line":751,"column":1,"offset":33865},"end":{"line":751,"column":80,"offset":33944},"indent":[]}},{"type":"code","lang":"json","meta":null,"value":"[\n 'regionCoordinates' : [618, 317, 703, 493],\n 'numberOfChanges' : 5446,\n 'timestamp' : '1465894497',\n 'microseconds' : '5-97451',\n 'token' : 695,\n 'pathToImage' : '1465894497_5-97451_frontdoor_618-317-703-493_5446_695.jpg',\n 'instanceName' : 'frontdoor',\n]","position":{"start":{"line":753,"column":1,"offset":33946},"end":{"line":763,"column":4,"offset":34223},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":5,"children":[{"type":"text","value":"Example","position":{"start":{"line":765,"column":7,"offset":34231},"end":{"line":765,"column":14,"offset":34238},"indent":[]}}],"position":{"start":{"line":765,"column":1,"offset":34225},"end":{"line":765,"column":14,"offset":34238},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"It is possible to subscribe multiple distributed IoT devices to the same MQTT topic and perform specific actions upon the detection of a motion. Devices with more resources could fetch the image to perform further elaboration.","position":{"start":{"line":766,"column":1,"offset":34239},"end":{"line":766,"column":227,"offset":34465},"indent":[]}}],"position":{"start":{"line":766,"column":1,"offset":34239},"end":{"line":766,"column":227,"offset":34465},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Streaming","position":{"start":{"line":768,"column":4,"offset":34470},"end":{"line":768,"column":13,"offset":34479},"indent":[]}}],"position":{"start":{"line":768,"column":1,"offset":34467},"end":{"line":768,"column":13,"offset":34479},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The machinery has the ability to stream your capture device as a MJPG stream.","position":{"start":{"line":770,"column":1,"offset":34481},"end":{"line":770,"column":78,"offset":34558},"indent":[]}}],"position":{"start":{"line":770,"column":1,"offset":34481},"end":{"line":770,"column":78,"offset":34558},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Parameters","position":{"start":{"line":772,"column":5,"offset":34564},"end":{"line":772,"column":15,"offset":34574},"indent":[]}}],"position":{"start":{"line":772,"column":1,"offset":34560},"end":{"line":772,"column":15,"offset":34574},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The parameters for the supported streaming protocols can be found in the ","position":{"start":{"line":774,"column":1,"offset":34576},"end":{"line":774,"column":74,"offset":34649},"indent":[]}},{"type":"inlineCode","value":"config/stream.xml","position":{"start":{"line":774,"column":74,"offset":34649},"end":{"line":774,"column":93,"offset":34668},"indent":[]}},{"type":"text","value":" file, but you can also use the web to modify the parameters. Below you see a default configuration file; at the moment of writing only a MJPG stream is supported.","position":{"start":{"line":774,"column":93,"offset":34668},"end":{"line":774,"column":256,"offset":34831},"indent":[]}}],"position":{"start":{"line":774,"column":1,"offset":34576},"end":{"line":774,"column":256,"offset":34831},"indent":[]}},{"type":"code","lang":"xml","meta":null,"value":"\n\t\n \ttrue\n \t8889\n \t75\n \t\n \t75\n \n","position":{"start":{"line":776,"column":1,"offset":34833},"end":{"line":786,"column":4,"offset":35099},"indent":[1,1,1,1,1,1,1,1,1,1]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Enabled","position":{"start":{"line":788,"column":6,"offset":35106},"end":{"line":788,"column":13,"offset":35113},"indent":[]}}],"position":{"start":{"line":788,"column":1,"offset":35101},"end":{"line":788,"column":13,"offset":35113},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A boolean which turns ON/OFF the stream. This is interesting when working with IP cameras, where you already have an RTSP/MJPG stream from the camera itself.","position":{"start":{"line":790,"column":1,"offset":35115},"end":{"line":790,"column":158,"offset":35272},"indent":[]}}],"position":{"start":{"line":790,"column":1,"offset":35115},"end":{"line":790,"column":158,"offset":35272},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Stream Port","position":{"start":{"line":792,"column":6,"offset":35279},"end":{"line":792,"column":17,"offset":35290},"indent":[]}}],"position":{"start":{"line":792,"column":1,"offset":35274},"end":{"line":792,"column":17,"offset":35290},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The port on which the stream is available.","position":{"start":{"line":794,"column":1,"offset":35292},"end":{"line":794,"column":43,"offset":35334},"indent":[]}}],"position":{"start":{"line":794,"column":1,"offset":35292},"end":{"line":794,"column":43,"offset":35334},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Quality","position":{"start":{"line":796,"column":6,"offset":35341},"end":{"line":796,"column":13,"offset":35348},"indent":[]}}],"position":{"start":{"line":796,"column":1,"offset":35336},"end":{"line":796,"column":13,"offset":35348},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The quality is a value between ","position":{"start":{"line":798,"column":1,"offset":35350},"end":{"line":798,"column":32,"offset":35381},"indent":[]}},{"type":"linkReference","identifier":"0-100","label":"0-100","referenceType":"shortcut","children":[{"type":"text","value":"0-100","position":{"start":{"line":798,"column":33,"offset":35382},"end":{"line":798,"column":38,"offset":35387},"indent":[]}}],"position":{"start":{"line":798,"column":32,"offset":35381},"end":{"line":798,"column":39,"offset":35388},"indent":[]}},{"type":"text","value":". The lower the quality, the more the image will be compressed. If you're using the RaspberryPi Camera module, this option will be ignored.","position":{"start":{"line":798,"column":39,"offset":35388},"end":{"line":798,"column":178,"offset":35527},"indent":[]}}],"position":{"start":{"line":798,"column":1,"offset":35350},"end":{"line":798,"column":178,"offset":35527},"indent":[]}},{"type":"heading","depth":4,"children":[{"type":"text","value":"Username/password","position":{"start":{"line":800,"column":6,"offset":35534},"end":{"line":800,"column":23,"offset":35551},"indent":[]}}],"position":{"start":{"line":800,"column":1,"offset":35529},"end":{"line":800,"column":23,"offset":35551},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You can secure the MJPEG streaming with a username and password. These credentials will be used to authorize your requests using Basic Authentication. Please note that once enabled, the live stream on the dashboard page can fail; however it will work if you open it directly in your browser or ip camera client. The format of the streaming url, after authentication enabled, will look as following:","position":{"start":{"line":802,"column":1,"offset":35553},"end":{"line":802,"column":399,"offset":35951},"indent":[]}}],"position":{"start":{"line":802,"column":1,"offset":35553},"end":{"line":802,"column":399,"offset":35951},"indent":[]}},{"type":"code","lang":"ts","meta":null,"value":"http://username:password@ip-camera:8899","position":{"start":{"line":804,"column":1,"offset":35953},"end":{"line":806,"column":4,"offset":36002},"indent":[1,1]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":809,"column":1,"offset":36005},"end":{"line":809,"column":31,"offset":36035},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":809,"column":31,"offset":36035}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nimport { Playground, Props } from 'docz'\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n\n

{`Machinery`}

\n

{`The machinery is the processing engine of Kerberos Open Source. It's an image processing framework, written in C++, who benefits from other third party libraries (OpenCV, etc). It takes images from the type of camera (USB-, IP- or RPi-camera) you've configured in the configuration files and executes one ore more algorithms and post-processes (e.g. save a snapshot). The configuration files allow you to define the type of camera, post-processes, conditions and much more; it's highly configurable. It's important to note that the machinery, out-of-the-box, can handle only one camera at a time.`}

\n

{`Project structure`}

\n

{`The machinery is an image processing framework which is devided into four steps:`}

\n
    \n
  • {`condition`}
    • \n
  • {`algorithm`}
    • \n
  • {`expositor`}
    • \n
  • {`heuristic`}
    • \n
\n

{`The steps belong to a four passway; illustrated on the image below. In each cycle a sequence of images is processed. Each step will process the sequence, and will return some result to the next step. For example: an algorithm will process the images and returns an array to the Expositor, which contains boolean values. The steps are loosly coupled, so they have simple conventions, just like the example before.`}

\n

{`Thanks to the loosly coupling, each step can be developed indepently. So algorithms, expositors, heuristics and conditions can be switched on the fly. This makes it easier for other developers who want to contribute to the machinery. They can create a new algorithm without knowing how a specific expositor or heuristic works. They just need to be aware of the convention an algorithm should meet.`}

\n

\"machinery

\n

{`These different steps can be configured by editing a couple of configurationn files located at `}{`config/`}{`. The main configuration file `}{`config/config.xml`}{` looks like this:`}

\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    `}{`<`}{`name`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`frontdoor`}{`{`name`}{`>`}{`\n`}{`    `}{`<`}{`logging`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`logging`}{`>`}{`\n`}{`    `}{`<`}{`timezone`}{` `}{`type`}{`=`}{`\"timezone\"`}{`>`}{`Europe-Brussels`}{`{`timezone`}{`>`}{`\n`}{`    `}{`<`}{`capture`}{` `}{`file`}{`=`}{`\"capture.xml\"`}{`>`}{`RaspiCamera`}{`{`capture`}{`>`}{`\n`}{`    `}{`<`}{`stream`}{` `}{`file`}{`=`}{`\"stream.xml\"`}{`>`}{`Mjpg`}{`{`stream`}{`>`}{`\n`}{`    `}{`<`}{`condition`}{` `}{`file`}{`=`}{`\"condition.xml\"`}{` `}{`type`}{`=`}{`\"multiple\"`}{`>`}{`Enabled`}{`{`condition`}{`>`}{`\n`}{`    `}{`<`}{`algorithm`}{` `}{`file`}{`=`}{`\"algorithm.xml\"`}{`>`}{`DifferentialCollins`}{`{`algorithm`}{`>`}{`\n`}{`    `}{`<`}{`expositor`}{` `}{`file`}{`=`}{`\"expositor.xml\"`}{`>`}{`Hull`}{`{`expositor`}{`>`}{`\n`}{`    `}{`<`}{`heuristic`}{` `}{`file`}{`=`}{`\"heuristic.xml\"`}{`>`}{`Sequence`}{`{`heuristic`}{`>`}{`\n`}{`    `}{`<`}{`io`}{` `}{`file`}{`=`}{`\"io.xml\"`}{` `}{`type`}{`=`}{`\"multiple\"`}{`>`}{`Video`}{`{`io`}{`>`}{`\n`}{`    `}{`<`}{`cloud`}{` `}{`file`}{`=`}{`\"cloud.xml\"`}{`>`}{`S3`}{`{`cloud`}{`>`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`Capture`}

\n

{`You can choose which capture device you will be using, you can use your old USB webcam, the popular Raspberry Pi camera or a state-of-the-art IP camera. The capture device will take pictures and deliver them to the algorithm if the conditions (the first step of the four passway) are valid.`}

\n

{`You can change the capture device by changing the `}{`config/config.xml`}{` file, and choose one of the following:`}

\n
    \n
  • {`USBCamera`}
    • \n
  • {`RaspiCamera`}
    • \n
  • {`IPCamera`}
    • \n
\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    ...`}{`\n`}{`    `}{`<`}{`capture`}{` `}{`file`}{`=`}{`\"capture.xml\"`}{`>`}{`RaspiCamera`}{`{`capture`}{`>`}{`\n`}{`    ...`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`USB camera`}

\n

{`The machinery supports a whole range of USB cameras. You will find a complete list here. Make sure you have updated the web interface, to make the machinery aware you will be using an USB camera.`}

\n

{`Parameters`}

\n

{`The parameters of the USB camera can be found in the `}{`config/capture.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`captures`}{`>`}{`\n`}{`  `}{`<`}{`USBCamera`}{`>`}{`\n`}{`    `}{`<`}{`frameWidth`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1280`}{`{`frameWidth`}{`>`}{`\n`}{`    `}{`<`}{`frameHeight`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`720`}{`{`frameHeight`}{`>`}{`\n`}{`    `}{`<`}{`deviceNumber`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`deviceNumber`}{`>`}{`\n`}{`    `}{`<`}{`delay`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`delay`}{`>`}{`\n`}{`    `}{`<`}{`angle`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`angle`}{`>`}{`\n`}{`  `}{`{`USBCamera`}{`>`}{`\n`}{`{`captures`}{`>`}
\n
{`Framewidth and -height`}
\n

{`You can set the resolution of the capture device, make sure the resolution you've defined is valid with your camera. Please check the specs of the USB camera you're using.`}

\n
{`Device number`}
\n

{`If more than one device is connected, you can specify the index of the USB-camera. The index is an integer (1-5).`}

\n
{`Delay`}
\n

{`You can provide a delay/interval (milliseconds) between two captures.`}

\n
{`Angle`}
\n

{`By defining an angle (degrees), you can rotate the images taken by the capture device. For example if you would mount the camera upside down, than you could enter the value 180 as the angle; this will flip the images.`}

\n

{`Raspberry Pi Camera Module`}

\n

{`You can use the Raspberry Pi Camera Module with the machinery. You just need to attach the camera module and you're ready to go. The Raspberry Pi Camera Module is enabled by default in the web.`}

\n

{`Parameters`}

\n

{`The parameters of the Raspberry Pi Camera Module can be found in the config/capture.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`captures`}{`>`}{`\n`}{`  `}{`<`}{`RaspiCamera`}{`>`}{`\n`}{`    `}{`<`}{`frameWidth`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`640`}{`{`frameWidth`}{`>`}{`\n`}{`    `}{`<`}{`frameHeight`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`480`}{`{`frameHeight`}{`>`}{`\n`}{`    `}{`<`}{`delay`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1400`}{`{`delay`}{`>`}{`\n`}{`    `}{`<`}{`angle`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`angle`}{`>`}{`\n`}{`    `}{`<`}{`framerate`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`30`}{`{`framerate`}{`>`}{`\n`}{`    `}{`<`}{`sharpness`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`sharpness`}{`>`}{`\n`}{`    `}{`<`}{`saturation`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`saturation`}{`>`}{`\n`}{`    `}{`<`}{`contrast`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`contrast`}{`>`}{`\n`}{`    `}{`<`}{`brightness`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`50`}{`{`brightness`}{`>`}{`\n`}{`  `}{`{`RaspiCamera`}{`>`}{`\n`}{`{`captures`}{`>`}
\n
{`Framewidth and -height`}
\n

{`You can set the resolution of the camera module, make sure the resolution you've defined is valid.`}

\n
{`Delay`}
\n

{`You can provide a delay/interval (milliseconds) between two captures.`}

\n
{`Angle`}
\n

{`By defining an angle (degrees), you can rotate the images taken by the capture device. For example if you would mount the camera upside down, than you could enter the value 180 as the angle; this will flip the images.`}

\n
{`Framerate`}
\n

{`The number of frames captures per second. Please note that this parameter will also be used if you're recording video. E.g. if you set this parameter to 20, you're recorded videos will also be 20 FPS.`}

\n
{`Sharpness, saturation, contrast, brightness`}
\n

{`Camera properties which you can specify to tune the settings to your needs.`}

\n

{`IP camera`}

\n

{`The machinery can be used with any IP camera, that provides a RTSP (or MJPEG) stream. Make sure that you know the correct URL of your IP camera, you can `}{`find a list here`}{`.`}

\n

{`Parameters`}

\n

{`The parameters of the IP capture device can be found in the `}{`config/capture.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`captures`}{`>`}{`\n`}{`  `}{`<`}{`IPCamera`}{`>`}{`\n`}{`    `}{`<`}{`url`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`http://username:password@ipaddress/image.jpg`}{`{`url`}{`>`}{`\n`}{`    `}{`<`}{`frameWidth`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`800`}{`{`frameWidth`}{`>`}{`\n`}{`    `}{`<`}{`frameHeight`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`640`}{`{`frameHeight`}{`>`}{`\n`}{`    `}{`<`}{`delay`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`delay`}{`>`}{`\n`}{`    `}{`<`}{`angle`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`angle`}{`>`}{`\n`}{`  `}{`{`IPCamera`}{`>`}{`\n`}{`{`captures`}{`>`}
\n
{`URL`}
\n

{`To use your IP camera, you should provide a valid RTSP (or MJPEG) URL. The machinery will take snapshots from this stream.`}

\n
{`Framewidth and -height`}
\n

{`You can set the resolution of the capture device, make sure the resolution you've defined is equal to the resolution you've defined in your IP-camera software.`}

\n
{`Delay`}
\n

{`You can provide a delay/interval (milliseconds) between two captures.`}

\n
{`Angle`}
\n

{`By defining an angle (degrees), you can rotate the images taken by the capture device. For example if you would mount the camera upside down, than you could enter the value 180 as the angle; this will flip the images.`}

\n

{`Condition`}

\n

{`The condition is the first step of the four passway. In this step the machinery will determine if it's allowed to proceed to the next step. For example a condition can be a time constraint, a brightness threshold, etc; multiple conditions can be selected.`}

\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    ...`}{`\n`}{`    `}{`<`}{`condition`}{` `}{`file`}{`=`}{`\"condition.xml\"`}{` `}{`type`}{`=`}{`\"multiple\"`}{`>`}{`Enabled`}{`{`condition`}{`>`}{`\n`}{`    ...`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`Enabled`}

\n

{`It can be helpful to enable or disable the machinery at specific times. Therefore the time condition makes it possible to select a time range for each day of the week. When the current time is within the time range, the machinery will be enabled.`}

\n

{`Parameters`}

\n

{`The parameters of the Enabled condition can be found in the `}{`config/condition.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`conditions`}{`>`}{`\n`}{`  `}{`<`}{`Enabled`}{`>`}{`\n`}{`    `}{`<`}{`active`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`true`}{`{`active`}{`>`}{`\n`}{`    `}{`<`}{`delay`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`5000`}{`{`delay`}{`>`}{`\n`}{`  `}{`{`Enabled`}{`>`}{`\n`}{`{`conditions`}{`>`}
\n
{`Active`}
\n

{`The active field is boolean value (true/false). When the active field is true, the machinery is enabled, if not it's disabled.`}

\n
{`Delay`}
\n

{`The delay value is used when the condition failed, so when the current time isn't in the selected time range for that day. In that case the machinery will idle for the specified delay time. The value of the delay is expressed in miliseconds.`}

\n

{`Time`}

\n

{`It can be helpful to enable or disable the machinery at specific times. Therefore the time condition makes it possible to select a time range for each day of the week. When the current time is within the time range, the machinery will be enabled.`}

\n

{`Parameters`}

\n

{`The parameters of the Time condition can be found in the `}{`config/condition.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`conditions`}{`>`}{`\n`}{`  `}{`<`}{`Time`}{`>`}{`\n`}{`    `}{`<`}{`times`}{` `}{`type`}{`=`}{`\"timeselection\"`}{`>`}{`13:00,15:00-0:01,20:58-0:01,20:59-0:01,19:20-0:01,21:59-0,0-0,0`}{`{`times`}{`>`}{`\n`}{`    `}{`<`}{`delay`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`10000`}{`{`delay`}{`>`}{`\n`}{`  `}{`{`Time`}{`>`}{`\n`}{`{`conditions`}{`>`}
\n
{`Times`}
\n

{`The times property contains a list of times, delimited by a \"-\". The first item in the list will specify the time range for the first day of the week (Monday), the last item for the last day of the week (Sunday). The begin- and end-time, for a specific day, are delimited by a \",\" where the first element will specify that start time and the second one specifies the end time.`}

\n
{`Delay`}
\n

{`The delay value is used when the condition failed, so when the current time isn't in the selected time range for that day. In that case the machinery will idle for the specified delay time. The value of the delay is expressed in miliseconds.`}

\n

{`Algorithm`}

\n

{`The algorithm is the second step of the four passway. An algorithm will execute some kind of function on a sequence of images, and end up with a black and white image; just like the image below. An example of an algorithm would be one that does motion detection or one that would detect cats or dogs (using TensorFlow, ar any other Deep Learning framework).`}

\n

\"machinery

\n

{`The white pixels on the image will indicate the object of interest. For example, when looking for motion, the pixels that have been changed; it depends on what the algorithm is looking for. The black pixels are background pixels.`}

\n

{`The only convention that an algorithm should meet is that it should return a black and white image to the next step; the expositor. And of course that it requires a sequence of images as a parameter. Besides those conventions, an algorithm can do everything it wants to do. So you could create your own cat detection algorithm, marker detection, etc.`}

\n

{`You can select the algortihm in the `}{`config/config.xml`}{`.`}

\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    ...`}{`\n`}{`    `}{`<`}{`algorithm`}{` `}{`file`}{`=`}{`\"algorithm.xml\"`}{`>`}{`DifferentialCollins`}{`{`algorithm`}{`>`}{`\n`}{`    ...`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`Differential images`}

\n

{`This algorithm is a very simple method to detect motion; in terms of understanding but also processing. Just like the name says, it's the result of comparing images. When the images are compared, we know the pixels that have been changed and if the amount of pixels that changed is big enough, one can say that something happened and thus motion was detected.`}

\n

{`To get a more technical explanation: the algoritm will substract 2 or more images, and once that is done it will end up with a black and white image. The white pixels will mark the pixels that where different/changed and the black pixels are the pixels that have not changed; background pixels. Please note that there are several different combinations of substracting images. However for the machinery, we will use the method of Collins et al. as this method erases the phenomenon \"ghosting\".`}

\n

\"machinery

\n

{`In the image above the method of Collins et al. is illustrated. For this method we will process three images. The images are a sequence (from left to right), so the first (A) image was taken before the second (B) one, and the second (B) before the third (C) one. Next we will do a first comparision (C-B) of the third (C) image and the second (B) image, and after that we will do a second comparison (C-A) of the third (C) image and first (A) image.`}

\n

{`After the comparison we will end up with two difference images (C-B) and (C-A); both will mark the white pixels as changed pixels and black as non-changed pixels. To finish the algorithm we will do a logical AND-operation of the two difference images; this will give us the final black and white image ((C-B)&&(C-A)).`}

\n

{`The main idea of the Colins et al. method, is that it will erase \"ghosting\". In the last step we are doing a logical AND-operation, by doing this we will only keep the pixels, that changed in the first two images; therefore we can elimante false positives.`}

\n

{`Parameters`}

\n

{`The parameters of the Differential images algorithm can be found in the config/algorithm.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`algorithms`}{`>`}{`\n`}{`  `}{`<`}{`DifferentialCollins`}{`>`}{`\n`}{`    `}{`<`}{`erode`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`5`}{`{`erode`}{`>`}{`\n`}{`    `}{`<`}{`threshold`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`20`}{`{`threshold`}{`>`}{`\n`}{`  `}{`{`DifferentialCollins`}{`>`}{`\n`}{`{`algorithms`}{`>`}
\n
{`Erode`}
\n

{`The erode parameter represents a structural element (a morphological operation), which will be used to minimize the changed pixels; more information about eroding can be found here. The idea of the eroding is that pixels which are isolated will be removed; this means that when only one pixel changed, that pixel will reverted to the non-changed state. But for example when a large change happens and a lot of adjacent pixels are changed, the eroding will not be able to revert them.`}

\n

{`The higher the number of the erode parameter, the more aggressive the eroding will be. So high erode values, will make it possible that also large changes will be reverted to the non-changed state.`}

\n
{`Threshold`}
\n

{`When doing the comparison of two images, we won't end up with a clean black and white image. In most of the cases the values will be between 0 and 255; so gray values. This means that the value 0 will mean that both pixels where the same in both image, and values 255 mean that both pixels where totally different in both images. Of course we will also have values between 0-255, so pixels that are a little bit different in both images. So to make the resulting black and white image, we will need to apply a threshold value.`}

\n

{`The threshold will specify how much a pixel has to be different in the two images. So for example when the threshold is 30, it means that the difference between two pixels has to be equal or more then 30. The higher the threshold the more the pixel needs to be different, to be marked as changed.`}

\n

{`Expositor`}

\n

{`After the algorithm is executed, the expositor will determine, a region, where the changes were detected. An expositor can constrain a region in terms of selecting a hull or defining a rectangle.`}

\n

{`An expositor receives a black and white image as parameter and should modify a JSON object with all the information it processed. The JSON object must include: the bounding rectangle(s) of the positions where the pixels of interest are located and the number of pixels of interest. But can also include other optional parameters.`}

\n

{`You can change the expositor by changing the `}{`config/config.xml`}{` file, and choose one of the following:`}

\n
    \n
  • {`Hull`}
    • \n
  • {`Rectangle`}
    • \n
\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    ...`}{`\n`}{`    `}{`<`}{`expositor`}{` `}{`file`}{`=`}{`\"expositor.xml\"`}{`>`}{`Hull`}{`{`expositor`}{`>`}{`\n`}{`    ...`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`Rectangle`}

\n

{`This is a trivial expositor. A rectangle region can be defined to constrain the locations of pixels of interest. The rectangle repositor will return the region of the pixels of interest.`}

\n

{`Parameters`}

\n

{`The parameters of the rectangle expositor can be found in the config/expositor.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`expositors`}{`>`}{`\n`}{`  `}{`<`}{`Rectangle`}{`>`}{`\n`}{`    `}{`<`}{`region`}{`>`}{`\n`}{`      `}{`<`}{`x1`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`x1`}{`>`}{`\n`}{`      `}{`<`}{`y1`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`y1`}{`>`}{`\n`}{`      `}{`<`}{`x2`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1280`}{`{`x2`}{`>`}{`\n`}{`      `}{`<`}{`y2`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`720`}{`{`y2`}{`>`}{`\n`}{`    `}{`{`region`}{`>`}{`\n`}{`  `}{`{`Rectangle`}{`>`}{`\n`}{`{`expositors`}{`>`}
\n
{`Region`}
\n

{`The region parameter contains 4 values; x1, y1, x2 and y2 respectively. The values x1 and y1 indicate the x- and y-coordinate of the left upper starting point. The values x2 and y2 are the bottom right coordinates. A virtual rectangle will be drawn from (x1,y1) to (x2,y2). Pixels of interest that lie within this rectangle are valid pixels; if not they are invalid.`}

\n

{`Hull`}

\n

{`This hull is a more complex expositor than the rectangle. A hull can be selected with the web, you can select one or more coordinates to create a flexible region. The coordinates can be adjusted afterwards and be removed by double clicking on the coordinate. You can expand the hull by removing the start coordinate, which is marked by the white bullet.`}

\n

\"machinery

\n

{`Parameters`}

\n

{`The parameters of the hull expositor can be found in the config/expositor.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`expositors`}{`>`}{`\n`}{`  `}{`<`}{`Hull`}{`>`}{`\n`}{`    `}{`<`}{`region`}{` `}{`type`}{`=`}{`\"hullselection\"`}{`>`}{`347,361|627,266|975,328|1091,328|1148,413|1158,516|1121,534|962,567|699,648|531,700|243,613|423,550|665,453|850,470|666,361|467,385|325,460|165,372`}{`{`region`}{`>`}{`\n`}{`  `}{`{`Hull`}{`>`}{`\n`}{`{`expositors`}{`>`}
\n
{`Region`}
\n

{`The region parameter contains n values. Each value represents a coordinate (x,y) and are seperated by the \"|\" delimiter. These coordinates are used to calculate the concave hull. Pixels of interest that lie within the concave hull are valid pixels; if not they are invalid.`}

\n

{`Heuristic`}

\n

{`The heuristic is the last step in the four passway which will decide if the detection is valid or not. It will do this by using information from the previous steps (the expositor and the algorithm); e.g. number of changed pixels.`}

\n

{`You can change the heuristic by changing the `}{`config/config.xml`}{` file, and choose one of the following:`}

\n
    \n
  • {`Sequence`}
    • \n
\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    ...`}{`\n`}{`    `}{`<`}{`heuristic`}{` `}{`file`}{`=`}{`\"heuristic.xml\"`}{`>`}{`Sequence`}{`{`heuristic`}{`>`}{`\n`}{`    ...`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`Sequence`}

\n

{`This is a trivial heuristic. The sequence heuristic will store a single integer in memory, that will count the numbers of valid detections. When the heuristic will detect a false detection, it will decrease the count. The sequence heuristic will return true, if a threshold is reached; for example when something was detected three times in a row.`}

\n

{`Parameters`}

\n

{`The parameters of the Sequence heuristic can be found in the config/heuristic.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`heuristics`}{`>`}{`\n`}{`<`}{`Sequence`}{`>`}{`\n`}{`    `}{`<`}{`minimumChanges`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1`}{`{`minimumChanges`}{`>`}{`\n`}{`    `}{`<`}{`minimumDuration`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1`}{`{`minimumDuration`}{`>`}{`\n`}{`    `}{`<`}{`noMotionDelayTime`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`2000`}{`{`noMotionDelayTime`}{`>`}{`\n`}{`  `}{`{`Sequence`}{`>`}{`\n`}{`{`heuristics`}{`>`}
\n
{`Minimum changes`}
\n

{`The heuristic will only return true if enough changes have been detected. The minimum of changes indicates the minimum number of pixels that have to been changed, to be a valid detection.`}

\n
{`Minimum durations`}
\n

{`The minimum number of detections in a row to be a valid detection.`}

\n
{`No motion delay time`}
\n

{`When the heuristic failed, due to not enough pixels changed or not x detections in a row, the heuristic will idle for some time.`}

\n

{`Output`}

\n

{`If the heuristic determined that the evaluation was valid, one or more output operations can be executed. You configure which ooutput operations that will be executed, by modifying the configuration file or using the web interface.`}

\n 
{`{`xml`}{` version`}{`=`}{`\"1.0\"`}{`?>`}{`\n`}{`<`}{`kerberos`}{`>`}{`\n`}{`  `}{`<`}{`instance`}{`>`}{`\n`}{`    ...`}{`\n`}{`    `}{`<`}{`io`}{` `}{`file`}{`=`}{`\"io.xml\"`}{` `}{`type`}{`=`}{`\"multiple\"`}{`>`}{`Video`}{`{`io`}{`>`}{`\n`}{`    ...`}{`\n`}{`  `}{`{`instance`}{`>`}{`\n`}{`{`kerberos`}{`>`}
\n

{`You can choose which output devices you will be using. If you select multiple outputs, seperate them with an `}{`,`}{`. You can change the output device by changing the `}{`config/config.xml`}{` file, and choose one of the following:`}

\n
    \n
  • {`Disk`}
    • \n
  • {`Video`}
    • \n
  • {`GPIO`}
    • \n
  • {`TCPSocket`}
    • \n
  • {`Webhook`}
    • \n
  • {`MQTT`}
    • \n
  • {`Script`}
    • \n
\n

{`Disk`}

\n

{`An image can be saved to disk.`}

\n

{`Parameters`}

\n

{`The parameters of the Disk output device can be found in the `}{`config/io.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`>`}{`\n`}{`  `}{`<`}{`Disk`}{`>`}{`\n`}{`    `}{`<`}{`fileFormat`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`timestamp_microseconds_instanceName_regionCoordinates_numberOfChanges_token.jpg`}{`{`fileFormat`}{`>`}{`\n`}{`    `}{`<`}{`directory`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`/etc/opt/kerberosio/capture/`}{`{`directory`}{`>`}{`\n`}{`    `}{`<`}{`markWithTimestamp`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`markWithTimestamp`}{`>`}{`\n`}{`    `}{`<`}{`timestampColor`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`white`}{`{`timestampColor`}{`>`}{`\n`}{`    `}{`<`}{`privacy`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`privacy`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`Disk`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`File format`}
\n

{`The format that will be used for the name of the image. One or more variables can be defined and will be replaced by the machinery. Note that when you're using a variables name in the file format, that this name should be defined in the JSON object.`}

\n
{`Directory`}
\n

{`The directory where the image will be saved to. By default images are saved to the /etc/opt/kerberosio/capture directory.`}

\n
{`Mark with timestamp`}
\n

{`When this settings is set to true, the image is marked with a timestamp.`}

\n
{`Timestamp color`}
\n

{`A color can be defined for timestamp: white, black, red, green and blue.`}

\n
{`Privacy`}
\n

{`The privacy mode can be activated to remove some parts from the image. This especially helpful if you want to filter out public areas. When this option is enabled you will seee that after configuring the Hull expositor, you'll see that the pixels outside your region of interest (Hull) are made black.`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Disk will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n

{`Video`}

\n

{`When a valid event is detected, a video will be recorded for x seconds. When more valid events are detected, while a video is recording, the video file will further record for x seconds; so no new video file be recorded, but the existing one will be expanded.`}

\n

{`Parameters`}

\n

{`The parameters of the Video output device can be found in the `}{`config/io.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`>`}{`\n`}{`  `}{`<`}{`Video`}{`>`}{`\n`}{`    `}{`<`}{`fps`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`3`}{`{`fps`}{`>`}{`\n`}{`    `}{`<`}{`recordAfter`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`5`}{`{`recordAfter`}{`>`}{`\n`}{`    `}{`<`}{`maxDuration`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`120`}{`{`maxDuration`}{`>`}{`\n`}{`    `}{`<`}{`extension`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`mp4`}{`{`extension`}{`>`}{`\n`}{`    `}{`<`}{`codec`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`h264`}{`{`codec`}{`>`}{`\n`}{`    `}{`<`}{`fileFormat`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`timestamp_microseconds_instanceName_regionCoordinates_numberOfChanges_token`}{`{`fileFormat`}{`>`}{`\n`}{`    `}{`<`}{`directory`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`/etc/opt/kerberosio/capture/`}{`{`directory`}{`>`}{`\n`}{`    `}{`<`}{`hardwareDirectory`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`/etc/opt/kerberosio/h264/`}{`{`hardwareDirectory`}{`>`}{`\n`}{`    `}{`<`}{`enableHardwareEncoding`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`true`}{`{`enableHardwareEncoding`}{`>`}{`\n`}{`    `}{`<`}{`markWithTimestamp`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`markWithTimestamp`}{`>`}{`\n`}{`    `}{`<`}{`timestampColor`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`white`}{`{`timestampColor`}{`>`}{`\n`}{`    `}{`<`}{`privacy`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`privacy`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`Video`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`FPS`}
\n

{`The frames per second of the video being recorded. Please note that this number is limited and depends heavily on your hardware setup. You'll be receiving following warning in the systems logs, if the machinery can't write the desired FPS.`}

\n 
{`[trivial] IoVideo: framerate is too fast, can't record video at this speed (8/FPS)`}
\n
{`Record after`}
\n

{`The number of seconds recorded after the last valid event was detected. This means that when a video is already recording, and a valid event was detected, the video will be expanded with x more seconds.`}

\n
{`Extensions`}
\n

{`The extension or container of the video file. We highly recommend to use the MP4 container if you want cross-browser support. Leave this setting by default, if you don't know what you're doing.`}

\n
{`Codec`}
\n

{`The codec that is used to encode the video file.`}

\n
{`File format`}
\n

{`The format that will be used for the name of the image. One or more variables can be defined and will be replaced by the machinery. Note that when you're using a variables name in the file format, that this name should be defined in the JSON object.`}

\n
{`Directory`}
\n

{`The directory where the videos will be saved. By default videos are saved to the /etc/opt/kerberosio/capture directory.`}

\n
{`Hardware directory`}
\n

{`When using onboard hardware encoding (e.g. with Raspberry Pi camera), h264 video files are generated and stored in this directory. Afterwards these h264 files will be containerized to mp4 files, and stored in the Directory path.`}

\n
{`Enable Hardware encoding`}
\n

{`A boolean which can enable or disable hardware encoding. Please note that this option is enabled by default, but does not mean that it will work if you choose to use an USB camera.`}

\n
{`Mark with timestamp`}
\n

{`When this settings is set to true, the video is marked with a timestamp (similar to the Disk device).`}

\n
{`Timestamp color`}
\n

{`A color can be defined for timestamp: white, black, red, green and blue.`}

\n
{`Privacy`}
\n

{`The privacy mode can be activated to remove some parts from the video. This especially helpful if you want to filter out public areas.`}

\n
{`Video privacy`}
\n

{`After updating the configuration, you'll see that the pixels outside your region of interest (ROI) are made black; the image below illustrates this.`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Video will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n

{`TCP/IP client`}

\n

{`The TCP/IP client will send a TCP packet to a server.`}

\n

{`Parameters`}

\n

{`The parameters of the TCP/IP client can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`>`}{`\n`}{`  `}{`<`}{`TCPSocket`}{`>`}{`\n`}{`    `}{`<`}{`server`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`127.0.0.1`}{`{`server`}{`>`}{`\n`}{`    `}{`<`}{`port`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1337`}{`{`port`}{`>`}{`\n`}{`    `}{`<`}{`message`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`it's so fluffy`}{`{`message`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`TCPSocket`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`Server`}
\n

{`The IP of the TCP server.`}

\n
{`Port`}
\n

{`This is the port of the TCP server.`}

\n
{`Message`}
\n

{`You can send some data to a TCP server.`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the TCP will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n

{`GPIO`}

\n

{`A GPIO pin can be set as output device.`}

\n

{`Parameters`}

\n

{`The parameters of the GPIO pin can be found in the `}{`config/io.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`>`}{`\n`}{`  `}{`<`}{`GPIO`}{`>`}{`\n`}{`    `}{`<`}{`pin`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`17`}{`{`pin`}{`>`}{`\n`}{`    `}{`<`}{`periods`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`5`}{`{`periods`}{`>`}{`\n`}{`    `}{`<`}{`periodTime`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`100000`}{`{`periodTime`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`GPIO`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`Pin`}
\n

{`The pin that will be triggered.`}

\n
{`Periods`}
\n

{`The number of times the pin will be triggered.`}

\n
{`Period time`}
\n

{`The time in microseconds that the pin will be set high.`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the GPIO will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n

{`Webhook`}

\n

{`Detailed information (a JSON object) is send as a POST request to a webhook. The JSON object contains the number of changes, the region, the URL of the image, etc. This is useful if you want to integrate with your own application.`}

\n

{`Make sure that the Webhook comes after the Disk device, otherwise the URL of the image is not included.`}

\n

{`Parameters`}

\n

{`The parameters of the webhook can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`>`}{`\n`}{`  `}{`<`}{`Webhook`}{`>`}{`\n`}{`    `}{`<`}{`url`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`http://kerberos.web/api/v1/webhook`}{`{`url`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`Webhook`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`Url`}
\n

{`This is the URL, to which the machinery will send a JSON object (as a POST request).`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Webhook will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n
{`Output`}
\n

{`A JSON object is POSTed to the url you've defined.`}

\n 
{`[`}{`\n`}{`  `}{`'regionCoordinates'`}{` `}{`:`}{` [`}{`618`}{`, `}{`317`}{`, `}{`703`}{`, `}{`493`}{`],`}{`\n`}{`  `}{`'numberOfChanges'`}{` `}{`:`}{` `}{`5446`}{`,`}{`\n`}{`  `}{`'timestamp'`}{` `}{`:`}{` `}{`'`}{`1465894497`}{`'`}{`,`}{`\n`}{`  `}{`'microseconds'`}{` `}{`:`}{` `}{`'`}{`5-97451`}{`'`}{`,`}{`\n`}{`  `}{`'token'`}{` `}{`:`}{` `}{`695`}{`,`}{`\n`}{`  `}{`'pathToImage'`}{` `}{`:`}{` `}{`'`}{`1465894497`}{`_`}{`5-97451`}{`_frontdoor_`}{`618-317-703-493`}{`_`}{`5446`}{`_`}{`695`}{`.jpg'`}{`,`}{`\n`}{`  `}{`'instanceName'`}{` `}{`:`}{` `}{`'frontdoor'`}{`,`}{`\n`}{`]`}
\n

{`Script`}

\n

{`A bash script can be executed after a valid event was detected. A JSON object is send in the first parameter to the script you've defined.`}

\n

{`Parameters`}

\n

{`The parameters of the Script output device can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`>`}{`\n`}{`  `}{`<`}{`Script`}{`>`}{`\n`}{`    `}{`<`}{`path`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`/etc/opt/kerberosio/scripts/run.sh`}{`{`path`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`Script`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`Path`}
\n

{`The location of the script that will be executed on detection.`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the Script will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n
{`Example`}
\n

{`By default the script will point to /etc/opt/kerberosio/scripts/run.sh, which contains a template how you should start your script. Note that when using KiOS, this script will be read-only, copy it to the /data folder and change the path parameter.`}

\n 
{`#!/bin/bash`}{`\n`}{`# -------------------------------------------`}{`\n`}{`# This is an example script which illustrates`}{`\n`}{`# how to use the Script IO device.`}{`\n`}{`#`}{`\n`}{`# --------------------------------------`}{`\n`}{`# The first parameter is the JSON object`}{`\n`}{`#`}{`\n`}{`# e.g. {\"regionCoordinates\":[308,250,346,329],\"numberOfChanges\":194,\"timestamp\":\"1486049622\",\"microseconds\":\"6-161868\",\"token\":344,\"pathToImage\":\"1486049622_6-161868_frontdoor_308-250-346-329_194_344.jpg\",\"instanceName\":\"frontdoor\"}`}{`\n`}{`JSON=`}{`$`}{`1`}{`\n`}{`# -------------------------------------------`}{`\n`}{`# You can use python to parse the JSON object`}{`\n`}{`# and get the required fields`}{`\n`}{`name=`}{`$`}{`(echo `}{`$`}{`JSON | python -c `}{`\"import sys, json; print json.load(sys.stdin)['instanceName']\"`}{`)`}{`\n`}{`coordinates=`}{`$`}{`(echo `}{`$`}{`JSON | python -c `}{`\"import sys, json; print json.load(sys.stdin)['regionCoordinates']\"`}{`)`}{`\n`}{`changes=`}{`$`}{`(echo `}{`$`}{`JSON | pythfon -c `}{`\"import sys, json; print json.load(sys.stdin)['numberOfChanges']\"`}{`)`}{`\n`}{`image=`}{`$`}{`(echo `}{`$`}{`JSON | python -c `}{`\"import sys, json; print json.load(sys.stdin)['pathToImage']\"`}{`)`}{`\n`}{`The idea `}{`is`}{` that you can use Python `}{`in`}{` your bash script, to parse the JSON `}{`object`}{` send `}{`as`}{` first parameter. Afterwards you can do `}{`with`}{` the output what you want.`}
\n

{`MQTT`}

\n

{`MQTT protocol is a light-weight Machine to Machine (M2M) protocol widely used in Internet of things.\nDetailed information (a JSON object) is published to an MQTT topic. The JSON object contains the number of changes, the region, the URL of the image, etc.`}

\n

{`Parameters`}

\n

{`The parameters of the MQTT output can be found in the config/io.xml file, but you can also use the web to modify the parameters. Below you see a default configuration file.`}

\n 
{`<`}{`ios`}{`\n`}{`  {`>`}{`\n`}{`    `}{`<`}{`secure`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`secure`}{`>`}{`\n`}{`    `}{`<`}{`verifycn`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`false`}{`{`verifycn`}{`>`}{`\n`}{`    `}{`<`}{`server`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`127.0.0.1`}{`{`server`}{`>`}{`\n`}{`    `}{`<`}{`port`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`1883`}{`{`port`}{`>`}{`\n`}{`    `}{`<`}{`topic`}{` `}{`type`}{`=`}{`\"text\"`}{`>`}{`kios/mqtt`}{`{`topic`}{`>`}{`\n`}{`    `}{`<`}{`username`}{` `}{`type`}{`=`}{`\"text\"`}{`>{`username`}{`>`}{`\n`}{`    `}{`<`}{`password`}{` `}{`type`}{`=`}{`\"text\"`}{`>{`password`}{`>`}{`\n`}{`    `}{`<`}{`throttler`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`0`}{`{`throttler`}{`>`}{`\n`}{`  `}{`{`MQTT`}{`>`}{`\n`}{`{`ios`}{`>`}
\n
{`Secure`}
\n

{`If checked, enable SSL/TLS support. Please note that when SSL/TLS support is enabled, the server certificate issuer is verified against the CA (Certification Authority) files available in /etc/ssl/certs.`}

\n
{`Verifycn`}
\n

{`If checked, the MQTT server FQDN or ip address must match the CN (Common Name) of the server certificate.`}

\n
{`Server`}
\n

{`IP address or FQDN of the MQTT broker.`}

\n
{`Port`}
\n

{`TCP port of the MQTT broker.`}

\n
{`Topic`}
\n

{`The topic to publish to.`}

\n
{`Username`}
\n

{`The username for authenticating to the MQTT broker. This is only supported by brokers that implement the MQTT spec v3.1. If username is not set (empty), the password argument is ignored. This is only needed if the MQTT broker is configured for authentication.`}

\n
{`Password`}
\n

{`The password to use, together with the username, for authenticating to the MQTT broker. This is only supported by brokers that implement the MQTT spec v3.1. This is only needed if the MQTT broker is configured for authentication.`}

\n
{`Throttler`}
\n

{`Control the number of executions by setting a throttling value. E.g. if you set throttling to 5, the MQTT will only be triggered once in 5 seconds, nevertheless more detections occurred.`}

\n
{`Output`}
\n

{`A JSON object is published to the topic of the MQTT broker you have configured.`}

\n 
{`[`}{`\n`}{`  `}{`'regionCoordinates'`}{` `}{`:`}{` [`}{`618`}{`, `}{`317`}{`, `}{`703`}{`, `}{`493`}{`],`}{`\n`}{`  `}{`'numberOfChanges'`}{` `}{`:`}{` `}{`5446`}{`,`}{`\n`}{`  `}{`'timestamp'`}{` `}{`:`}{` `}{`'`}{`1465894497`}{`'`}{`,`}{`\n`}{`  `}{`'microseconds'`}{` `}{`:`}{` `}{`'`}{`5-97451`}{`'`}{`,`}{`\n`}{`  `}{`'token'`}{` `}{`:`}{` `}{`695`}{`,`}{`\n`}{`  `}{`'pathToImage'`}{` `}{`:`}{` `}{`'`}{`1465894497`}{`_`}{`5-97451`}{`_frontdoor_`}{`618-317-703-493`}{`_`}{`5446`}{`_`}{`695`}{`.jpg'`}{`,`}{`\n`}{`  `}{`'instanceName'`}{` `}{`:`}{` `}{`'frontdoor'`}{`,`}{`\n`}{`]`}
\n
{`Example`}
\n

{`It is possible to subscribe multiple distributed IoT devices to the same MQTT topic and perform specific actions upon the detection of a motion. Devices with more resources could fetch the image to perform further elaboration.`}

\n

{`Streaming`}

\n

{`The machinery has the ability to stream your capture device as a MJPG stream.`}

\n

{`Parameters`}

\n

{`The parameters for the supported streaming protocols can be found in the `}{`config/stream.xml`}{` file, but you can also use the web to modify the parameters. Below you see a default configuration file; at the moment of writing only a MJPG stream is supported.`}

\n 
{`<`}{`streams`}{`>`}{`\n`}{`\t`}{`<`}{`Mjpg`}{`>`}{`\n`}{`    \t`}{`<`}{`enabled`}{` `}{`type`}{`=`}{`\"bool\"`}{`>`}{`true`}{`{`enabled`}{`>`}{`\n`}{`    \t`}{`<`}{`streamPort`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`8889`}{`{`streamPort`}{`>`}{`\n`}{`    \t`}{`<`}{`quality`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`75`}{`{`quality`}{`>`}{`\n`}{`    \t`}{`<`}{`username`}{` `}{`type`}{`=`}{`\"number\"`}{`>{`username`}{`>`}{`\n`}{`    \t`}{`<`}{`password`}{` `}{`type`}{`=`}{`\"number\"`}{`>`}{`75`}{`{`password`}{`>`}{`\n`}{`    `}{`{`Mjpg`}{`>`}{`\n`}{`{`streams`}{`>`}
\n

{`Enabled`}

\n

{`A boolean which turns ON/OFF the stream. This is interesting when working with IP cameras, where you already have an RTSP/MJPG stream from the camera itself.`}

\n

{`Stream Port`}

\n

{`The port on which the stream is available.`}

\n

{`Quality`}

\n

{`The quality is a value between `}{`[0-100]`}{`. The lower the quality, the more the image will be compressed. If you're using the RaspberryPi Camera module, this option will be ignored.`}

\n

{`Username/password`}

\n

{`You can secure the MJPEG streaming with a username and password. These credentials will be used to authorize your requests using Basic Authentication. Please note that once enabled, the live stream on the dashboard page can fail; however it will work if you open it directly in your browser or ip camera client. The format of the streaming url, after authentication enabled, will look as following:`}

\n 
{`http:`}{`//username:password@ip-camera:8899`}
\n\n \n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-ea3b5483eecc15b3a91c3f82de233e3b.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-ea3b5483eecc15b3a91c3f82de233e3b.json new file mode 100644 index 0000000..7b1888a --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-ea3b5483eecc15b3a91c3f82de233e3b.json @@ -0,0 +1 @@ +{"expireTime":9007200861829507000,"key":"gatsby-plugin-mdx-entire-payload-896dd2fc123c29cc48d1f5b2dd83e020-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. These storage provider could be in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":641,"offset":1294},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":641,"offset":1294},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":20,"column":4,"offset":1299},"end":{"line":20,"column":18,"offset":1313},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1296},"end":{"line":20,"column":18,"offset":1313},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":22,"column":1,"offset":1315},"end":{"line":22,"column":291,"offset":1605},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":22,"column":292,"offset":1606},"end":{"line":22,"column":309,"offset":1623},"indent":[]}}],"position":{"start":{"line":22,"column":291,"offset":1605},"end":{"line":22,"column":318,"offset":1632},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":22,"column":318,"offset":1632},"end":{"line":22,"column":319,"offset":1633},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1315},"end":{"line":22,"column":319,"offset":1633},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":24,"column":1,"offset":1635},"end":{"line":24,"column":56,"offset":1690},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1635},"end":{"line":24,"column":56,"offset":1690},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":26,"column":4,"offset":1695},"end":{"line":26,"column":20,"offset":1711},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1692},"end":{"line":26,"column":20,"offset":1711},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":28,"column":1,"offset":1713},"end":{"line":28,"column":253,"offset":1965},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1713},"end":{"line":28,"column":253,"offset":1965},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":30,"column":6,"offset":1972},"end":{"line":30,"column":35,"offset":2001},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1971},"end":{"line":30,"column":70,"offset":2036},"indent":[]}}],"position":{"start":{"line":30,"column":5,"offset":1971},"end":{"line":30,"column":70,"offset":2036},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1967},"end":{"line":30,"column":70,"offset":2036},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":31,"column":6,"offset":2042},"end":{"line":31,"column":29,"offset":2065},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2041},"end":{"line":31,"column":83,"offset":2119},"indent":[]}}],"position":{"start":{"line":31,"column":5,"offset":2041},"end":{"line":31,"column":83,"offset":2119},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":2037},"end":{"line":31,"column":83,"offset":2119},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":32,"column":6,"offset":2125},"end":{"line":32,"column":28,"offset":2147},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2124},"end":{"line":32,"column":57,"offset":2176},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":2124},"end":{"line":32,"column":57,"offset":2176},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":2120},"end":{"line":32,"column":57,"offset":2176},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":33,"column":6,"offset":2182},"end":{"line":33,"column":11,"offset":2187},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2181},"end":{"line":33,"column":29,"offset":2205},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2181},"end":{"line":33,"column":29,"offset":2205},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2177},"end":{"line":33,"column":29,"offset":2205},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1967},"end":{"line":33,"column":29,"offset":2205},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":35,"column":1,"offset":2207},"end":{"line":35,"column":190,"offset":2396},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2207},"end":{"line":35,"column":190,"offset":2396},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":37,"column":1,"offset":2398},"end":{"line":37,"column":99,"offset":2496},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2398},"end":{"line":37,"column":99,"offset":2496},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":39,"column":1,"offset":2498},"end":{"line":39,"column":220,"offset":2717},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2498},"end":{"line":39,"column":220,"offset":2717},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":41,"column":1,"offset":2719},"end":{"line":41,"column":98,"offset":2816},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2719},"end":{"line":41,"column":98,"offset":2816},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":43,"column":5,"offset":2822},"end":{"line":43,"column":11,"offset":2828},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2818},"end":{"line":43,"column":11,"offset":2828},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":45,"column":1,"offset":2830},"end":{"line":45,"column":303,"offset":3132},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2830},"end":{"line":45,"column":303,"offset":3132},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":47,"column":6,"offset":3139},"end":{"line":47,"column":18,"offset":3151},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3138},"end":{"line":47,"column":46,"offset":3179},"indent":[]}}],"position":{"start":{"line":47,"column":5,"offset":3138},"end":{"line":47,"column":46,"offset":3179},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3134},"end":{"line":47,"column":46,"offset":3179},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":48,"column":6,"offset":3185},"end":{"line":48,"column":29,"offset":3208},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3184},"end":{"line":48,"column":59,"offset":3238},"indent":[]}}],"position":{"start":{"line":48,"column":5,"offset":3184},"end":{"line":48,"column":59,"offset":3238},"indent":[]}}],"position":{"start":{"line":48,"column":1,"offset":3180},"end":{"line":48,"column":59,"offset":3238},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3134},"end":{"line":48,"column":59,"offset":3238},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":50,"column":1,"offset":3240},"end":{"line":50,"column":368,"offset":3607},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3240},"end":{"line":50,"column":368,"offset":3607},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":52,"column":1,"offset":3609},"end":{"line":52,"column":66,"offset":3674},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3609},"end":{"line":52,"column":66,"offset":3674},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":54,"column":5,"offset":3680},"end":{"line":54,"column":21,"offset":3696},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3676},"end":{"line":54,"column":21,"offset":3696},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":56,"column":1,"offset":3698},"end":{"line":56,"column":237,"offset":3934},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3698},"end":{"line":56,"column":237,"offset":3934},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":58,"column":1,"offset":3936},"end":{"line":58,"column":105,"offset":4040},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3936},"end":{"line":58,"column":105,"offset":4040},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":60,"column":1,"offset":4042},"end":{"line":60,"column":45,"offset":4086},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":4042},"end":{"line":60,"column":45,"offset":4086},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":62,"column":3,"offset":4090},"end":{"line":62,"column":380,"offset":4467},"indent":[]}}],"position":{"start":{"line":62,"column":3,"offset":4090},"end":{"line":62,"column":380,"offset":4467},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4088},"end":{"line":63,"column":1,"offset":4468},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":64,"column":3,"offset":4471},"end":{"line":65,"column":49,"offset":4785},"indent":[2]}}],"position":{"start":{"line":64,"column":3,"offset":4471},"end":{"line":65,"column":49,"offset":4785},"indent":[2]}}],"position":{"start":{"line":64,"column":1,"offset":4469},"end":{"line":65,"column":49,"offset":4785},"indent":[1]}}],"position":{"start":{"line":62,"column":1,"offset":4088},"end":{"line":65,"column":49,"offset":4785},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":67,"column":5,"offset":4791},"end":{"line":67,"column":13,"offset":4799},"indent":[]}}],"position":{"start":{"line":67,"column":1,"offset":4787},"end":{"line":67,"column":13,"offset":4799},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":69,"column":1,"offset":4801},"end":{"line":69,"column":156,"offset":4956},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":69,"column":156,"offset":4956},"end":{"line":69,"column":177,"offset":4977},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":69,"column":177,"offset":4977},"end":{"line":69,"column":188,"offset":4988},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":69,"column":188,"offset":4988},"end":{"line":69,"column":193,"offset":4993},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":69,"column":193,"offset":4993},"end":{"line":69,"column":379,"offset":5179},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4801},"end":{"line":69,"column":379,"offset":5179},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":71,"column":1,"offset":5181},"end":{"line":71,"column":68,"offset":5248},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":5181},"end":{"line":71,"column":68,"offset":5248},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":73,"column":4,"offset":5253},"end":{"line":73,"column":13,"offset":5262},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5250},"end":{"line":73,"column":13,"offset":5262},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":75,"column":1,"offset":5264},"end":{"line":75,"column":44,"offset":5307},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":75,"column":46,"offset":5309},"end":{"line":75,"column":68,"offset":5331},"indent":[]}}],"position":{"start":{"line":75,"column":44,"offset":5307},"end":{"line":75,"column":70,"offset":5333},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":75,"column":70,"offset":5333},"end":{"line":75,"column":106,"offset":5369},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":75,"column":108,"offset":5371},"end":{"line":75,"column":129,"offset":5392},"indent":[]}}],"position":{"start":{"line":75,"column":106,"offset":5369},"end":{"line":75,"column":131,"offset":5394},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":75,"column":131,"offset":5394},"end":{"line":75,"column":159,"offset":5422},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5264},"end":{"line":75,"column":159,"offset":5422},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":78,"column":1,"offset":5425},"end":{"line":78,"column":31,"offset":5455},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":78,"column":31,"offset":5455}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. These storage provider could be in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-ecd0cdf3617cafb9dd174342e69ede0c.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-ecd0cdf3617cafb9dd174342e69ede0c.json new file mode 100644 index 0000000..e983032 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-ecd0cdf3617cafb9dd174342e69ede0c.json @@ -0,0 +1 @@ +{"expireTime":9007200861829630000,"key":"gatsby-plugin-mdx-entire-payload-1ed15ebdc5529d948179ef413aae06b0-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Storage","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":10,"offset":168},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":10,"offset":168},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.","position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}}],"position":{"start":{"line":10,"column":1,"offset":170},"end":{"line":10,"column":165,"offset":334},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":12,"column":5,"offset":340},"end":{"line":12,"column":19,"offset":354},"indent":[]}}],"position":{"start":{"line":12,"column":1,"offset":336},"end":{"line":12,"column":19,"offset":354},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One or more Kerberos Enterprise agents, can store their data directly on ","position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":74,"offset":429},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":14,"column":75,"offset":430},"end":{"line":14,"column":89,"offset":444},"indent":[]}}],"position":{"start":{"line":14,"column":74,"offset":429},"end":{"line":14,"column":98,"offset":453},"indent":[]}},{"type":"text","value":", and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).","position":{"start":{"line":14,"column":98,"offset":453},"end":{"line":14,"column":275,"offset":630},"indent":[]}}],"position":{"start":{"line":14,"column":1,"offset":356},"end":{"line":14,"column":275,"offset":630},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":16,"column":5,"offset":636},"end":{"line":16,"column":21,"offset":652},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":632},"end":{"line":16,"column":21,"offset":652},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to ","position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":201,"offset":854},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":18,"column":202,"offset":855},"end":{"line":18,"column":216,"offset":869},"indent":[]}}],"position":{"start":{"line":18,"column":201,"offset":854},"end":{"line":18,"column":225,"offset":878},"indent":[]}},{"type":"text","value":" in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio.","position":{"start":{"line":18,"column":225,"offset":878},"end":{"line":18,"column":396,"offset":1049},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":654},"end":{"line":18,"column":396,"offset":1049},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Despite the flexible storage capabilities, Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.","position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":232,"offset":1282},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1051},"end":{"line":20,"column":232,"offset":1282},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Cloud","position":{"start":{"line":22,"column":4,"offset":1287},"end":{"line":22,"column":18,"offset":1301},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1284},"end":{"line":22,"column":18,"offset":1301},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works ","position":{"start":{"line":24,"column":1,"offset":1303},"end":{"line":24,"column":291,"offset":1593},"indent":[]}},{"type":"link","title":null,"url":"/cloud","children":[{"type":"text","value":"can be found here","position":{"start":{"line":24,"column":292,"offset":1594},"end":{"line":24,"column":309,"offset":1611},"indent":[]}}],"position":{"start":{"line":24,"column":291,"offset":1593},"end":{"line":24,"column":318,"offset":1620},"indent":[]}},{"type":"text","value":".","position":{"start":{"line":24,"column":318,"offset":1620},"end":{"line":24,"column":319,"offset":1621},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1303},"end":{"line":24,"column":319,"offset":1621},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-architecture.png","alt":"cloud","position":{"start":{"line":26,"column":1,"offset":1623},"end":{"line":26,"column":56,"offset":1678},"indent":[]}}],"position":{"start":{"line":26,"column":1,"offset":1623},"end":{"line":26,"column":56,"offset":1678},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kerberos Storage","position":{"start":{"line":28,"column":4,"offset":1683},"end":{"line":28,"column":20,"offset":1699},"indent":[]}}],"position":{"start":{"line":28,"column":1,"offset":1680},"end":{"line":28,"column":20,"offset":1699},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:","position":{"start":{"line":30,"column":1,"offset":1701},"end":{"line":30,"column":253,"offset":1953},"indent":[]}}],"position":{"start":{"line":30,"column":1,"offset":1701},"end":{"line":30,"column":253,"offset":1953},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://cloud.google.com/storage","children":[{"type":"text","value":"Google Cloud Platform Storage","position":{"start":{"line":32,"column":6,"offset":1960},"end":{"line":32,"column":35,"offset":1989},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":1959},"end":{"line":32,"column":70,"offset":2024},"indent":[]}}],"position":{"start":{"line":32,"column":5,"offset":1959},"end":{"line":32,"column":70,"offset":2024},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1955},"end":{"line":32,"column":70,"offset":2024},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://azure.microsoft.com/en-us/services/storage/","children":[{"type":"text","value":"Microsoft Azure Storage","position":{"start":{"line":33,"column":6,"offset":2030},"end":{"line":33,"column":29,"offset":2053},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2029},"end":{"line":33,"column":83,"offset":2107},"indent":[]}}],"position":{"start":{"line":33,"column":5,"offset":2029},"end":{"line":33,"column":83,"offset":2107},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":2025},"end":{"line":33,"column":83,"offset":2107},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/s3/","children":[{"type":"text","value":"Amazon Web Services S3","position":{"start":{"line":34,"column":6,"offset":2113},"end":{"line":34,"column":28,"offset":2135},"indent":[]}}],"position":{"start":{"line":34,"column":5,"offset":2112},"end":{"line":34,"column":57,"offset":2164},"indent":[]}}],"position":{"start":{"line":34,"column":5,"offset":2112},"end":{"line":34,"column":57,"offset":2164},"indent":[]}}],"position":{"start":{"line":34,"column":1,"offset":2108},"end":{"line":34,"column":57,"offset":2164},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://min.io/","children":[{"type":"text","value":"Minio","position":{"start":{"line":35,"column":6,"offset":2170},"end":{"line":35,"column":11,"offset":2175},"indent":[]}}],"position":{"start":{"line":35,"column":5,"offset":2169},"end":{"line":35,"column":29,"offset":2193},"indent":[]}}],"position":{"start":{"line":35,"column":5,"offset":2169},"end":{"line":35,"column":29,"offset":2193},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2165},"end":{"line":35,"column":29,"offset":2193},"indent":[]}}],"position":{"start":{"line":32,"column":1,"offset":1955},"end":{"line":35,"column":29,"offset":2193},"indent":[1,1,1]}},{"type":"paragraph","children":[{"type":"text","value":"Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.","position":{"start":{"line":37,"column":1,"offset":2195},"end":{"line":37,"column":190,"offset":2384},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2195},"end":{"line":37,"column":190,"offset":2384},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":39,"column":1,"offset":2386},"end":{"line":39,"column":99,"offset":2484},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2386},"end":{"line":39,"column":99,"offset":2484},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.","position":{"start":{"line":41,"column":1,"offset":2486},"end":{"line":41,"column":220,"offset":2705},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2486},"end":{"line":41,"column":220,"offset":2705},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-edge.png","alt":"architecture kubernetes","position":{"start":{"line":43,"column":1,"offset":2707},"end":{"line":43,"column":98,"offset":2804},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2707},"end":{"line":43,"column":98,"offset":2804},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Events","position":{"start":{"line":45,"column":5,"offset":2810},"end":{"line":45,"column":11,"offset":2816},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2806},"end":{"line":45,"column":11,"offset":2816},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.","position":{"start":{"line":47,"column":1,"offset":2818},"end":{"line":47,"column":303,"offset":3120},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":2818},"end":{"line":47,"column":303,"offset":3120},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://kafka.apache.org/","children":[{"type":"text","value":"Apache Kafka","position":{"start":{"line":49,"column":6,"offset":3127},"end":{"line":49,"column":18,"offset":3139},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":3126},"end":{"line":49,"column":46,"offset":3167},"indent":[]}}],"position":{"start":{"line":49,"column":5,"offset":3126},"end":{"line":49,"column":46,"offset":3167},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3122},"end":{"line":49,"column":46,"offset":3167},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"link","title":null,"url":"https://aws.amazon.com/sqs/","children":[{"type":"text","value":"Amazon Web Services SQS","position":{"start":{"line":50,"column":6,"offset":3173},"end":{"line":50,"column":29,"offset":3196},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":3172},"end":{"line":50,"column":59,"offset":3226},"indent":[]}}],"position":{"start":{"line":50,"column":5,"offset":3172},"end":{"line":50,"column":59,"offset":3226},"indent":[]}}],"position":{"start":{"line":50,"column":1,"offset":3168},"end":{"line":50,"column":59,"offset":3226},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3122},"end":{"line":50,"column":59,"offset":3226},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.","position":{"start":{"line":52,"column":1,"offset":3228},"end":{"line":52,"column":368,"offset":3595},"indent":[]}}],"position":{"start":{"line":52,"column":1,"offset":3228},"end":{"line":52,"column":368,"offset":3595},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage.png","alt":"architecture storage","position":{"start":{"line":54,"column":1,"offset":3597},"end":{"line":54,"column":66,"offset":3662},"indent":[]}}],"position":{"start":{"line":54,"column":1,"offset":3597},"end":{"line":54,"column":66,"offset":3662},"indent":[]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"On-Demand upload","position":{"start":{"line":56,"column":5,"offset":3668},"end":{"line":56,"column":21,"offset":3684},"indent":[]}}],"position":{"start":{"line":56,"column":1,"offset":3664},"end":{"line":56,"column":21,"offset":3684},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.","position":{"start":{"line":58,"column":1,"offset":3686},"end":{"line":58,"column":237,"offset":3922},"indent":[]}}],"position":{"start":{"line":58,"column":1,"offset":3686},"end":{"line":58,"column":237,"offset":3922},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-architecture-kubernetes-ondemand-storage.png","alt":"kerberos-on-demand","position":{"start":{"line":60,"column":1,"offset":3924},"end":{"line":60,"column":105,"offset":4028},"indent":[]}}],"position":{"start":{"line":60,"column":1,"offset":3924},"end":{"line":60,"column":105,"offset":4028},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"A couple of usecases are the following ones:","position":{"start":{"line":62,"column":1,"offset":4030},"end":{"line":62,"column":45,"offset":4074},"indent":[]}}],"position":{"start":{"line":62,"column":1,"offset":4030},"end":{"line":62,"column":45,"offset":4074},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":true,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.","position":{"start":{"line":64,"column":3,"offset":4078},"end":{"line":64,"column":380,"offset":4455},"indent":[]}}],"position":{"start":{"line":64,"column":3,"offset":4078},"end":{"line":64,"column":380,"offset":4455},"indent":[]}}],"position":{"start":{"line":64,"column":1,"offset":4076},"end":{"line":65,"column":1,"offset":4456},"indent":[1]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.","position":{"start":{"line":66,"column":3,"offset":4459},"end":{"line":67,"column":49,"offset":4773},"indent":[2]}}],"position":{"start":{"line":66,"column":3,"offset":4459},"end":{"line":67,"column":49,"offset":4773},"indent":[2]}}],"position":{"start":{"line":66,"column":1,"offset":4457},"end":{"line":67,"column":49,"offset":4773},"indent":[1]}}],"position":{"start":{"line":64,"column":1,"offset":4076},"end":{"line":67,"column":49,"offset":4773},"indent":[1,1,1]}},{"type":"heading","depth":3,"children":[{"type":"text","value":"Open API","position":{"start":{"line":69,"column":5,"offset":4779},"end":{"line":69,"column":13,"offset":4787},"indent":[]}}],"position":{"start":{"line":69,"column":1,"offset":4775},"end":{"line":69,"column":13,"offset":4787},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type ","position":{"start":{"line":71,"column":1,"offset":4789},"end":{"line":71,"column":156,"offset":4944},"indent":[]}},{"type":"inlineCode","value":"/swagger/index.html","position":{"start":{"line":71,"column":156,"offset":4944},"end":{"line":71,"column":177,"offset":4965},"indent":[]}},{"type":"text","value":" after the ","position":{"start":{"line":71,"column":177,"offset":4965},"end":{"line":71,"column":188,"offset":4976},"indent":[]}},{"type":"inlineCode","value":"api","position":{"start":{"line":71,"column":188,"offset":4976},"end":{"line":71,"column":193,"offset":4981},"indent":[]}},{"type":"text","value":" url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).","position":{"start":{"line":71,"column":193,"offset":4981},"end":{"line":71,"column":379,"offset":5167},"indent":[]}}],"position":{"start":{"line":71,"column":1,"offset":4789},"end":{"line":71,"column":379,"offset":5167},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-storage-swagger.png","alt":"swgger storage","position":{"start":{"line":73,"column":1,"offset":5169},"end":{"line":73,"column":68,"offset":5236},"indent":[]}}],"position":{"start":{"line":73,"column":1,"offset":5169},"end":{"line":73,"column":68,"offset":5236},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":75,"column":4,"offset":5241},"end":{"line":75,"column":13,"offset":5250},"indent":[]}}],"position":{"start":{"line":75,"column":1,"offset":5238},"end":{"line":75,"column":13,"offset":5250},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Storage is publicly available and ","position":{"start":{"line":77,"column":1,"offset":5252},"end":{"line":77,"column":44,"offset":5295},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"requires a license key","position":{"start":{"line":77,"column":46,"offset":5297},"end":{"line":77,"column":68,"offset":5319},"indent":[]}}],"position":{"start":{"line":77,"column":44,"offset":5295},"end":{"line":77,"column":70,"offset":5321},"indent":[]}},{"type":"text","value":" to operate correctly. Reach out to ","position":{"start":{"line":77,"column":70,"offset":5321},"end":{"line":77,"column":106,"offset":5357},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"cedric@verstraeten.io","position":{"start":{"line":77,"column":108,"offset":5359},"end":{"line":77,"column":129,"offset":5380},"indent":[]}}],"position":{"start":{"line":77,"column":106,"offset":5357},"end":{"line":77,"column":131,"offset":5382},"indent":[]}},{"type":"text","value":" for the commercial matters.","position":{"start":{"line":77,"column":131,"offset":5382},"end":{"line":77,"column":159,"offset":5410},"indent":[]}}],"position":{"start":{"line":77,"column":1,"offset":5252},"end":{"line":77,"column":159,"offset":5410},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":80,"column":1,"offset":5413},"end":{"line":80,"column":31,"offset":5443},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":80,"column":31,"offset":5443}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Storage`}

\n

{`Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available.`}

\n

{`Kerberos Cloud`}

\n

{`One or more Kerberos Enterprise agents, can store their data directly on `}{`Kerberos Cloud`}{`, and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you).`}

\n

{`Kerberos Storage`}

\n

{`In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to `}{`Kerberos Cloud`}{` in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio.`}

\n

{`Despite the flexible storage capabilities, Kerberos Storage is not only a storage solution, it's also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations.`}

\n

{`Kerberos Cloud`}

\n

{`Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works `}{`can be found here`}{`.`}

\n

\"cloud\"

\n

{`Kerberos Storage`}

\n

{`If you are using Kerberos Enterprise you have the possibility to bring your own cloud or on premise storage. By installing Kerberos Storage you can send your recordings to your own datacenter, private or public cloud. Following providers are supported:`}

\n \n

{`Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud.`}

\n

\"architecture

\n

{`On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge.`}

\n

\"architecture

\n

{`Events`}

\n

{`One of the key differentiators compared to other VMS solutions, is the abilitity to extend and integrate. Next to uploading and persisting data, Kerberos Storage can also trigger events. Each time a recording is send to Kerberos Storage an event can be triggered through one of the following providers.`}

\n \n

{`Those events can be fetched or subscribed by custom applications. For example, one can create a notifications service, machine learning service or an entire cloud application. Allowing you to leverage the power and scalability of Kerberos Enterprise, and building and focussing on your specific applications, API's, mobile apps, or whatever you have in mind to build.`}

\n

\"architecture

\n

{`On-Demand upload`}

\n

{`Next to the extension and integration capabilities of Kerberos Storage, we are currently working on a feature called On-Demand upload. On-Demand upload allows you to upload a subset of your recordings to a Kerberos Storage in the cloud.`}

\n

\"kerberos-on-demand\"

\n

{`A couple of usecases are the following ones:`}

\n
    \n
  • \n

    {`Continious recording: having continious recordings stored in your Kerberos Storage on premise, you don't want to replicate all your recordings to a Kerberos Storage provider in the cloud (to make them public available). Therefore you could implement custom logic, for example based on a machine learning algorithm, to only replicate recordings which matche a specific scenario.`}

    \n
    • \n
  • \n

    {`On-Demand request: Having Kerberos Cloud, an end-user could initiate a request for upload. By default no recordings are forwarded from your Kerberos Storage on premise to your Kerberos Storage in the cloud. Only when an end user requests one or more recordings, the\nupload will start for the requested recordings.`}

    \n
    • \n
\n

{`Open API`}

\n

{`Both Kerberos Enterprise as Kerberos Storage ships with Swagger API's, which can be used to communicate with the previously mentioned systems. Simply type `}{`/swagger/index.html`}{` after the `}{`api`}{` url, and you will see the Swagger UI popping up. No need to explain the different API's, use the Swagger and see what is available. See something missing, let us know, and we add it ;).`}

\n

\"swgger

\n

{`Licensing`}

\n

{`Kerberos Storage is publicly available and `}{`requires a license key`}{` to operate correctly. Reach out to `}{`cedric@verstraeten.io`}{` for the commercial matters.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-fce6de7b9c7e99139c07e1f615c5ca5d.json b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-fce6de7b9c7e99139c07e1f615c5ca5d.json new file mode 100644 index 0000000..87dec48 --- /dev/null +++ b/.docz/.cache/caches/gatsby-plugin-mdx/diskstore-fce6de7b9c7e99139c07e1f615c5ca5d.json @@ -0,0 +1 @@ +{"expireTime":9007200861750731000,"key":"gatsby-plugin-mdx-entire-payload-19cd73859157323f5ade93c01d9b72a1-","val":{"mdast":{"type":"root","children":[{"type":"import","value":"import DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"","position":{"start":{"line":3,"column":1,"offset":2},"end":{"line":3,"column":125,"offset":126},"indent":[]}},{"type":"export","default":true,"value":"export default DefaultLayout","position":{"start":{"line":5,"column":1,"offset":128},"end":{"line":5,"column":29,"offset":156},"indent":[]}},{"type":"heading","depth":1,"children":[{"type":"text","value":"Enterprise","position":{"start":{"line":8,"column":3,"offset":161},"end":{"line":8,"column":13,"offset":171},"indent":[]}}],"position":{"start":{"line":8,"column":1,"offset":159},"end":{"line":8,"column":13,"offset":171},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.","position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}}],"position":{"start":{"line":10,"column":1,"offset":173},"end":{"line":11,"column":65,"offset":467},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.","position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}}],"position":{"start":{"line":13,"column":1,"offset":469},"end":{"line":14,"column":75,"offset":776},"indent":[1]}},{"type":"paragraph","children":[{"type":"text","value":"Independent from that we've seen many vendors developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solutions with limited API's and/or messaging capabilities.","position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":280,"offset":1057},"indent":[]}}],"position":{"start":{"line":16,"column":1,"offset":778},"end":{"line":16,"column":280,"offset":1057},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the ground up.","position":{"start":{"line":18,"column":1,"offset":1059},"end":{"line":18,"column":270,"offset":1328},"indent":[]}}],"position":{"start":{"line":18,"column":1,"offset":1059},"end":{"line":18,"column":270,"offset":1328},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"The major key differentiators compared to to other solutions are:","position":{"start":{"line":20,"column":1,"offset":1330},"end":{"line":20,"column":66,"offset":1395},"indent":[]}}],"position":{"start":{"line":20,"column":1,"offset":1330},"end":{"line":20,"column":66,"offset":1395},"indent":[]}},{"type":"list","ordered":false,"start":null,"spread":false,"children":[{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Scalability with Kubernetes,","position":{"start":{"line":22,"column":5,"offset":1401},"end":{"line":22,"column":33,"offset":1429},"indent":[]}}],"position":{"start":{"line":22,"column":5,"offset":1401},"end":{"line":22,"column":33,"offset":1429},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1397},"end":{"line":22,"column":33,"offset":1429},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Open API's with well documented Swagger API's,","position":{"start":{"line":23,"column":5,"offset":1434},"end":{"line":23,"column":51,"offset":1480},"indent":[]}}],"position":{"start":{"line":23,"column":5,"offset":1434},"end":{"line":23,"column":51,"offset":1480},"indent":[]}}],"position":{"start":{"line":23,"column":1,"offset":1430},"end":{"line":23,"column":51,"offset":1480},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Host anywhere, in the cloud or on premise,","position":{"start":{"line":24,"column":5,"offset":1485},"end":{"line":24,"column":47,"offset":1527},"indent":[]}}],"position":{"start":{"line":24,"column":5,"offset":1485},"end":{"line":24,"column":47,"offset":1527},"indent":[]}}],"position":{"start":{"line":24,"column":1,"offset":1481},"end":{"line":24,"column":47,"offset":1527},"indent":[]}},{"type":"listItem","spread":false,"checked":null,"children":[{"type":"paragraph","children":[{"type":"text","value":"Integration and extension, allowing to build custom apps, ML services and more.","position":{"start":{"line":25,"column":5,"offset":1532},"end":{"line":25,"column":84,"offset":1611},"indent":[]}}],"position":{"start":{"line":25,"column":5,"offset":1532},"end":{"line":25,"column":84,"offset":1611},"indent":[]}}],"position":{"start":{"line":25,"column":1,"offset":1528},"end":{"line":25,"column":84,"offset":1611},"indent":[]}}],"position":{"start":{"line":22,"column":1,"offset":1397},"end":{"line":25,"column":84,"offset":1611},"indent":[1,1,1]}},{"type":"jsx","value":"
\n
\n

","position":{"start":{"line":27,"column":1,"offset":1613},"end":{"line":29,"column":11,"offset":1815},"indent":[1,1]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Kubernetes","position":{"start":{"line":31,"column":4,"offset":1820},"end":{"line":31,"column":14,"offset":1830},"indent":[]}}],"position":{"start":{"line":31,"column":1,"offset":1817},"end":{"line":31,"column":14,"offset":1830},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.","position":{"start":{"line":33,"column":1,"offset":1832},"end":{"line":33,"column":306,"offset":2137},"indent":[]}}],"position":{"start":{"line":33,"column":1,"offset":1832},"end":{"line":33,"column":306,"offset":2137},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes.png","alt":"architecture kubernetes","position":{"start":{"line":35,"column":1,"offset":2139},"end":{"line":35,"column":91,"offset":2229},"indent":[]}}],"position":{"start":{"line":35,"column":1,"offset":2139},"end":{"line":35,"column":91,"offset":2229},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).","position":{"start":{"line":37,"column":1,"offset":2231},"end":{"line":37,"column":239,"offset":2469},"indent":[]}}],"position":{"start":{"line":37,"column":1,"offset":2231},"end":{"line":37,"column":239,"offset":2469},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.","position":{"start":{"line":39,"column":1,"offset":2471},"end":{"line":39,"column":242,"offset":2712},"indent":[]}}],"position":{"start":{"line":39,"column":1,"offset":2471},"end":{"line":39,"column":242,"offset":2712},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.","position":{"start":{"line":41,"column":1,"offset":2714},"end":{"line":41,"column":205,"offset":2918},"indent":[]}}],"position":{"start":{"line":41,"column":1,"offset":2714},"end":{"line":41,"column":205,"offset":2918},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Cloud or on premise","position":{"start":{"line":43,"column":4,"offset":2923},"end":{"line":43,"column":23,"offset":2942},"indent":[]}}],"position":{"start":{"line":43,"column":1,"offset":2920},"end":{"line":43,"column":23,"offset":2942},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.","position":{"start":{"line":45,"column":1,"offset":2944},"end":{"line":45,"column":283,"offset":3226},"indent":[]}}],"position":{"start":{"line":45,"column":1,"offset":2944},"end":{"line":45,"column":283,"offset":3226},"indent":[]}},{"type":"paragraph","children":[{"type":"image","title":null,"url":"../../public/images/kerberos-agent-architecture-kubernetes-cloud.png","alt":"architecture kubernetes","position":{"start":{"line":47,"column":1,"offset":3228},"end":{"line":47,"column":97,"offset":3324},"indent":[]}}],"position":{"start":{"line":47,"column":1,"offset":3228},"end":{"line":47,"column":97,"offset":3324},"indent":[]}},{"type":"heading","depth":2,"children":[{"type":"text","value":"Licensing","position":{"start":{"line":49,"column":4,"offset":3329},"end":{"line":49,"column":13,"offset":3338},"indent":[]}}],"position":{"start":{"line":49,"column":1,"offset":3326},"end":{"line":49,"column":13,"offset":3338},"indent":[]}},{"type":"paragraph","children":[{"type":"text","value":"Kerberos Enterprise is publicly available and ","position":{"start":{"line":51,"column":1,"offset":3340},"end":{"line":51,"column":47,"offset":3386},"indent":[]}},{"type":"strong","children":[{"type":"text","value":"does not","position":{"start":{"line":51,"column":49,"offset":3388},"end":{"line":51,"column":57,"offset":3396},"indent":[]}}],"position":{"start":{"line":51,"column":47,"offset":3386},"end":{"line":51,"column":59,"offset":3398},"indent":[]}},{"type":"text","value":" require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.","position":{"start":{"line":51,"column":59,"offset":3398},"end":{"line":51,"column":174,"offset":3513},"indent":[]}}],"position":{"start":{"line":51,"column":1,"offset":3340},"end":{"line":51,"column":174,"offset":3513},"indent":[]}},{"type":"export","value":"export const _frontmatter = {}","position":{"start":{"line":54,"column":1,"offset":3516},"end":{"line":54,"column":31,"offset":3546},"indent":[]}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":54,"column":31,"offset":3546}}},"scopeImports":[],"scopeIdentifiers":[],"rawMDXOutput":"/* @jsx mdx */\nimport { mdx } from '@mdx-js/react';\n/* @jsx mdx */\nimport DefaultLayout from \"/Users/i353408/Vagrant/www/repos/documentation/node_modules/gatsby-theme-docz/src/base/Layout.js\"\nexport const _frontmatter = {};\nconst makeShortcode = name => function MDXDefaultShortcode(props) {\n console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\")\n return
\n};\n\nconst layoutProps = {\n _frontmatter\n};\nconst MDXLayout = DefaultLayout\nexport default function MDXContent({\n components,\n ...props\n}) {\n return \n\n\n

{`Enterprise`}

\n

{`Over the years Kerberos evolved into a mature and stable solution. Lots of people and companies started to adopt the system, and requested enhancements. Despite the fact that Kerberos Open Source is stable and feature rich, every\nsolution has its limitations, especially if you aim to scale it.`}

\n

{`That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships\nas a Docker image, it has no high availability or fail over functionality.`}

\n

{`Independent from that we've seen many vendors developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solutions with limited API's and/or messaging capabilities.`}

\n

{`Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the ground up.`}

\n

{`The major key differentiators compared to to other solutions are:`}

\n
    \n
  • {`Scalability with Kubernetes,`}
    • \n
  • {`Open API's with well documented Swagger API's,`}
    • \n
  • {`Host anywhere, in the cloud or on premise,`}
    • \n
  • {`Integration and extension, allowing to build custom apps, ML services and more.`}
    • \n
\n
\n
\n

\n

{`Kubernetes`}

\n

{`To provide our customer with the high availability and fail over requirements they have, Kerberos Enterprise was built on top of Kubernetes (k8s). This container orchestrator allows us to scale a video surveillance landscape horizontally, and deliver a never-seen high available video surveillance system.`}

\n

\"architecture

\n

{`Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines).`}

\n

{`Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly.`}

\n

{`By having the power to add nodes to your cluster, you can anticipate to the ever growing need of your surveillance cameras. With the Kubernetes tools you can monitor your cluster and get into the details.`}

\n

{`Cloud or on premise`}

\n

{`You install Kerberos Enterprise inside a Kubernetes cluster, but there are no limitations where this cluster will be actually running. This means that whatever security policy you have within your company, you can run it where you want: on-premise, public cloud, private cloud, etc.`}

\n

\"architecture

\n

{`Licensing`}

\n

{`Kerberos Enterprise is publicly available and `}{`does not`}{` require a license key to operate correctly. Everyone can install the Kerberos Enterprise component free of charge.`}

\n\n ;\n}\n\n;\nMDXContent.isMDXComponent = true;"}} \ No newline at end of file diff --git a/.docz/.cache/dev-404-page.js b/.docz/.cache/dev-404-page.js new file mode 100755 index 0000000..bd20571 --- /dev/null +++ b/.docz/.cache/dev-404-page.js @@ -0,0 +1,145 @@ +import React from "react" +import PropTypes from "prop-types" +import { graphql, Link } from "gatsby" + +class Dev404Page extends React.Component { + static propTypes = { + data: PropTypes.object, + custom404: PropTypes.element, + location: PropTypes.object, + } + + constructor(props) { + super(props) + const { data } = this.props + const pagePaths = data.allSitePage.nodes.map(node => node.path) + this.state = { + showCustom404: false, + initPagePaths: pagePaths, + pagePaths: pagePaths, + pagePathSearchTerms: ``, + } + this.showCustom404 = this.showCustom404.bind(this) + this.handlePagePathSearch = this.handlePagePathSearch.bind(this) + this.handleSearchTermChange = this.handleSearchTermChange.bind(this) + } + + showCustom404() { + this.setState({ showCustom404: true }) + } + + handleSearchTermChange(event) { + this.setState({ + pagePathSearchTerms: event.target.value, + }) + } + + handlePagePathSearch(event) { + event.preventDefault() + const tempPagePaths = [...this.state.initPagePaths] + const searchTerm = new RegExp(`${this.state.pagePathSearchTerms}`) + this.setState({ + pagePaths: tempPagePaths.filter(pagePath => searchTerm.test(pagePath)), + }) + } + + render() { + const { pathname } = this.props.location + let newFilePath + if (pathname === `/`) { + newFilePath = `src/pages/index.js` + } else if (pathname.slice(-1) === `/`) { + newFilePath = `src/pages${pathname.slice(0, -1)}.js` + } else { + newFilePath = `src/pages${pathname}.js` + } + + return this.state.showCustom404 ? ( + this.props.custom404 + ) : ( +
+

Gatsby.js development 404 page

+

+ {`There's not a page yet at `} + {pathname} +

+ {this.props.custom404 ? ( +

+ +

+ ) : ( +

+ {`A custom 404 page wasn't detected - if you would like to add one, create a component in your site directory at `} + src/pages/404.js. +

+ )} +

+ Create a React.js component in your site directory at + {` `} + {newFilePath} + {` `} + and this page will automatically refresh to show the new page + component you created. +

+ {this.state.initPagePaths.length > 0 && ( +
+

+ If you were trying to reach another page, perhaps you can find it + below. +

+

+ Pages ( + {this.state.pagePaths.length != this.state.initPagePaths.length + ? `${this.state.pagePaths.length}/${this.state.initPagePaths.length}` + : this.state.initPagePaths.length} + ) +

+ +
+ + +
+
    + {this.state.pagePaths.map( + (pagePath, index) => + index < 100 && ( +
  • + {pagePath} +
    • + ) + )} + {this.state.pagePaths.length > 100 && ( +

    + ... and {this.state.pagePaths.length - 100} more. +

    + )} +
+
+ )} +
+ ) + } +} + +export default Dev404Page + +export const pagesQuery = graphql` + query PagesQuery { + allSitePage(filter: { path: { ne: "/dev-404-page/" } }) { + nodes { + path + } + } + } +` diff --git a/.docz/.cache/redux/redux.node.state_0 b/.docz/.cache/redux/redux.node.state_0 index 51df5d5..3cb196d 100644 Binary files a/.docz/.cache/redux/redux.node.state_0 and b/.docz/.cache/redux/redux.node.state_0 differ diff --git a/.docz/.cache/redux/redux.rest.state b/.docz/.cache/redux/redux.rest.state index 022bc91..eacfc0b 100644 Binary files a/.docz/.cache/redux/redux.rest.state and b/.docz/.cache/redux/redux.rest.state differ diff --git a/.docz/.cache/sync-requires.js b/.docz/.cache/sync-requires.js index fc538a8..5878fd5 100644 --- a/.docz/.cache/sync-requires.js +++ b/.docz/.cache/sync-requires.js @@ -5,11 +5,12 @@ const preferDefault = m => m && m.default || m exports.components = { + "component---cache-dev-404-page-js": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/.docz/.cache/dev-404-page.js"))), "component---src-architectures-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/architectures.mdx"))), "component---src-how-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/how.mdx"))), "component---src-index-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/index.mdx"))), - "component---src-enterprise-index-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/index.mdx"))), "component---src-enterprise-installation-cloud-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/installation-cloud.mdx"))), + "component---src-enterprise-index-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/index.mdx"))), "component---src-enterprise-installation-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/installation.mdx"))), "component---src-enterprise-releases-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/releases.mdx"))), "component---src-open-source-get-started-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/open-source/get-started.mdx"))), @@ -17,10 +18,10 @@ exports.components = { "component---src-open-source-upgrade-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/open-source/upgrade.mdx"))), "component---src-open-source-web-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/open-source/web.mdx"))), "component---src-storage-get-started-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/storage/get-started.mdx"))), + "component---src-storage-index-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/storage/index.mdx"))), "component---src-storage-installation-cloud-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation-cloud.mdx"))), "component---src-storage-installation-edge-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation-edge.mdx"))), "component---src-storage-installation-providers-md": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation-providers.md"))), - "component---src-storage-index-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/storage/index.mdx"))), "component---src-storage-installation-recycle-md": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation-recycle.md"))), "component---src-storage-installation-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation.mdx"))), "component---src-cloud-index-mdx": hot(preferDefault(require("/Users/i353408/Vagrant/www/repos/documentation/src/cloud/index.mdx"))), diff --git a/.docz/app/db.json b/.docz/app/db.json index 46037ed..ab61ccb 100644 --- a/.docz/app/db.json +++ b/.docz/app/db.json @@ -483,6 +483,11 @@ "depth": 2, "value": "Traefik" }, + { + "slug": "ingress-nginx-alternative-for-traefik", + "depth": 2, + "value": "Ingress-Nginx (alternative for Traefik)" + }, { "slug": "mongodb", "depth": 2, @@ -2270,11 +2275,21 @@ }, { "slug": "kerberos-cloud", - "depth": 2, + "depth": 3, "value": "Kerberos Cloud" }, { "slug": "kerberos-storage", + "depth": 3, + "value": "Kerberos Storage" + }, + { + "slug": "kerberos-cloud-1", + "depth": 2, + "value": "Kerberos Cloud" + }, + { + "slug": "kerberos-storage-1", "depth": 2, "value": "Kerberos Storage" }, diff --git a/.docz/gatsby-node.js b/.docz/gatsby-node.js new file mode 100644 index 0000000..3b6629d --- /dev/null +++ b/.docz/gatsby-node.js @@ -0,0 +1,144 @@ +const { get } = require('docz-utils') + +const NO_OP = () => {} + +const DEFAULT_RESOLVABLE_EXTENSIONS = () => [`.js`, `.jsx`] + +let gatsbyNodeCustom = {} +try { + gatsbyNodeCustom = require('./gatsby-node.custom') +} catch (err) {} + +// https://www.gatsbyjs.org/docs/node-apis/ + +exports.createPages = args => { + const createPages = get(gatsbyNodeCustom, 'createPages', NO_OP) + return createPages(args) +} + +exports.createPagesStatefully = args => { + const createPagesStatefully = get( + gatsbyNodeCustom, + 'createPagesStatefully', + NO_OP, + ) + return createPagesStatefully(args) +} + +exports.createResolvers = args => { + const createResolvers = get(gatsbyNodeCustom, 'createResolvers', NO_OP) + return createResolvers(args) +} + +exports.createSchemaCustomization = args => { + const createSchemaCustomization = get( + gatsbyNodeCustom, + 'createSchemaCustomization', + NO_OP, + ) + return createSchemaCustomization(args) +} + +exports.generateSideEffects = args => { + const generateSideEffects = get( + gatsbyNodeCustom, + 'generateSideEffects', + NO_OP, + ) + return generateSideEffects(args) +} + +exports.onCreateBabelConfig = args => { + const onCreateBabelConfig = get( + gatsbyNodeCustom, + 'onCreateBabelConfig', + NO_OP, + ) + return onCreateBabelConfig(args) +} + +exports.onCreateDevServer = args => { + const onCreateDevServer = get(gatsbyNodeCustom, 'onCreateDevServer', NO_OP) + return onCreateDevServer(args) +} + +exports.onCreateNode = args => { + const onCreateNode = get(gatsbyNodeCustom, 'onCreateNode', NO_OP) + return onCreateNode(args) +} + +exports.onCreatePage = args => { + const onCreatePage = get(gatsbyNodeCustom, 'onCreatePage', NO_OP) + return onCreatePage(args) +} + +exports.onCreateWebpackConfig = args => { + const onCreateWebpackConfig = get( + gatsbyNodeCustom, + 'onCreateWebpackConfig', + NO_OP, + ) + return onCreateWebpackConfig(args) +} + +exports.onPostBootstrap = args => { + const onPostBootstrap = get(gatsbyNodeCustom, 'onPostBootstrap', NO_OP) + return onPostBootstrap(args) +} + +exports.onPostBuild = args => { + const onPostBuild = get(gatsbyNodeCustom, 'onPostBuild', NO_OP) + return onPostBuild(args) +} + +exports.onPreBootstrap = args => { + const onPreBootstrap = get(gatsbyNodeCustom, 'onPreBootstrap', NO_OP) + return onPreBootstrap(args) +} + +exports.onPreBuild = args => { + const onPreBuild = get(gatsbyNodeCustom, 'onPreBuild', NO_OP) + return onPreBuild(args) +} + +exports.onPreExtractQueries = args => { + const onPreExtractQueries = get( + gatsbyNodeCustom, + 'onPreExtractQueries', + NO_OP, + ) + return onPreExtractQueries(args) +} + +exports.onPreInit = args => { + const onPreInit = get(gatsbyNodeCustom, 'onPreInit', NO_OP) + return onPreInit(args) +} + +exports.preprocessSource = args => { + const preprocessSource = get(gatsbyNodeCustom, 'preprocessSource', NO_OP) + return preprocessSource(args) +} + +exports.resolvableExtensions = args => { + const resolvableExtensions = get( + gatsbyNodeCustom, + 'resolvableExtensions', + DEFAULT_RESOLVABLE_EXTENSIONS, + ) + return resolvableExtensions(args) +} + +exports.setFieldsOnGraphQLNodeType = args => { + const setFieldsOnGraphQLNodeType = get( + gatsbyNodeCustom, + 'setFieldsOnGraphQLNodeType', + () => ({}), + ) + return setFieldsOnGraphQLNodeType(args) +} + +exports.sourceNodes = args => { + const sourceNodes = get(gatsbyNodeCustom, 'sourceNodes', NO_OP) + return sourceNodes(args) +} diff --git a/.docz/public/index.html b/.docz/public/index.html index 4a5e21c..f8a2cb5 100644 --- a/.docz/public/index.html +++ b/.docz/public/index.html @@ -1,2 +1 @@ -Introduction | Kerberos.io
Kerberos.io
IntroductionThe name: Kerberos.ioWhy KerberosWhat is KerberosHow it worksArchitectures
Open Source
Enterprise
Storage
Cloud

Introduction

The Kerberos(dot)io project, is a video surveillance solution, which was initiated back in 2014. Over the years it has evolved into a trusted, stable and feature-rich video surveillance system. To set the expectations, watch the video below to understand what it can and can't do. If you want to install Kerberos(dot)io, it's recommended to have a look at the architectures page to find the best solution for your usecase.

The name: Kerberos.io

Many people are confused, and don't understand why this project is called Kerberos(dot)io. If you've been in the IT world for a while you will notice that Kerberos is already used for the authentication protocol Kerberos. -We believe that the name Kerberos(dot)io makes sense for this project as well, with a strong emphasize on the suffix .io, which stands for input and output devices (e.g. any type of camera). Kerberos(dot)io can be seen as a kind of security protocol driven by hardware devices such as surveillance cameras. To make writing easier we will from now on, refer to Kerberos instead of Kerberos(dot)io.

Why Kerberos

As burglary is very common, we believe that video surveillance is a trivial tool in our daily lifes which helps us to feel a little bit more secure. Responding to this need, a lot of companies have started developing their own video surveillance software in the past few years.

Nowadays we have a myriad of expensive cameras, recorders, and software solutions which are mainly outdated and difficult to install and use. Kerberos goal is to solve these problems and to provide every human being or enterprise in this world to have their own ecological, affordable, easy-to-use and innovative surveillance solution.

What is Kerberos

Kerberos is a video surveillance solution, that uses computer vision algorithms to detect changes, and that can trigger actions (notifications, api, etc). It comes in two flavors, Kerberos Open Source and Kerberos Enterprise. Kerberos can be deployed to any ARM device, Linux OS, Docker, Balenca Cloud, or cluster such as Kubernetes.

Kerberos Agent

When you install Kerberos Open Source or Kerberos Enterprise we will refer to it as the Kerberos agent. A Kerberos agent, is a software solution that processes the video stream of a single surveillance camera, makes and visualises recordings and takes actions (for example sending notifications).

\ No newline at end of file +
\ No newline at end of file diff --git a/.docz/public/page-data/dev-404-page/page-data.json b/.docz/public/page-data/dev-404-page/page-data.json index ba9c0f4..e9f4b03 100644 --- a/.docz/public/page-data/dev-404-page/page-data.json +++ b/.docz/public/page-data/dev-404-page/page-data.json @@ -1 +1 @@ -{"componentChunkName":"component---cache-dev-404-page-js","path":"/dev-404-page/","result":{"data":{"allSitePage":{"nodes":[{"path":"/architectures"},{"path":"/how"},{"path":"/"},{"path":"/enterprise/get-started"},{"path":"/enterprise/introduction"},{"path":"/enterprise/installation-cloud"},{"path":"/enterprise/installation"},{"path":"/enterprise/releases"},{"path":"/opensource/get-started"},{"path":"/opensource/introduction"},{"path":"/opensource/upgrade"},{"path":"/opensource/web"},{"path":"/storage/get-started"},{"path":"/storage/introduction"},{"path":"/storage/installation-cloud"},{"path":"/storage/installation-edge"},{"path":"/storage/installation-recycle"},{"path":"/storage/installation-providers"},{"path":"/storage/installation"},{"path":"/cloud"},{"path":"/enterprise/installation-edge"},{"path":"/opensource/contribute"},{"path":"/opensource/installation-advanced"},{"path":"/opensource/installation"},{"path":"/opensource/license"},{"path":"/opensource/releases"},{"path":"/storage/license"},{"path":"/opensource/machinery"},{"path":"/404/"},{"path":"/404.html"}]}},"pageContext":{}}} \ No newline at end of file +{"componentChunkName":"component---cache-dev-404-page-js","path":"/dev-404-page/","result":{"data":{"allSitePage":{"nodes":[{"path":"/architectures"},{"path":"/how"},{"path":"/"},{"path":"/enterprise/installation-cloud"},{"path":"/enterprise/introduction"},{"path":"/enterprise/installation"},{"path":"/enterprise/releases"},{"path":"/opensource/get-started"},{"path":"/opensource/introduction"},{"path":"/opensource/upgrade"},{"path":"/opensource/web"},{"path":"/storage/get-started"},{"path":"/storage/introduction"},{"path":"/storage/installation-cloud"},{"path":"/storage/installation-edge"},{"path":"/storage/installation-providers"},{"path":"/storage/installation-recycle"},{"path":"/storage/installation"},{"path":"/cloud"},{"path":"/enterprise/get-started"},{"path":"/enterprise/installation-edge"},{"path":"/opensource/contribute"},{"path":"/opensource/installation-advanced"},{"path":"/opensource/installation"},{"path":"/opensource/license"},{"path":"/opensource/releases"},{"path":"/storage/license"},{"path":"/opensource/machinery"},{"path":"/404/"},{"path":"/404.html"}]}},"pageContext":{}}} \ No newline at end of file diff --git a/.docz/public/static/d/1803957048.json b/.docz/public/static/d/1803957048.json index 8d1aa9e..2e4f3c3 100644 --- a/.docz/public/static/d/1803957048.json +++ b/.docz/public/static/d/1803957048.json @@ -1 +1 @@ -{"data":{"doczDb":{"id":"ace00e2b-9c46-5e24-a19a-5ed242ca9c64","db":"{\"config\":{\"title\":\"Kerberos.io\",\"description\":\"My awesome app using docz\",\"menu\":[\"Introduction\",\"How it works\",\"Architectures\",{\"name\":\"Open Source\",\"menu\":[\"First things first\",\"Get Started\",\"Installation\",\"Installation - advanced\",\"Releases\",\"License\",\"Upgrade\",\"Contribute\",\"Machinery\",\"Web\"]},{\"name\":\"Enterprise\",\"menu\":[\"First things first\",\"Get Started\",\"Installation\",\"Installation - Cloud\",\"Installation - Edge\",\"Releases\"]},{\"name\":\"Storage\",\"menu\":[\"First things first\",\"Get Started\",\"Installation\",\"Installation - Cloud\",\"Installation - Edge\",\"Installation - Recycle\",\"Installation - Providers\",\"License\"]},\"Cloud\"],\"version\":\"2.0.0-rc.41\",\"repository\":\"https://github.com/kerberos-io\",\"native\":false,\"themeConfig\":{\"colors\":{\"primary\":\"#943733\",\"secondary\":\"#9e9e9e\",\"h5\":{\"color\":\"#943733\"},\"header\":{\"bg\":\"#943733\"},\"sidebar\":{\"bg\":\"#f9f9f9\",\"navLinkActive\":\"#943733\"},\"modes\":{\"dark\":{\"primary\":\"#9e9e9e\",\"secondary\":\"#943733\",\"header\":{\"bg\":\"#943733\"},\"sidebar\":{\"navLinkActive\":\"#fff\"}}}}},\"separator\":\"-\",\"gatsbyRemarkPlugins\":[{\"resolve\":\"gatsby-remark-vscode\"},{\"resolve\":\"gatsby-remark-grid-tables\"}]},\"entries\":[{\"key\":\"src/architectures.mdx\",\"value\":{\"name\":\"Architectures\",\"route\":\"/architectures\",\"id\":\"bb781d264051ead449d715317c32b263\",\"filepath\":\"src/architectures.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/architectures.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-architectures\",\"menu\":\"\",\"headings\":[{\"slug\":\"architectures\",\"depth\":1,\"value\":\"Architectures\"},{\"slug\":\"agents-on-premise\",\"depth\":2,\"value\":\"Agents on-premise\"},{\"slug\":\"kerberos-open-source--5-kerberos-agents\",\"depth\":3,\"value\":\"Kerberos Open Source (< 5 Kerberos agents)\"},{\"slug\":\"kerberos-enterprise--5-kerberos-agents\",\"depth\":3,\"value\":\"Kerberos Enterprise (> 5 Kerberos agents)\"},{\"slug\":\"agents-in-the-cloud\",\"depth\":2,\"value\":\"Agents in the cloud\"},{\"slug\":\"kerberos-open-source--5-kerberos-agents-1\",\"depth\":3,\"value\":\"Kerberos Open Source (< 5 Kerberos agents)\"},{\"slug\":\"kerberos-enterprise--5-kerberos-agents-1\",\"depth\":3,\"value\":\"Kerberos Enterprise (> 5 Kerberos agents)\"},{\"slug\":\"kerberos-cloud\",\"depth\":2,\"value\":\"Kerberos Cloud\"},{\"slug\":\"architecture\",\"depth\":3,\"value\":\"Architecture\"}]}},{\"key\":\"src/how.mdx\",\"value\":{\"name\":\"How it works\",\"route\":\"/how\",\"id\":\"456a1e92398967539c5497522b4455c5\",\"filepath\":\"src/how.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/how.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-how\",\"menu\":\"\",\"headings\":[{\"slug\":\"how-it-works\",\"depth\":1,\"value\":\"How it works\"},{\"slug\":\"front-end\",\"depth\":3,\"value\":\"Front-End\"},{\"slug\":\"back-end\",\"depth\":3,\"value\":\"Back-End\"},{\"slug\":\"open-source-vs-enterprise\",\"depth\":2,\"value\":\"Open Source vs Enterprise\"},{\"slug\":\"storage\",\"depth\":2,\"value\":\"Storage\"},{\"slug\":\"cloud\",\"depth\":2,\"value\":\"Cloud\"}]}},{\"key\":\"src/index.mdx\",\"value\":{\"name\":\"Introduction\",\"route\":\"/\",\"id\":\"6576455a124f9aaefd860597f03a8fe4\",\"filepath\":\"src/index.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/index.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-index\",\"menu\":\"\",\"headings\":[{\"slug\":\"introduction\",\"depth\":1,\"value\":\"Introduction\"},{\"slug\":\"the-name-kerberosio\",\"depth\":2,\"value\":\"The name: Kerberos.io\"},{\"slug\":\"why-kerberos\",\"depth\":2,\"value\":\"Why Kerberos\"},{\"slug\":\"what-is-kerberos\",\"depth\":2,\"value\":\"What is Kerberos\"},{\"slug\":\"kerberos-agent\",\"depth\":3,\"value\":\"Kerberos Agent\"}]}},{\"key\":\"src/cloud/index.mdx\",\"value\":{\"name\":\"Cloud\",\"route\":\"/cloud\",\"id\":\"082761d36d79f69c41234676c7b77e13\",\"filepath\":\"src/cloud/index.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/cloud/index.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-cloud-index\",\"menu\":\"\",\"headings\":[{\"slug\":\"cloud\",\"depth\":1,\"value\":\"Cloud\"},{\"slug\":\"architecture\",\"depth\":2,\"value\":\"Architecture\"},{\"slug\":\"public-or-private-edition\",\"depth\":3,\"value\":\"Public or Private edition\"},{\"slug\":\"features\",\"depth\":2,\"value\":\"Features\"},{\"slug\":\"secured-storage\",\"depth\":2,\"value\":\"Secured storage\"},{\"slug\":\"consolidated-overview\",\"depth\":2,\"value\":\"Consolidated overview\"},{\"slug\":\"security\",\"depth\":3,\"value\":\"Security\"},{\"slug\":\"advanced-searching\",\"depth\":2,\"value\":\"Advanced searching\"},{\"slug\":\"machine-learning\",\"depth\":2,\"value\":\"Machine learning\"},{\"slug\":\"alerts\",\"depth\":2,\"value\":\"Alerts\"},{\"slug\":\"notifications\",\"depth\":3,\"value\":\"Notifications\"},{\"slug\":\"channels\",\"depth\":3,\"value\":\"Channels\"},{\"slug\":\"live-streaming\",\"depth\":2,\"value\":\"Live streaming\"},{\"slug\":\"accounts\",\"depth\":2,\"value\":\"Accounts\"},{\"slug\":\"logging\",\"depth\":2,\"value\":\"Logging\"}]}},{\"key\":\"src/enterprise/get-started.mdx\",\"value\":{\"name\":\"Get Started\",\"menu\":\"Enterprise\",\"route\":\"/enterprise/get-started\",\"id\":\"190cf47f9b2f25ec9b7155086f299a78\",\"filepath\":\"src/enterprise/get-started.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/get-started.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-enterprise-get-started\",\"headings\":[{\"slug\":\"get-started\",\"depth\":1,\"value\":\"Get Started\"},{\"slug\":\"login-page\",\"depth\":2,\"value\":\"Login page\"},{\"slug\":\"overview\",\"depth\":2,\"value\":\"Overview\"},{\"slug\":\"kubernetes\",\"depth\":2,\"value\":\"Kubernetes\"},{\"slug\":\"nodes\",\"depth\":2,\"value\":\"Nodes\"},{\"slug\":\"deployments\",\"depth\":2,\"value\":\"Deployments\"},{\"slug\":\"adding-a-new-deployment\",\"depth\":3,\"value\":\"Adding a new deployment\"},{\"slug\":\"configuring-a-deployment\",\"depth\":3,\"value\":\"Configuring a deployment\"},{\"slug\":\"global-configuration\",\"depth\":3,\"value\":\"Global configuration\"},{\"slug\":\"upgrade-or-reboot-a-kerberos-enterprise-agent\",\"depth\":3,\"value\":\"Upgrade or reboot a Kerberos Enterprise agent\"},{\"slug\":\"pods\",\"depth\":2,\"value\":\"Pods\"},{\"slug\":\"storage-and-video-management\",\"depth\":2,\"value\":\"Storage and video management\"},{\"slug\":\"kerberos-storage\",\"depth\":3,\"value\":\"Kerberos Storage\"},{\"slug\":\"kerberos-cloud\",\"depth\":3,\"value\":\"Kerberos Cloud\"}]}},{\"key\":\"src/enterprise/index.mdx\",\"value\":{\"name\":\"First things first\",\"menu\":\"Enterprise\",\"route\":\"/enterprise/introduction\",\"id\":\"8f8fd9e742255635cf471c3030fa24ac\",\"filepath\":\"src/enterprise/index.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/index.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-enterprise-index\",\"headings\":[{\"slug\":\"enterprise\",\"depth\":1,\"value\":\"Enterprise\"},{\"slug\":\"kubernetes\",\"depth\":2,\"value\":\"Kubernetes\"},{\"slug\":\"cloud-or-on-premise\",\"depth\":2,\"value\":\"Cloud or on premise\"},{\"slug\":\"licensing\",\"depth\":2,\"value\":\"Licensing\"}]}},{\"key\":\"src/enterprise/installation-cloud.mdx\",\"value\":{\"name\":\"Installation - Cloud\",\"menu\":\"Enterprise\",\"route\":\"/enterprise/installation-cloud\",\"id\":\"b6c218189a84a0b60a84eaa5530cd5da\",\"filepath\":\"src/enterprise/installation-cloud.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/installation-cloud.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-enterprise-installation-cloud\",\"headings\":[{\"slug\":\"introduction\",\"depth\":1,\"value\":\"Introduction\"},{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"helm\",\"depth\":2,\"value\":\"Helm\"},{\"slug\":\"traefik\",\"depth\":2,\"value\":\"Traefik\"},{\"slug\":\"mongodb\",\"depth\":2,\"value\":\"MongoDB\"},{\"slug\":\"kerberos-enterprise-web-app---the-factory\",\"depth\":2,\"value\":\"Kerberos Enterprise Web App - The Factory\"},{\"slug\":\"test-out-configuration\",\"depth\":2,\"value\":\"Test out configuration\"},{\"slug\":\"access-the-system\",\"depth\":2,\"value\":\"Access the system\"}]}},{\"key\":\"src/enterprise/installation-edge.mdx\",\"value\":{\"name\":\"Installation - Edge\",\"menu\":\"Enterprise\",\"route\":\"/enterprise/installation-edge\",\"id\":\"5c7d9c582069b1049cdbdab5b688c546\",\"filepath\":\"src/enterprise/installation-edge.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/installation-edge.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-enterprise-installation-edge\",\"headings\":[{\"slug\":\"introduction\",\"depth\":1,\"value\":\"Introduction\"},{\"slug\":\"prerequisites\",\"depth\":1,\"value\":\"Prerequisites\"},{\"slug\":\"docker\",\"depth\":2,\"value\":\"Docker\"},{\"slug\":\"kubernetes\",\"depth\":2,\"value\":\"Kubernetes\"},{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"untaint-all-nodes\",\"depth\":2,\"value\":\"Untaint all nodes\"},{\"slug\":\"calico\",\"depth\":2,\"value\":\"Calico\"},{\"slug\":\"kerberos-enterprise\",\"depth\":2,\"value\":\"Kerberos Enterprise\"},{\"slug\":\"metallb\",\"depth\":2,\"value\":\"MetalLB\"},{\"slug\":\"helm\",\"depth\":2,\"value\":\"Helm\"},{\"slug\":\"traefik\",\"depth\":2,\"value\":\"Traefik\"},{\"slug\":\"mongodb\",\"depth\":2,\"value\":\"MongoDB\"},{\"slug\":\"kerberos-enterprise-web-app---the-factory\",\"depth\":2,\"value\":\"Kerberos Enterprise Web App - The Factory\"},{\"slug\":\"test-out-configuration\",\"depth\":2,\"value\":\"Test out configuration\"},{\"slug\":\"access-the-system\",\"depth\":2,\"value\":\"Access the system\"}]}},{\"key\":\"src/enterprise/installation.mdx\",\"value\":{\"name\":\"Installation\",\"menu\":\"Enterprise\",\"route\":\"/enterprise/installation\",\"id\":\"5cf033b11c0e22a8dad307af4f84a83b\",\"filepath\":\"src/enterprise/installation.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/installation.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-enterprise-installation\",\"headings\":[{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"installation-on-a-kubernetes-service-provider\",\"depth\":2,\"value\":\"Installation on a Kubernetes Service Provider\"},{\"slug\":\"installation-in-private-cloud-or-baremetal\",\"depth\":2,\"value\":\"Installation in Private Cloud or Baremetal\"}]}},{\"key\":\"src/enterprise/releases.mdx\",\"value\":{\"name\":\"Releases\",\"menu\":\"Enterprise\",\"route\":\"/enterprise/releases\",\"id\":\"d55649896dc1baed370ad4ea221aefb5\",\"filepath\":\"src/enterprise/releases.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/releases.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-enterprise-releases\",\"headings\":[{\"slug\":\"release-notes\",\"depth\":1,\"value\":\"Release notes\"},{\"slug\":\"100\",\"depth\":3,\"value\":\"1.0.0\"},{\"slug\":\"factory\",\"depth\":4,\"value\":\"Factory\"}]}},{\"key\":\"src/open-source/contribute.mdx\",\"value\":{\"name\":\"Contribute\",\"menu\":\"Open Source\",\"route\":\"/opensource/contribute\",\"id\":\"111290db815f0c1a551a7742fd821f6f\",\"filepath\":\"src/open-source/contribute.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/contribute.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-contribute\",\"headings\":[{\"slug\":\"contribute\",\"depth\":1,\"value\":\"Contribute\"},{\"slug\":\"machinery\",\"depth\":2,\"value\":\"Machinery\"},{\"slug\":\"prerequisites\",\"depth\":3,\"value\":\"Prerequisites\"},{\"slug\":\"installation\",\"depth\":3,\"value\":\"Installation\"},{\"slug\":\"testing\",\"depth\":3,\"value\":\"Testing\"},{\"slug\":\"adding-a-new-class\",\"depth\":3,\"value\":\"Adding a new class\"},{\"slug\":\"create-the-header-file\",\"depth\":4,\"value\":\"Create the header file\"},{\"slug\":\"create-the-source-file\",\"depth\":4,\"value\":\"Create the source file\"},{\"slug\":\"modify-the-cmakeliststxt-file\",\"depth\":4,\"value\":\"Modify the CMakeLists.txt file\"},{\"slug\":\"create-a-new-entry-in-the-config-file\",\"depth\":4,\"value\":\"Create a new entry in the config file\"},{\"slug\":\"compile\",\"depth\":3,\"value\":\"Compile\"},{\"slug\":\"web\",\"depth\":2,\"value\":\"Web\"},{\"slug\":\"prerequisites-1\",\"depth\":3,\"value\":\"Prerequisites\"},{\"slug\":\"installation-1\",\"depth\":3,\"value\":\"Installation\"}]}},{\"key\":\"src/open-source/get-started.mdx\",\"value\":{\"name\":\"Get Started\",\"menu\":\"Open Source\",\"route\":\"/opensource/get-started\",\"id\":\"059e06c8b1653a3b0c3473f90d782c13\",\"filepath\":\"src/open-source/get-started.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/get-started.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-get-started\",\"headings\":[{\"slug\":\"get-started\",\"depth\":1,\"value\":\"Get Started\"},{\"slug\":\"welcome-page\",\"depth\":2,\"value\":\"Welcome page\"},{\"slug\":\"login-page\",\"depth\":2,\"value\":\"Login page\"},{\"slug\":\"dashboard\",\"depth\":2,\"value\":\"Dashboard\"},{\"slug\":\"media\",\"depth\":2,\"value\":\"Media\"},{\"slug\":\"settings\",\"depth\":2,\"value\":\"Settings\"},{\"slug\":\"region-of-interest\",\"depth\":3,\"value\":\"Region of interest\"},{\"slug\":\"storage\",\"depth\":3,\"value\":\"Storage\"},{\"slug\":\"system\",\"depth\":2,\"value\":\"System\"}]}},{\"key\":\"src/open-source/index.mdx\",\"value\":{\"name\":\"First things first\",\"menu\":\"Open Source\",\"route\":\"/opensource/introduction\",\"id\":\"e182a675cff01d9e46eba94b9b98f68a\",\"filepath\":\"src/open-source/index.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/index.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-index\",\"headings\":[{\"slug\":\"first-things-first\",\"depth\":1,\"value\":\"First things first\"},{\"slug\":\"license\",\"depth\":2,\"value\":\"License\"},{\"slug\":\"when-using-the-open-source-version\",\"depth\":2,\"value\":\"When using the Open Source version\"},{\"slug\":\"how-to-install\",\"depth\":2,\"value\":\"How to install\"}]}},{\"key\":\"src/open-source/installation-advanced.mdx\",\"value\":{\"name\":\"Installation - advanced\",\"menu\":\"Open Source\",\"route\":\"/opensource/installation-advanced\",\"id\":\"34d4c112da87fe3146ef41fdbfc94ef2\",\"filepath\":\"src/open-source/installation-advanced.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/installation-advanced.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-installation-advanced\",\"headings\":[{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"plug-and-play\",\"depth\":3,\"value\":\"Plug and play\"},{\"slug\":\"advanced\",\"depth\":3,\"value\":\"Advanced\"},{\"slug\":\"advanced-1\",\"depth\":1,\"value\":\"Advanced\"},{\"slug\":\"raspbian\",\"depth\":2,\"value\":\"Raspbian\"},{\"slug\":\"update-os\",\"depth\":3,\"value\":\"Update OS\"},{\"slug\":\"machinery\",\"depth\":3,\"value\":\"Machinery\"},{\"slug\":\"web\",\"depth\":3,\"value\":\"Web\"},{\"slug\":\"auto-removal\",\"depth\":3,\"value\":\"Auto removal\"},{\"slug\":\"generic\",\"depth\":2,\"value\":\"Generic\"},{\"slug\":\"machinery-1\",\"depth\":3,\"value\":\"Machinery\"},{\"slug\":\"web-1\",\"depth\":3,\"value\":\"Web\"},{\"slug\":\"auto-removal-1\",\"depth\":3,\"value\":\"Auto removal\"}]}},{\"key\":\"src/open-source/installation.mdx\",\"value\":{\"name\":\"Installation\",\"menu\":\"Open Source\",\"route\":\"/opensource/installation\",\"id\":\"9e9908538be367cca76a80425244646f\",\"filepath\":\"src/open-source/installation.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/installation.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-installation\",\"headings\":[{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"plug-and-play\",\"depth\":3,\"value\":\"Plug and play\"},{\"slug\":\"advanced\",\"depth\":3,\"value\":\"Advanced\"},{\"slug\":\"plug-and-play-1\",\"depth\":1,\"value\":\"Plug and play\"},{\"slug\":\"kios\",\"depth\":2,\"value\":\"KiOS\"},{\"slug\":\"github\",\"depth\":3,\"value\":\"Github\"},{\"slug\":\"kerberos-open-source-installer\",\"depth\":3,\"value\":\"Kerberos Open Source installer\"},{\"slug\":\"etcher\",\"depth\":3,\"value\":\"Etcher\"},{\"slug\":\"connecting-to-wifi\",\"depth\":4,\"value\":\"Connecting to WiFi\"},{\"slug\":\"setup-a-static-ip-address\",\"depth\":4,\"value\":\"Setup a static IP-address\"},{\"slug\":\"power-on-the-raspberry-pi\",\"depth\":3,\"value\":\"Power on the Raspberry Pi\"},{\"slug\":\"access-the-raspberry-pi\",\"depth\":3,\"value\":\"Access the Raspberry Pi\"},{\"slug\":\"docker\",\"depth\":2,\"value\":\"Docker\"},{\"slug\":\"prerequisites\",\"depth\":3,\"value\":\"Prerequisites\"},{\"slug\":\"github-1\",\"depth\":3,\"value\":\"Github\"},{\"slug\":\"download-docker-image\",\"depth\":3,\"value\":\"Download docker image\"},{\"slug\":\"volumes\",\"depth\":3,\"value\":\"Volumes\"},{\"slug\":\"balena\",\"depth\":2,\"value\":\"Balena\"},{\"slug\":\"1-create-a-balena-account\",\"depth\":3,\"value\":\"1. Create a Balena account\"},{\"slug\":\"2-create-a-device-and-flash\",\"depth\":3,\"value\":\"2. Create a device and flash\"},{\"slug\":\"3-connect\",\"depth\":3,\"value\":\"3. Connect\"},{\"slug\":\"4-write\",\"depth\":3,\"value\":\"4. Write\"},{\"slug\":\"5-push\",\"depth\":3,\"value\":\"5. Push\"}]}},{\"key\":\"src/open-source/license.mdx\",\"value\":{\"name\":\"License\",\"menu\":\"Open Source\",\"route\":\"/opensource/license\",\"id\":\"b41faa434ffd47abb4b845cb083fff55\",\"filepath\":\"src/open-source/license.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/license.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-license\",\"headings\":[{\"slug\":\"cc-by-nc-sa-40\",\"depth\":1,\"value\":\"CC BY-NC-SA 4.0\"},{\"slug\":\"summary\",\"depth\":2,\"value\":\"Summary\"},{\"slug\":\"the-license\",\"depth\":2,\"value\":\"The license\"},{\"slug\":\"section-1--definitions\",\"depth\":3,\"value\":\"Section 1 – Definitions.\"},{\"slug\":\"section-2--scope\",\"depth\":3,\"value\":\"Section 2 – Scope.\"},{\"slug\":\"section-3--license-conditions\",\"depth\":3,\"value\":\"Section 3 – License Conditions.\"},{\"slug\":\"section-4--sui-generis-database-rights\",\"depth\":3,\"value\":\"Section 4 – Sui Generis Database Rights.\"},{\"slug\":\"section-5--disclaimer-of-warranties-and-limitation-of-liability\",\"depth\":3,\"value\":\"Section 5 – Disclaimer of Warranties and Limitation of Liability.\"},{\"slug\":\"section-6--term-and-termination\",\"depth\":3,\"value\":\"Section 6 – Term and Termination.\"},{\"slug\":\"section-7--other-terms-and-conditions\",\"depth\":3,\"value\":\"Section 7 – Other Terms and Conditions.\"},{\"slug\":\"section-8--interpretation\",\"depth\":3,\"value\":\"Section 8 – Interpretation.\"}]}},{\"key\":\"src/open-source/machinery.mdx\",\"value\":{\"name\":\"Machinery\",\"menu\":\"Open Source\",\"route\":\"/opensource/machinery\",\"id\":\"8b5e104d90b9ec673d88bf43d6bf99f2\",\"filepath\":\"src/open-source/machinery.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/machinery.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-machinery\",\"headings\":[{\"slug\":\"machinery\",\"depth\":1,\"value\":\"Machinery\"},{\"slug\":\"project-structure\",\"depth\":2,\"value\":\"Project structure\"},{\"slug\":\"capture\",\"depth\":2,\"value\":\"Capture\"},{\"slug\":\"usb-camera\",\"depth\":3,\"value\":\"USB camera\"},{\"slug\":\"parameters\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"framewidth-and--height\",\"depth\":5,\"value\":\"Framewidth and -height\"},{\"slug\":\"device-number\",\"depth\":5,\"value\":\"Device number\"},{\"slug\":\"delay\",\"depth\":5,\"value\":\"Delay\"},{\"slug\":\"angle\",\"depth\":5,\"value\":\"Angle\"},{\"slug\":\"raspberry-pi-camera-module\",\"depth\":3,\"value\":\"Raspberry Pi Camera Module\"},{\"slug\":\"parameters-1\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"framewidth-and--height-1\",\"depth\":5,\"value\":\"Framewidth and -height\"},{\"slug\":\"delay-1\",\"depth\":5,\"value\":\"Delay\"},{\"slug\":\"angle-1\",\"depth\":5,\"value\":\"Angle\"},{\"slug\":\"framerate\",\"depth\":5,\"value\":\"Framerate\"},{\"slug\":\"sharpness-saturation-contrast-brightness\",\"depth\":5,\"value\":\"Sharpness, saturation, contrast, brightness\"},{\"slug\":\"ip-camera\",\"depth\":3,\"value\":\"IP camera\"},{\"slug\":\"parameters-2\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"url\",\"depth\":5,\"value\":\"URL\"},{\"slug\":\"framewidth-and--height-2\",\"depth\":5,\"value\":\"Framewidth and -height\"},{\"slug\":\"delay-2\",\"depth\":5,\"value\":\"Delay\"},{\"slug\":\"angle-2\",\"depth\":5,\"value\":\"Angle\"},{\"slug\":\"condition\",\"depth\":2,\"value\":\"Condition\"},{\"slug\":\"enabled\",\"depth\":3,\"value\":\"Enabled\"},{\"slug\":\"parameters-3\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"active\",\"depth\":5,\"value\":\"Active\"},{\"slug\":\"delay-3\",\"depth\":5,\"value\":\"Delay\"},{\"slug\":\"time\",\"depth\":3,\"value\":\"Time\"},{\"slug\":\"parameters-4\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"times\",\"depth\":5,\"value\":\"Times\"},{\"slug\":\"delay-4\",\"depth\":5,\"value\":\"Delay\"},{\"slug\":\"algorithm\",\"depth\":2,\"value\":\"Algorithm\"},{\"slug\":\"differential-images\",\"depth\":3,\"value\":\"Differential images\"},{\"slug\":\"parameters-5\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"erode\",\"depth\":5,\"value\":\"Erode\"},{\"slug\":\"threshold\",\"depth\":5,\"value\":\"Threshold\"},{\"slug\":\"expositor\",\"depth\":2,\"value\":\"Expositor\"},{\"slug\":\"rectangle\",\"depth\":3,\"value\":\"Rectangle\"},{\"slug\":\"parameters-6\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"region\",\"depth\":5,\"value\":\"Region\"},{\"slug\":\"hull\",\"depth\":3,\"value\":\"Hull\"},{\"slug\":\"parameters-7\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"region-1\",\"depth\":5,\"value\":\"Region\"},{\"slug\":\"heuristic\",\"depth\":2,\"value\":\"Heuristic\"},{\"slug\":\"sequence\",\"depth\":3,\"value\":\"Sequence\"},{\"slug\":\"parameters-8\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"minimum-changes\",\"depth\":5,\"value\":\"Minimum changes\"},{\"slug\":\"minimum-durations\",\"depth\":5,\"value\":\"Minimum durations\"},{\"slug\":\"no-motion-delay-time\",\"depth\":5,\"value\":\"No motion delay time\"},{\"slug\":\"output\",\"depth\":2,\"value\":\"Output\"},{\"slug\":\"disk\",\"depth\":3,\"value\":\"Disk\"},{\"slug\":\"parameters-9\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"file-format\",\"depth\":5,\"value\":\"File format\"},{\"slug\":\"directory\",\"depth\":5,\"value\":\"Directory\"},{\"slug\":\"mark-with-timestamp\",\"depth\":5,\"value\":\"Mark with timestamp\"},{\"slug\":\"timestamp-color\",\"depth\":5,\"value\":\"Timestamp color\"},{\"slug\":\"privacy\",\"depth\":5,\"value\":\"Privacy\"},{\"slug\":\"throttler\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"video\",\"depth\":3,\"value\":\"Video\"},{\"slug\":\"parameters-10\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"fps\",\"depth\":5,\"value\":\"FPS\"},{\"slug\":\"record-after\",\"depth\":5,\"value\":\"Record after\"},{\"slug\":\"extensions\",\"depth\":5,\"value\":\"Extensions\"},{\"slug\":\"codec\",\"depth\":5,\"value\":\"Codec\"},{\"slug\":\"file-format-1\",\"depth\":5,\"value\":\"File format\"},{\"slug\":\"directory-1\",\"depth\":5,\"value\":\"Directory\"},{\"slug\":\"hardware-directory\",\"depth\":5,\"value\":\"Hardware directory\"},{\"slug\":\"enable-hardware-encoding\",\"depth\":5,\"value\":\"Enable Hardware encoding\"},{\"slug\":\"mark-with-timestamp-1\",\"depth\":5,\"value\":\"Mark with timestamp\"},{\"slug\":\"timestamp-color-1\",\"depth\":5,\"value\":\"Timestamp color\"},{\"slug\":\"privacy-1\",\"depth\":5,\"value\":\"Privacy\"},{\"slug\":\"video-privacy\",\"depth\":5,\"value\":\"Video privacy\"},{\"slug\":\"throttler-1\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"tcpip-client\",\"depth\":3,\"value\":\"TCP/IP client\"},{\"slug\":\"parameters-11\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"server\",\"depth\":5,\"value\":\"Server\"},{\"slug\":\"port\",\"depth\":5,\"value\":\"Port\"},{\"slug\":\"message\",\"depth\":5,\"value\":\"Message\"},{\"slug\":\"throttler-2\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"gpio\",\"depth\":3,\"value\":\"GPIO\"},{\"slug\":\"parameters-12\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"pin\",\"depth\":5,\"value\":\"Pin\"},{\"slug\":\"periods\",\"depth\":5,\"value\":\"Periods\"},{\"slug\":\"period-time\",\"depth\":5,\"value\":\"Period time\"},{\"slug\":\"throttler-3\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"webhook\",\"depth\":3,\"value\":\"Webhook\"},{\"slug\":\"parameters-13\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"url-1\",\"depth\":5,\"value\":\"Url\"},{\"slug\":\"throttler-4\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"output-1\",\"depth\":5,\"value\":\"Output\"},{\"slug\":\"script\",\"depth\":3,\"value\":\"Script\"},{\"slug\":\"parameters-14\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"path\",\"depth\":5,\"value\":\"Path\"},{\"slug\":\"throttler-5\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"example\",\"depth\":5,\"value\":\"Example\"},{\"slug\":\"mqtt\",\"depth\":3,\"value\":\"MQTT\"},{\"slug\":\"parameters-15\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"secure\",\"depth\":5,\"value\":\"Secure\"},{\"slug\":\"verifycn\",\"depth\":5,\"value\":\"Verifycn\"},{\"slug\":\"server-1\",\"depth\":5,\"value\":\"Server\"},{\"slug\":\"port-1\",\"depth\":5,\"value\":\"Port\"},{\"slug\":\"topic\",\"depth\":5,\"value\":\"Topic\"},{\"slug\":\"username\",\"depth\":5,\"value\":\"Username\"},{\"slug\":\"password\",\"depth\":5,\"value\":\"Password\"},{\"slug\":\"throttler-6\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"output-2\",\"depth\":5,\"value\":\"Output\"},{\"slug\":\"example-1\",\"depth\":5,\"value\":\"Example\"},{\"slug\":\"streaming\",\"depth\":2,\"value\":\"Streaming\"},{\"slug\":\"parameters-16\",\"depth\":3,\"value\":\"Parameters\"},{\"slug\":\"enabled-1\",\"depth\":4,\"value\":\"Enabled\"},{\"slug\":\"stream-port\",\"depth\":4,\"value\":\"Stream Port\"},{\"slug\":\"quality\",\"depth\":4,\"value\":\"Quality\"},{\"slug\":\"usernamepassword\",\"depth\":4,\"value\":\"Username/password\"}]}},{\"key\":\"src/open-source/releases.mdx\",\"value\":{\"name\":\"Releases\",\"menu\":\"Open Source\",\"route\":\"/opensource/releases\",\"id\":\"0513012dd89890d93de77c3aa4597e7f\",\"filepath\":\"src/open-source/releases.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/releases.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-releases\",\"headings\":[{\"slug\":\"release-notes\",\"depth\":1,\"value\":\"Release notes\"},{\"slug\":\"280\",\"depth\":3,\"value\":\"2.8.0\"},{\"slug\":\"web\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"kios\",\"depth\":4,\"value\":\"KiOS\"},{\"slug\":\"272\",\"depth\":3,\"value\":\"2.7.2\"},{\"slug\":\"machinery\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"271\",\"depth\":3,\"value\":\"2.7.1\"},{\"slug\":\"machinery-1\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"kios-1\",\"depth\":4,\"value\":\"KiOS\"},{\"slug\":\"270\",\"depth\":3,\"value\":\"2.7.0\"},{\"slug\":\"web-1\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-2\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"docker\",\"depth\":4,\"value\":\"Docker\"},{\"slug\":\"kios-2\",\"depth\":4,\"value\":\"KiOS\"},{\"slug\":\"261\",\"depth\":3,\"value\":\"2.6.1\"},{\"slug\":\"web-2\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-3\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"260\",\"depth\":3,\"value\":\"2.6.0\"},{\"slug\":\"web-3\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-4\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"docker-1\",\"depth\":4,\"value\":\"Docker\"},{\"slug\":\"250\",\"depth\":3,\"value\":\"2.5.0\"},{\"slug\":\"web-4\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-5\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"242\",\"depth\":3,\"value\":\"2.4.2\"},{\"slug\":\"web-5\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-6\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"241\",\"depth\":3,\"value\":\"2.4.1\"},{\"slug\":\"web-6\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"240\",\"depth\":3,\"value\":\"2.4.0\"},{\"slug\":\"ecosystem\",\"depth\":4,\"value\":\"Ecosystem\"},{\"slug\":\"web-7\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"docker-2\",\"depth\":4,\"value\":\"Docker\"},{\"slug\":\"machinery-7\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"231\",\"depth\":3,\"value\":\"2.3.1\"},{\"slug\":\"machinery-8\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"230\",\"depth\":3,\"value\":\"2.3.0\"},{\"slug\":\"ecosystem-1\",\"depth\":4,\"value\":\"Ecosystem\"},{\"slug\":\"221\",\"depth\":3,\"value\":\"2.2.1\"},{\"slug\":\"ecosystem-2\",\"depth\":4,\"value\":\"Ecosystem\"},{\"slug\":\"web-8\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-9\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"220\",\"depth\":3,\"value\":\"2.2.0\"},{\"slug\":\"ecosystem-3\",\"depth\":4,\"value\":\"Ecosystem\"},{\"slug\":\"web-9\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-10\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"210\",\"depth\":3,\"value\":\"2.1.0\"},{\"slug\":\"web-10\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-11\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"ecosystem-4\",\"depth\":4,\"value\":\"Ecosystem\"},{\"slug\":\"200\",\"depth\":3,\"value\":\"2.0.0\"},{\"slug\":\"web-11\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-12\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"docker-3\",\"depth\":4,\"value\":\"Docker\"},{\"slug\":\"ecosystem-5\",\"depth\":4,\"value\":\"Ecosystem\"},{\"slug\":\"110\",\"depth\":3,\"value\":\"1.1.0\"},{\"slug\":\"web-12\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-13\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"cloud\",\"depth\":4,\"value\":\"Cloud\"},{\"slug\":\"103\",\"depth\":3,\"value\":\"1.0.3\"},{\"slug\":\"web-13\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-14\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"cloud-1\",\"depth\":4,\"value\":\"Cloud\"},{\"slug\":\"102\",\"depth\":3,\"value\":\"1.0.2\"},{\"slug\":\"web-14\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-15\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"101\",\"depth\":3,\"value\":\"1.0.1\"},{\"slug\":\"web-15\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-16\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"100\",\"depth\":3,\"value\":\"1.0.0\"},{\"slug\":\"first-commit-of-kerberosio\",\"depth\":4,\"value\":\"First commit of Kerberos.io\"}]}},{\"key\":\"src/open-source/upgrade.mdx\",\"value\":{\"name\":\"Upgrade\",\"menu\":\"Open Source\",\"route\":\"/opensource/upgrade\",\"id\":\"bdff501afe4f3c7e6fc0f2ef0f365d5d\",\"filepath\":\"src/open-source/upgrade.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/upgrade.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-upgrade\",\"headings\":[{\"slug\":\"upgrade\",\"depth\":1,\"value\":\"Upgrade\"},{\"slug\":\"kios\",\"depth\":2,\"value\":\"KiOS\"},{\"slug\":\"raspbian\",\"depth\":2,\"value\":\"Raspbian\"},{\"slug\":\"docker\",\"depth\":2,\"value\":\"Docker\"}]}},{\"key\":\"src/open-source/web.mdx\",\"value\":{\"name\":\"Web\",\"menu\":\"Open Source\",\"route\":\"/opensource/web\",\"id\":\"302e6588cf7f47fc4110356883b1761b\",\"filepath\":\"src/open-source/web.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/web.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-web\",\"headings\":[{\"slug\":\"web-interface\",\"depth\":1,\"value\":\"Web interface\"},{\"slug\":\"overview\",\"depth\":2,\"value\":\"Overview\"},{\"slug\":\"dashboard\",\"depth\":3,\"value\":\"Dashboard\"},{\"slug\":\"overview-1\",\"depth\":3,\"value\":\"Overview\"},{\"slug\":\"settings\",\"depth\":3,\"value\":\"Settings\"},{\"slug\":\"system\",\"depth\":3,\"value\":\"System\"},{\"slug\":\"project-structure\",\"depth\":2,\"value\":\"Project structure\"},{\"slug\":\"back-end\",\"depth\":3,\"value\":\"Back-end\"},{\"slug\":\"front-end\",\"depth\":3,\"value\":\"Front-end\"},{\"slug\":\"api\",\"depth\":2,\"value\":\"API\"},{\"slug\":\"authentication\",\"depth\":3,\"value\":\"Authentication\"},{\"slug\":\"endpoints\",\"depth\":3,\"value\":\"Endpoints\"},{\"slug\":\"version-1\",\"depth\":3,\"value\":\"Version 1\"}]}},{\"key\":\"src/storage/get-started.mdx\",\"value\":{\"name\":\"Get Started\",\"menu\":\"Storage\",\"route\":\"/storage/get-started\",\"id\":\"c7e5dcab89cbb47494e742eaa025320d\",\"filepath\":\"src/storage/get-started.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/get-started.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-get-started\",\"headings\":[{\"slug\":\"get-started\",\"depth\":1,\"value\":\"Get Started\"},{\"slug\":\"login-page\",\"depth\":2,\"value\":\"Login page\"},{\"slug\":\"license-key\",\"depth\":2,\"value\":\"License key\"},{\"slug\":\"providers\",\"depth\":2,\"value\":\"Providers\"},{\"slug\":\"queues\",\"depth\":2,\"value\":\"Queues\"},{\"slug\":\"accounts\",\"depth\":2,\"value\":\"Accounts\"},{\"slug\":\"media\",\"depth\":2,\"value\":\"Media\"},{\"slug\":\"cleanup\",\"depth\":2,\"value\":\"Cleanup\"}]}},{\"key\":\"src/storage/index.mdx\",\"value\":{\"name\":\"First things first\",\"menu\":\"Storage\",\"route\":\"/storage/introduction\",\"id\":\"80b5f208a419fd50090370744bb3b5c3\",\"filepath\":\"src/storage/index.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/index.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-index\",\"headings\":[{\"slug\":\"storage\",\"depth\":1,\"value\":\"Storage\"},{\"slug\":\"kerberos-cloud\",\"depth\":2,\"value\":\"Kerberos Cloud\"},{\"slug\":\"kerberos-storage\",\"depth\":2,\"value\":\"Kerberos Storage\"},{\"slug\":\"events\",\"depth\":3,\"value\":\"Events\"},{\"slug\":\"on-demand-upload\",\"depth\":3,\"value\":\"On-Demand upload\"},{\"slug\":\"open-api\",\"depth\":3,\"value\":\"Open API\"},{\"slug\":\"licensing\",\"depth\":2,\"value\":\"Licensing\"}]}},{\"key\":\"src/storage/installation-cloud.mdx\",\"value\":{\"name\":\"Installation - Cloud\",\"menu\":\"Storage\",\"route\":\"/storage/installation-cloud\",\"id\":\"a8b1ddb7fa9459e5d6a4c2ad40a62f97\",\"filepath\":\"src/storage/installation-cloud.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation-cloud.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-installation-cloud\",\"headings\":[{\"slug\":\"introduction\",\"depth\":1,\"value\":\"Introduction\"},{\"slug\":\"prerequisites\",\"depth\":1,\"value\":\"Prerequisites\"},{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"storage\",\"depth\":2,\"value\":\"Storage\"},{\"slug\":\"test-out-configuration\",\"depth\":2,\"value\":\"Test out configuration\"},{\"slug\":\"access-the-system\",\"depth\":2,\"value\":\"Access the system\"}]}},{\"key\":\"src/storage/installation-edge.mdx\",\"value\":{\"name\":\"Installation - Edge\",\"menu\":\"Storage\",\"route\":\"/storage/installation-edge\",\"id\":\"da0491f238b15af2e27a09197c22b441\",\"filepath\":\"src/storage/installation-edge.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation-edge.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-installation-edge\",\"headings\":[{\"slug\":\"introduction\",\"depth\":1,\"value\":\"Introduction\"},{\"slug\":\"prerequisites\",\"depth\":1,\"value\":\"Prerequisites\"},{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"storage\",\"depth\":2,\"value\":\"Storage\"},{\"slug\":\"test-out-configuration\",\"depth\":2,\"value\":\"Test out configuration\"},{\"slug\":\"access-the-system\",\"depth\":2,\"value\":\"Access the system\"}]}},{\"key\":\"src/storage/installation-providers.md\",\"value\":{\"name\":\"Installation - Providers\",\"menu\":\"Storage\",\"route\":\"/storage/installation-providers\",\"id\":\"e0dd9967ab8238dfa46bc498578b96ba\",\"filepath\":\"src/storage/installation-providers.md\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation-providers.md\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-installation-providers\",\"headings\":[{\"slug\":\"kerberos-storage---providers\",\"depth\":1,\"value\":\"Kerberos Storage - Providers\"},{\"slug\":\"prerequisites\",\"depth\":2,\"value\":\"Prerequisites\"},{\"slug\":\"installation-minio\",\"depth\":2,\"value\":\"Installation Minio\"}]}},{\"key\":\"src/storage/installation-recycle.md\",\"value\":{\"name\":\"Installation - Recycle\",\"menu\":\"Storage\",\"route\":\"/storage/installation-recycle\",\"id\":\"087374e387724dd770db64dc4a3af2bf\",\"filepath\":\"src/storage/installation-recycle.md\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation-recycle.md\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-installation-recycle\",\"headings\":[{\"slug\":\"kerberos-storage---recycle-mechanism\",\"depth\":1,\"value\":\"Kerberos Storage - Recycle Mechanism\"},{\"slug\":\"prerequisites\",\"depth\":2,\"value\":\"Prerequisites\"},{\"slug\":\"installation\",\"depth\":2,\"value\":\"Installation\"}]}},{\"key\":\"src/storage/installation.mdx\",\"value\":{\"name\":\"Installation\",\"menu\":\"Storage\",\"route\":\"/storage/installation\",\"id\":\"50b670115b9f8cdaaa778cfa0baa4d1b\",\"filepath\":\"src/storage/installation.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-installation\",\"headings\":[{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"installation-on-a-kubernetes-service-provider\",\"depth\":2,\"value\":\"Installation on a Kubernetes Service Provider\"},{\"slug\":\"installation-in-private-cloud-or-baremetal\",\"depth\":2,\"value\":\"Installation in Private Cloud or Baremetal\"}]}},{\"key\":\"src/storage/license.mdx\",\"value\":{\"name\":\"License\",\"menu\":\"Storage\",\"route\":\"/storage/license\",\"id\":\"66157b559698ef176887277b64a78388\",\"filepath\":\"src/storage/license.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/license.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-license\",\"headings\":[{\"slug\":\"license-server\",\"depth\":1,\"value\":\"License server\"},{\"slug\":\"eula\",\"depth\":1,\"value\":\"EULA\"}]}}],\"props\":[{\"key\":\"src/components/Link.jsx\",\"value\":[{\"description\":\"\",\"displayName\":\"Link\",\"methods\":[],\"actualName\":\"Link\"}]},{\"key\":\"src/gatsby-theme-docz/components/Header/index.js\",\"value\":[{\"description\":\"\",\"displayName\":\"Header\",\"methods\":[],\"actualName\":\"Header\"}]},{\"key\":\"src/gatsby-theme-docz/components/Logo/index.js\",\"value\":[{\"description\":\"\",\"displayName\":\"Logo\",\"methods\":[],\"actualName\":\"Logo\"}]}]}"}}} \ No newline at end of file +{"data":{"doczDb":{"id":"ace00e2b-9c46-5e24-a19a-5ed242ca9c64","db":"{\"config\":{\"title\":\"Kerberos.io\",\"description\":\"My awesome app using docz\",\"menu\":[\"Introduction\",\"How it works\",\"Architectures\",{\"name\":\"Open Source\",\"menu\":[\"First things first\",\"Get Started\",\"Installation\",\"Installation - advanced\",\"Releases\",\"License\",\"Upgrade\",\"Contribute\",\"Machinery\",\"Web\"]},{\"name\":\"Enterprise\",\"menu\":[\"First things first\",\"Get Started\",\"Installation\",\"Installation - Cloud\",\"Installation - Edge\",\"Releases\"]},{\"name\":\"Storage\",\"menu\":[\"First things first\",\"Get Started\",\"Installation\",\"Installation - Cloud\",\"Installation - Edge\",\"Installation - Recycle\",\"Installation - Providers\",\"License\"]},\"Cloud\"],\"version\":\"2.0.0-rc.41\",\"repository\":\"https://github.com/kerberos-io\",\"native\":false,\"themeConfig\":{\"colors\":{\"primary\":\"#943733\",\"secondary\":\"#9e9e9e\",\"h5\":{\"color\":\"#943733\"},\"header\":{\"bg\":\"#943733\"},\"sidebar\":{\"bg\":\"#f9f9f9\",\"navLinkActive\":\"#943733\"},\"modes\":{\"dark\":{\"primary\":\"#9e9e9e\",\"secondary\":\"#943733\",\"header\":{\"bg\":\"#943733\"},\"sidebar\":{\"navLinkActive\":\"#fff\"}}}}},\"separator\":\"-\",\"gatsbyRemarkPlugins\":[{\"resolve\":\"gatsby-remark-vscode\"},{\"resolve\":\"gatsby-remark-grid-tables\"}]},\"entries\":[{\"key\":\"src/architectures.mdx\",\"value\":{\"name\":\"Architectures\",\"route\":\"/architectures\",\"id\":\"bb781d264051ead449d715317c32b263\",\"filepath\":\"src/architectures.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/architectures.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-architectures\",\"menu\":\"\",\"headings\":[{\"slug\":\"architectures\",\"depth\":1,\"value\":\"Architectures\"},{\"slug\":\"agents-on-premise\",\"depth\":2,\"value\":\"Agents on-premise\"},{\"slug\":\"kerberos-open-source--5-kerberos-agents\",\"depth\":3,\"value\":\"Kerberos Open Source (< 5 Kerberos agents)\"},{\"slug\":\"kerberos-enterprise--5-kerberos-agents\",\"depth\":3,\"value\":\"Kerberos Enterprise (> 5 Kerberos agents)\"},{\"slug\":\"agents-in-the-cloud\",\"depth\":2,\"value\":\"Agents in the cloud\"},{\"slug\":\"kerberos-open-source--5-kerberos-agents-1\",\"depth\":3,\"value\":\"Kerberos Open Source (< 5 Kerberos agents)\"},{\"slug\":\"kerberos-enterprise--5-kerberos-agents-1\",\"depth\":3,\"value\":\"Kerberos Enterprise (> 5 Kerberos agents)\"},{\"slug\":\"kerberos-cloud\",\"depth\":2,\"value\":\"Kerberos Cloud\"},{\"slug\":\"architecture\",\"depth\":3,\"value\":\"Architecture\"}]}},{\"key\":\"src/how.mdx\",\"value\":{\"name\":\"How it works\",\"route\":\"/how\",\"id\":\"456a1e92398967539c5497522b4455c5\",\"filepath\":\"src/how.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/how.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-how\",\"menu\":\"\",\"headings\":[{\"slug\":\"how-it-works\",\"depth\":1,\"value\":\"How it works\"},{\"slug\":\"front-end\",\"depth\":3,\"value\":\"Front-End\"},{\"slug\":\"back-end\",\"depth\":3,\"value\":\"Back-End\"},{\"slug\":\"open-source-vs-enterprise\",\"depth\":2,\"value\":\"Open Source vs Enterprise\"},{\"slug\":\"storage\",\"depth\":2,\"value\":\"Storage\"},{\"slug\":\"cloud\",\"depth\":2,\"value\":\"Cloud\"}]}},{\"key\":\"src/index.mdx\",\"value\":{\"name\":\"Introduction\",\"route\":\"/\",\"id\":\"6576455a124f9aaefd860597f03a8fe4\",\"filepath\":\"src/index.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/index.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-index\",\"menu\":\"\",\"headings\":[{\"slug\":\"introduction\",\"depth\":1,\"value\":\"Introduction\"},{\"slug\":\"the-name-kerberosio\",\"depth\":2,\"value\":\"The name: Kerberos.io\"},{\"slug\":\"why-kerberos\",\"depth\":2,\"value\":\"Why Kerberos\"},{\"slug\":\"what-is-kerberos\",\"depth\":2,\"value\":\"What is Kerberos\"},{\"slug\":\"kerberos-agent\",\"depth\":3,\"value\":\"Kerberos Agent\"}]}},{\"key\":\"src/cloud/index.mdx\",\"value\":{\"name\":\"Cloud\",\"route\":\"/cloud\",\"id\":\"082761d36d79f69c41234676c7b77e13\",\"filepath\":\"src/cloud/index.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/cloud/index.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-cloud-index\",\"menu\":\"\",\"headings\":[{\"slug\":\"cloud\",\"depth\":1,\"value\":\"Cloud\"},{\"slug\":\"architecture\",\"depth\":2,\"value\":\"Architecture\"},{\"slug\":\"public-or-private-edition\",\"depth\":3,\"value\":\"Public or Private edition\"},{\"slug\":\"features\",\"depth\":2,\"value\":\"Features\"},{\"slug\":\"secured-storage\",\"depth\":2,\"value\":\"Secured storage\"},{\"slug\":\"consolidated-overview\",\"depth\":2,\"value\":\"Consolidated overview\"},{\"slug\":\"security\",\"depth\":3,\"value\":\"Security\"},{\"slug\":\"advanced-searching\",\"depth\":2,\"value\":\"Advanced searching\"},{\"slug\":\"machine-learning\",\"depth\":2,\"value\":\"Machine learning\"},{\"slug\":\"alerts\",\"depth\":2,\"value\":\"Alerts\"},{\"slug\":\"notifications\",\"depth\":3,\"value\":\"Notifications\"},{\"slug\":\"channels\",\"depth\":3,\"value\":\"Channels\"},{\"slug\":\"live-streaming\",\"depth\":2,\"value\":\"Live streaming\"},{\"slug\":\"accounts\",\"depth\":2,\"value\":\"Accounts\"},{\"slug\":\"logging\",\"depth\":2,\"value\":\"Logging\"}]}},{\"key\":\"src/enterprise/get-started.mdx\",\"value\":{\"name\":\"Get Started\",\"menu\":\"Enterprise\",\"route\":\"/enterprise/get-started\",\"id\":\"190cf47f9b2f25ec9b7155086f299a78\",\"filepath\":\"src/enterprise/get-started.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/get-started.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-enterprise-get-started\",\"headings\":[{\"slug\":\"get-started\",\"depth\":1,\"value\":\"Get Started\"},{\"slug\":\"login-page\",\"depth\":2,\"value\":\"Login page\"},{\"slug\":\"overview\",\"depth\":2,\"value\":\"Overview\"},{\"slug\":\"kubernetes\",\"depth\":2,\"value\":\"Kubernetes\"},{\"slug\":\"nodes\",\"depth\":2,\"value\":\"Nodes\"},{\"slug\":\"deployments\",\"depth\":2,\"value\":\"Deployments\"},{\"slug\":\"adding-a-new-deployment\",\"depth\":3,\"value\":\"Adding a new deployment\"},{\"slug\":\"configuring-a-deployment\",\"depth\":3,\"value\":\"Configuring a deployment\"},{\"slug\":\"global-configuration\",\"depth\":3,\"value\":\"Global configuration\"},{\"slug\":\"upgrade-or-reboot-a-kerberos-enterprise-agent\",\"depth\":3,\"value\":\"Upgrade or reboot a Kerberos Enterprise agent\"},{\"slug\":\"pods\",\"depth\":2,\"value\":\"Pods\"},{\"slug\":\"storage-and-video-management\",\"depth\":2,\"value\":\"Storage and video management\"},{\"slug\":\"kerberos-storage\",\"depth\":3,\"value\":\"Kerberos Storage\"},{\"slug\":\"kerberos-cloud\",\"depth\":3,\"value\":\"Kerberos Cloud\"}]}},{\"key\":\"src/enterprise/index.mdx\",\"value\":{\"name\":\"First things first\",\"menu\":\"Enterprise\",\"route\":\"/enterprise/introduction\",\"id\":\"8f8fd9e742255635cf471c3030fa24ac\",\"filepath\":\"src/enterprise/index.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/index.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-enterprise-index\",\"headings\":[{\"slug\":\"enterprise\",\"depth\":1,\"value\":\"Enterprise\"},{\"slug\":\"kubernetes\",\"depth\":2,\"value\":\"Kubernetes\"},{\"slug\":\"cloud-or-on-premise\",\"depth\":2,\"value\":\"Cloud or on premise\"},{\"slug\":\"licensing\",\"depth\":2,\"value\":\"Licensing\"}]}},{\"key\":\"src/enterprise/installation-cloud.mdx\",\"value\":{\"name\":\"Installation - Cloud\",\"menu\":\"Enterprise\",\"route\":\"/enterprise/installation-cloud\",\"id\":\"b6c218189a84a0b60a84eaa5530cd5da\",\"filepath\":\"src/enterprise/installation-cloud.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/installation-cloud.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-enterprise-installation-cloud\",\"headings\":[{\"slug\":\"introduction\",\"depth\":1,\"value\":\"Introduction\"},{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"helm\",\"depth\":2,\"value\":\"Helm\"},{\"slug\":\"traefik\",\"depth\":2,\"value\":\"Traefik\"},{\"slug\":\"ingress-nginx-alternative-for-traefik\",\"depth\":2,\"value\":\"Ingress-Nginx (alternative for Traefik)\"},{\"slug\":\"mongodb\",\"depth\":2,\"value\":\"MongoDB\"},{\"slug\":\"kerberos-enterprise-web-app---the-factory\",\"depth\":2,\"value\":\"Kerberos Enterprise Web App - The Factory\"},{\"slug\":\"test-out-configuration\",\"depth\":2,\"value\":\"Test out configuration\"},{\"slug\":\"access-the-system\",\"depth\":2,\"value\":\"Access the system\"}]}},{\"key\":\"src/enterprise/installation-edge.mdx\",\"value\":{\"name\":\"Installation - Edge\",\"menu\":\"Enterprise\",\"route\":\"/enterprise/installation-edge\",\"id\":\"5c7d9c582069b1049cdbdab5b688c546\",\"filepath\":\"src/enterprise/installation-edge.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/installation-edge.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-enterprise-installation-edge\",\"headings\":[{\"slug\":\"introduction\",\"depth\":1,\"value\":\"Introduction\"},{\"slug\":\"prerequisites\",\"depth\":1,\"value\":\"Prerequisites\"},{\"slug\":\"docker\",\"depth\":2,\"value\":\"Docker\"},{\"slug\":\"kubernetes\",\"depth\":2,\"value\":\"Kubernetes\"},{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"untaint-all-nodes\",\"depth\":2,\"value\":\"Untaint all nodes\"},{\"slug\":\"calico\",\"depth\":2,\"value\":\"Calico\"},{\"slug\":\"kerberos-enterprise\",\"depth\":2,\"value\":\"Kerberos Enterprise\"},{\"slug\":\"metallb\",\"depth\":2,\"value\":\"MetalLB\"},{\"slug\":\"helm\",\"depth\":2,\"value\":\"Helm\"},{\"slug\":\"traefik\",\"depth\":2,\"value\":\"Traefik\"},{\"slug\":\"mongodb\",\"depth\":2,\"value\":\"MongoDB\"},{\"slug\":\"kerberos-enterprise-web-app---the-factory\",\"depth\":2,\"value\":\"Kerberos Enterprise Web App - The Factory\"},{\"slug\":\"test-out-configuration\",\"depth\":2,\"value\":\"Test out configuration\"},{\"slug\":\"access-the-system\",\"depth\":2,\"value\":\"Access the system\"}]}},{\"key\":\"src/enterprise/installation.mdx\",\"value\":{\"name\":\"Installation\",\"menu\":\"Enterprise\",\"route\":\"/enterprise/installation\",\"id\":\"5cf033b11c0e22a8dad307af4f84a83b\",\"filepath\":\"src/enterprise/installation.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/installation.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-enterprise-installation\",\"headings\":[{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"installation-on-a-kubernetes-service-provider\",\"depth\":2,\"value\":\"Installation on a Kubernetes Service Provider\"},{\"slug\":\"installation-in-private-cloud-or-baremetal\",\"depth\":2,\"value\":\"Installation in Private Cloud or Baremetal\"}]}},{\"key\":\"src/enterprise/releases.mdx\",\"value\":{\"name\":\"Releases\",\"menu\":\"Enterprise\",\"route\":\"/enterprise/releases\",\"id\":\"d55649896dc1baed370ad4ea221aefb5\",\"filepath\":\"src/enterprise/releases.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/enterprise/releases.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-enterprise-releases\",\"headings\":[{\"slug\":\"release-notes\",\"depth\":1,\"value\":\"Release notes\"},{\"slug\":\"100\",\"depth\":3,\"value\":\"1.0.0\"},{\"slug\":\"factory\",\"depth\":4,\"value\":\"Factory\"}]}},{\"key\":\"src/open-source/contribute.mdx\",\"value\":{\"name\":\"Contribute\",\"menu\":\"Open Source\",\"route\":\"/opensource/contribute\",\"id\":\"111290db815f0c1a551a7742fd821f6f\",\"filepath\":\"src/open-source/contribute.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/contribute.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-contribute\",\"headings\":[{\"slug\":\"contribute\",\"depth\":1,\"value\":\"Contribute\"},{\"slug\":\"machinery\",\"depth\":2,\"value\":\"Machinery\"},{\"slug\":\"prerequisites\",\"depth\":3,\"value\":\"Prerequisites\"},{\"slug\":\"installation\",\"depth\":3,\"value\":\"Installation\"},{\"slug\":\"testing\",\"depth\":3,\"value\":\"Testing\"},{\"slug\":\"adding-a-new-class\",\"depth\":3,\"value\":\"Adding a new class\"},{\"slug\":\"create-the-header-file\",\"depth\":4,\"value\":\"Create the header file\"},{\"slug\":\"create-the-source-file\",\"depth\":4,\"value\":\"Create the source file\"},{\"slug\":\"modify-the-cmakeliststxt-file\",\"depth\":4,\"value\":\"Modify the CMakeLists.txt file\"},{\"slug\":\"create-a-new-entry-in-the-config-file\",\"depth\":4,\"value\":\"Create a new entry in the config file\"},{\"slug\":\"compile\",\"depth\":3,\"value\":\"Compile\"},{\"slug\":\"web\",\"depth\":2,\"value\":\"Web\"},{\"slug\":\"prerequisites-1\",\"depth\":3,\"value\":\"Prerequisites\"},{\"slug\":\"installation-1\",\"depth\":3,\"value\":\"Installation\"}]}},{\"key\":\"src/open-source/get-started.mdx\",\"value\":{\"name\":\"Get Started\",\"menu\":\"Open Source\",\"route\":\"/opensource/get-started\",\"id\":\"059e06c8b1653a3b0c3473f90d782c13\",\"filepath\":\"src/open-source/get-started.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/get-started.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-get-started\",\"headings\":[{\"slug\":\"get-started\",\"depth\":1,\"value\":\"Get Started\"},{\"slug\":\"welcome-page\",\"depth\":2,\"value\":\"Welcome page\"},{\"slug\":\"login-page\",\"depth\":2,\"value\":\"Login page\"},{\"slug\":\"dashboard\",\"depth\":2,\"value\":\"Dashboard\"},{\"slug\":\"media\",\"depth\":2,\"value\":\"Media\"},{\"slug\":\"settings\",\"depth\":2,\"value\":\"Settings\"},{\"slug\":\"region-of-interest\",\"depth\":3,\"value\":\"Region of interest\"},{\"slug\":\"storage\",\"depth\":3,\"value\":\"Storage\"},{\"slug\":\"system\",\"depth\":2,\"value\":\"System\"}]}},{\"key\":\"src/open-source/index.mdx\",\"value\":{\"name\":\"First things first\",\"menu\":\"Open Source\",\"route\":\"/opensource/introduction\",\"id\":\"e182a675cff01d9e46eba94b9b98f68a\",\"filepath\":\"src/open-source/index.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/index.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-index\",\"headings\":[{\"slug\":\"first-things-first\",\"depth\":1,\"value\":\"First things first\"},{\"slug\":\"license\",\"depth\":2,\"value\":\"License\"},{\"slug\":\"when-using-the-open-source-version\",\"depth\":2,\"value\":\"When using the Open Source version\"},{\"slug\":\"how-to-install\",\"depth\":2,\"value\":\"How to install\"}]}},{\"key\":\"src/open-source/installation-advanced.mdx\",\"value\":{\"name\":\"Installation - advanced\",\"menu\":\"Open Source\",\"route\":\"/opensource/installation-advanced\",\"id\":\"34d4c112da87fe3146ef41fdbfc94ef2\",\"filepath\":\"src/open-source/installation-advanced.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/installation-advanced.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-installation-advanced\",\"headings\":[{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"plug-and-play\",\"depth\":3,\"value\":\"Plug and play\"},{\"slug\":\"advanced\",\"depth\":3,\"value\":\"Advanced\"},{\"slug\":\"advanced-1\",\"depth\":1,\"value\":\"Advanced\"},{\"slug\":\"raspbian\",\"depth\":2,\"value\":\"Raspbian\"},{\"slug\":\"update-os\",\"depth\":3,\"value\":\"Update OS\"},{\"slug\":\"machinery\",\"depth\":3,\"value\":\"Machinery\"},{\"slug\":\"web\",\"depth\":3,\"value\":\"Web\"},{\"slug\":\"auto-removal\",\"depth\":3,\"value\":\"Auto removal\"},{\"slug\":\"generic\",\"depth\":2,\"value\":\"Generic\"},{\"slug\":\"machinery-1\",\"depth\":3,\"value\":\"Machinery\"},{\"slug\":\"web-1\",\"depth\":3,\"value\":\"Web\"},{\"slug\":\"auto-removal-1\",\"depth\":3,\"value\":\"Auto removal\"}]}},{\"key\":\"src/open-source/installation.mdx\",\"value\":{\"name\":\"Installation\",\"menu\":\"Open Source\",\"route\":\"/opensource/installation\",\"id\":\"9e9908538be367cca76a80425244646f\",\"filepath\":\"src/open-source/installation.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/installation.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-installation\",\"headings\":[{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"plug-and-play\",\"depth\":3,\"value\":\"Plug and play\"},{\"slug\":\"advanced\",\"depth\":3,\"value\":\"Advanced\"},{\"slug\":\"plug-and-play-1\",\"depth\":1,\"value\":\"Plug and play\"},{\"slug\":\"kios\",\"depth\":2,\"value\":\"KiOS\"},{\"slug\":\"github\",\"depth\":3,\"value\":\"Github\"},{\"slug\":\"kerberos-open-source-installer\",\"depth\":3,\"value\":\"Kerberos Open Source installer\"},{\"slug\":\"etcher\",\"depth\":3,\"value\":\"Etcher\"},{\"slug\":\"connecting-to-wifi\",\"depth\":4,\"value\":\"Connecting to WiFi\"},{\"slug\":\"setup-a-static-ip-address\",\"depth\":4,\"value\":\"Setup a static IP-address\"},{\"slug\":\"power-on-the-raspberry-pi\",\"depth\":3,\"value\":\"Power on the Raspberry Pi\"},{\"slug\":\"access-the-raspberry-pi\",\"depth\":3,\"value\":\"Access the Raspberry Pi\"},{\"slug\":\"docker\",\"depth\":2,\"value\":\"Docker\"},{\"slug\":\"prerequisites\",\"depth\":3,\"value\":\"Prerequisites\"},{\"slug\":\"github-1\",\"depth\":3,\"value\":\"Github\"},{\"slug\":\"download-docker-image\",\"depth\":3,\"value\":\"Download docker image\"},{\"slug\":\"volumes\",\"depth\":3,\"value\":\"Volumes\"},{\"slug\":\"balena\",\"depth\":2,\"value\":\"Balena\"},{\"slug\":\"1-create-a-balena-account\",\"depth\":3,\"value\":\"1. Create a Balena account\"},{\"slug\":\"2-create-a-device-and-flash\",\"depth\":3,\"value\":\"2. Create a device and flash\"},{\"slug\":\"3-connect\",\"depth\":3,\"value\":\"3. Connect\"},{\"slug\":\"4-write\",\"depth\":3,\"value\":\"4. Write\"},{\"slug\":\"5-push\",\"depth\":3,\"value\":\"5. Push\"}]}},{\"key\":\"src/open-source/license.mdx\",\"value\":{\"name\":\"License\",\"menu\":\"Open Source\",\"route\":\"/opensource/license\",\"id\":\"b41faa434ffd47abb4b845cb083fff55\",\"filepath\":\"src/open-source/license.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/license.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-license\",\"headings\":[{\"slug\":\"cc-by-nc-sa-40\",\"depth\":1,\"value\":\"CC BY-NC-SA 4.0\"},{\"slug\":\"summary\",\"depth\":2,\"value\":\"Summary\"},{\"slug\":\"the-license\",\"depth\":2,\"value\":\"The license\"},{\"slug\":\"section-1--definitions\",\"depth\":3,\"value\":\"Section 1 – Definitions.\"},{\"slug\":\"section-2--scope\",\"depth\":3,\"value\":\"Section 2 – Scope.\"},{\"slug\":\"section-3--license-conditions\",\"depth\":3,\"value\":\"Section 3 – License Conditions.\"},{\"slug\":\"section-4--sui-generis-database-rights\",\"depth\":3,\"value\":\"Section 4 – Sui Generis Database Rights.\"},{\"slug\":\"section-5--disclaimer-of-warranties-and-limitation-of-liability\",\"depth\":3,\"value\":\"Section 5 – Disclaimer of Warranties and Limitation of Liability.\"},{\"slug\":\"section-6--term-and-termination\",\"depth\":3,\"value\":\"Section 6 – Term and Termination.\"},{\"slug\":\"section-7--other-terms-and-conditions\",\"depth\":3,\"value\":\"Section 7 – Other Terms and Conditions.\"},{\"slug\":\"section-8--interpretation\",\"depth\":3,\"value\":\"Section 8 – Interpretation.\"}]}},{\"key\":\"src/open-source/machinery.mdx\",\"value\":{\"name\":\"Machinery\",\"menu\":\"Open Source\",\"route\":\"/opensource/machinery\",\"id\":\"8b5e104d90b9ec673d88bf43d6bf99f2\",\"filepath\":\"src/open-source/machinery.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/machinery.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-machinery\",\"headings\":[{\"slug\":\"machinery\",\"depth\":1,\"value\":\"Machinery\"},{\"slug\":\"project-structure\",\"depth\":2,\"value\":\"Project structure\"},{\"slug\":\"capture\",\"depth\":2,\"value\":\"Capture\"},{\"slug\":\"usb-camera\",\"depth\":3,\"value\":\"USB camera\"},{\"slug\":\"parameters\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"framewidth-and--height\",\"depth\":5,\"value\":\"Framewidth and -height\"},{\"slug\":\"device-number\",\"depth\":5,\"value\":\"Device number\"},{\"slug\":\"delay\",\"depth\":5,\"value\":\"Delay\"},{\"slug\":\"angle\",\"depth\":5,\"value\":\"Angle\"},{\"slug\":\"raspberry-pi-camera-module\",\"depth\":3,\"value\":\"Raspberry Pi Camera Module\"},{\"slug\":\"parameters-1\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"framewidth-and--height-1\",\"depth\":5,\"value\":\"Framewidth and -height\"},{\"slug\":\"delay-1\",\"depth\":5,\"value\":\"Delay\"},{\"slug\":\"angle-1\",\"depth\":5,\"value\":\"Angle\"},{\"slug\":\"framerate\",\"depth\":5,\"value\":\"Framerate\"},{\"slug\":\"sharpness-saturation-contrast-brightness\",\"depth\":5,\"value\":\"Sharpness, saturation, contrast, brightness\"},{\"slug\":\"ip-camera\",\"depth\":3,\"value\":\"IP camera\"},{\"slug\":\"parameters-2\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"url\",\"depth\":5,\"value\":\"URL\"},{\"slug\":\"framewidth-and--height-2\",\"depth\":5,\"value\":\"Framewidth and -height\"},{\"slug\":\"delay-2\",\"depth\":5,\"value\":\"Delay\"},{\"slug\":\"angle-2\",\"depth\":5,\"value\":\"Angle\"},{\"slug\":\"condition\",\"depth\":2,\"value\":\"Condition\"},{\"slug\":\"enabled\",\"depth\":3,\"value\":\"Enabled\"},{\"slug\":\"parameters-3\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"active\",\"depth\":5,\"value\":\"Active\"},{\"slug\":\"delay-3\",\"depth\":5,\"value\":\"Delay\"},{\"slug\":\"time\",\"depth\":3,\"value\":\"Time\"},{\"slug\":\"parameters-4\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"times\",\"depth\":5,\"value\":\"Times\"},{\"slug\":\"delay-4\",\"depth\":5,\"value\":\"Delay\"},{\"slug\":\"algorithm\",\"depth\":2,\"value\":\"Algorithm\"},{\"slug\":\"differential-images\",\"depth\":3,\"value\":\"Differential images\"},{\"slug\":\"parameters-5\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"erode\",\"depth\":5,\"value\":\"Erode\"},{\"slug\":\"threshold\",\"depth\":5,\"value\":\"Threshold\"},{\"slug\":\"expositor\",\"depth\":2,\"value\":\"Expositor\"},{\"slug\":\"rectangle\",\"depth\":3,\"value\":\"Rectangle\"},{\"slug\":\"parameters-6\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"region\",\"depth\":5,\"value\":\"Region\"},{\"slug\":\"hull\",\"depth\":3,\"value\":\"Hull\"},{\"slug\":\"parameters-7\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"region-1\",\"depth\":5,\"value\":\"Region\"},{\"slug\":\"heuristic\",\"depth\":2,\"value\":\"Heuristic\"},{\"slug\":\"sequence\",\"depth\":3,\"value\":\"Sequence\"},{\"slug\":\"parameters-8\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"minimum-changes\",\"depth\":5,\"value\":\"Minimum changes\"},{\"slug\":\"minimum-durations\",\"depth\":5,\"value\":\"Minimum durations\"},{\"slug\":\"no-motion-delay-time\",\"depth\":5,\"value\":\"No motion delay time\"},{\"slug\":\"output\",\"depth\":2,\"value\":\"Output\"},{\"slug\":\"disk\",\"depth\":3,\"value\":\"Disk\"},{\"slug\":\"parameters-9\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"file-format\",\"depth\":5,\"value\":\"File format\"},{\"slug\":\"directory\",\"depth\":5,\"value\":\"Directory\"},{\"slug\":\"mark-with-timestamp\",\"depth\":5,\"value\":\"Mark with timestamp\"},{\"slug\":\"timestamp-color\",\"depth\":5,\"value\":\"Timestamp color\"},{\"slug\":\"privacy\",\"depth\":5,\"value\":\"Privacy\"},{\"slug\":\"throttler\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"video\",\"depth\":3,\"value\":\"Video\"},{\"slug\":\"parameters-10\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"fps\",\"depth\":5,\"value\":\"FPS\"},{\"slug\":\"record-after\",\"depth\":5,\"value\":\"Record after\"},{\"slug\":\"extensions\",\"depth\":5,\"value\":\"Extensions\"},{\"slug\":\"codec\",\"depth\":5,\"value\":\"Codec\"},{\"slug\":\"file-format-1\",\"depth\":5,\"value\":\"File format\"},{\"slug\":\"directory-1\",\"depth\":5,\"value\":\"Directory\"},{\"slug\":\"hardware-directory\",\"depth\":5,\"value\":\"Hardware directory\"},{\"slug\":\"enable-hardware-encoding\",\"depth\":5,\"value\":\"Enable Hardware encoding\"},{\"slug\":\"mark-with-timestamp-1\",\"depth\":5,\"value\":\"Mark with timestamp\"},{\"slug\":\"timestamp-color-1\",\"depth\":5,\"value\":\"Timestamp color\"},{\"slug\":\"privacy-1\",\"depth\":5,\"value\":\"Privacy\"},{\"slug\":\"video-privacy\",\"depth\":5,\"value\":\"Video privacy\"},{\"slug\":\"throttler-1\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"tcpip-client\",\"depth\":3,\"value\":\"TCP/IP client\"},{\"slug\":\"parameters-11\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"server\",\"depth\":5,\"value\":\"Server\"},{\"slug\":\"port\",\"depth\":5,\"value\":\"Port\"},{\"slug\":\"message\",\"depth\":5,\"value\":\"Message\"},{\"slug\":\"throttler-2\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"gpio\",\"depth\":3,\"value\":\"GPIO\"},{\"slug\":\"parameters-12\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"pin\",\"depth\":5,\"value\":\"Pin\"},{\"slug\":\"periods\",\"depth\":5,\"value\":\"Periods\"},{\"slug\":\"period-time\",\"depth\":5,\"value\":\"Period time\"},{\"slug\":\"throttler-3\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"webhook\",\"depth\":3,\"value\":\"Webhook\"},{\"slug\":\"parameters-13\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"url-1\",\"depth\":5,\"value\":\"Url\"},{\"slug\":\"throttler-4\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"output-1\",\"depth\":5,\"value\":\"Output\"},{\"slug\":\"script\",\"depth\":3,\"value\":\"Script\"},{\"slug\":\"parameters-14\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"path\",\"depth\":5,\"value\":\"Path\"},{\"slug\":\"throttler-5\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"example\",\"depth\":5,\"value\":\"Example\"},{\"slug\":\"mqtt\",\"depth\":3,\"value\":\"MQTT\"},{\"slug\":\"parameters-15\",\"depth\":4,\"value\":\"Parameters\"},{\"slug\":\"secure\",\"depth\":5,\"value\":\"Secure\"},{\"slug\":\"verifycn\",\"depth\":5,\"value\":\"Verifycn\"},{\"slug\":\"server-1\",\"depth\":5,\"value\":\"Server\"},{\"slug\":\"port-1\",\"depth\":5,\"value\":\"Port\"},{\"slug\":\"topic\",\"depth\":5,\"value\":\"Topic\"},{\"slug\":\"username\",\"depth\":5,\"value\":\"Username\"},{\"slug\":\"password\",\"depth\":5,\"value\":\"Password\"},{\"slug\":\"throttler-6\",\"depth\":5,\"value\":\"Throttler\"},{\"slug\":\"output-2\",\"depth\":5,\"value\":\"Output\"},{\"slug\":\"example-1\",\"depth\":5,\"value\":\"Example\"},{\"slug\":\"streaming\",\"depth\":2,\"value\":\"Streaming\"},{\"slug\":\"parameters-16\",\"depth\":3,\"value\":\"Parameters\"},{\"slug\":\"enabled-1\",\"depth\":4,\"value\":\"Enabled\"},{\"slug\":\"stream-port\",\"depth\":4,\"value\":\"Stream Port\"},{\"slug\":\"quality\",\"depth\":4,\"value\":\"Quality\"},{\"slug\":\"usernamepassword\",\"depth\":4,\"value\":\"Username/password\"}]}},{\"key\":\"src/open-source/releases.mdx\",\"value\":{\"name\":\"Releases\",\"menu\":\"Open Source\",\"route\":\"/opensource/releases\",\"id\":\"0513012dd89890d93de77c3aa4597e7f\",\"filepath\":\"src/open-source/releases.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/releases.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-releases\",\"headings\":[{\"slug\":\"release-notes\",\"depth\":1,\"value\":\"Release notes\"},{\"slug\":\"280\",\"depth\":3,\"value\":\"2.8.0\"},{\"slug\":\"web\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"kios\",\"depth\":4,\"value\":\"KiOS\"},{\"slug\":\"272\",\"depth\":3,\"value\":\"2.7.2\"},{\"slug\":\"machinery\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"271\",\"depth\":3,\"value\":\"2.7.1\"},{\"slug\":\"machinery-1\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"kios-1\",\"depth\":4,\"value\":\"KiOS\"},{\"slug\":\"270\",\"depth\":3,\"value\":\"2.7.0\"},{\"slug\":\"web-1\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-2\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"docker\",\"depth\":4,\"value\":\"Docker\"},{\"slug\":\"kios-2\",\"depth\":4,\"value\":\"KiOS\"},{\"slug\":\"261\",\"depth\":3,\"value\":\"2.6.1\"},{\"slug\":\"web-2\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-3\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"260\",\"depth\":3,\"value\":\"2.6.0\"},{\"slug\":\"web-3\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-4\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"docker-1\",\"depth\":4,\"value\":\"Docker\"},{\"slug\":\"250\",\"depth\":3,\"value\":\"2.5.0\"},{\"slug\":\"web-4\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-5\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"242\",\"depth\":3,\"value\":\"2.4.2\"},{\"slug\":\"web-5\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-6\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"241\",\"depth\":3,\"value\":\"2.4.1\"},{\"slug\":\"web-6\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"240\",\"depth\":3,\"value\":\"2.4.0\"},{\"slug\":\"ecosystem\",\"depth\":4,\"value\":\"Ecosystem\"},{\"slug\":\"web-7\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"docker-2\",\"depth\":4,\"value\":\"Docker\"},{\"slug\":\"machinery-7\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"231\",\"depth\":3,\"value\":\"2.3.1\"},{\"slug\":\"machinery-8\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"230\",\"depth\":3,\"value\":\"2.3.0\"},{\"slug\":\"ecosystem-1\",\"depth\":4,\"value\":\"Ecosystem\"},{\"slug\":\"221\",\"depth\":3,\"value\":\"2.2.1\"},{\"slug\":\"ecosystem-2\",\"depth\":4,\"value\":\"Ecosystem\"},{\"slug\":\"web-8\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-9\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"220\",\"depth\":3,\"value\":\"2.2.0\"},{\"slug\":\"ecosystem-3\",\"depth\":4,\"value\":\"Ecosystem\"},{\"slug\":\"web-9\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-10\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"210\",\"depth\":3,\"value\":\"2.1.0\"},{\"slug\":\"web-10\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-11\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"ecosystem-4\",\"depth\":4,\"value\":\"Ecosystem\"},{\"slug\":\"200\",\"depth\":3,\"value\":\"2.0.0\"},{\"slug\":\"web-11\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-12\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"docker-3\",\"depth\":4,\"value\":\"Docker\"},{\"slug\":\"ecosystem-5\",\"depth\":4,\"value\":\"Ecosystem\"},{\"slug\":\"110\",\"depth\":3,\"value\":\"1.1.0\"},{\"slug\":\"web-12\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-13\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"cloud\",\"depth\":4,\"value\":\"Cloud\"},{\"slug\":\"103\",\"depth\":3,\"value\":\"1.0.3\"},{\"slug\":\"web-13\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-14\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"cloud-1\",\"depth\":4,\"value\":\"Cloud\"},{\"slug\":\"102\",\"depth\":3,\"value\":\"1.0.2\"},{\"slug\":\"web-14\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-15\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"101\",\"depth\":3,\"value\":\"1.0.1\"},{\"slug\":\"web-15\",\"depth\":4,\"value\":\"Web\"},{\"slug\":\"machinery-16\",\"depth\":4,\"value\":\"Machinery\"},{\"slug\":\"100\",\"depth\":3,\"value\":\"1.0.0\"},{\"slug\":\"first-commit-of-kerberosio\",\"depth\":4,\"value\":\"First commit of Kerberos.io\"}]}},{\"key\":\"src/open-source/upgrade.mdx\",\"value\":{\"name\":\"Upgrade\",\"menu\":\"Open Source\",\"route\":\"/opensource/upgrade\",\"id\":\"bdff501afe4f3c7e6fc0f2ef0f365d5d\",\"filepath\":\"src/open-source/upgrade.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/upgrade.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-upgrade\",\"headings\":[{\"slug\":\"upgrade\",\"depth\":1,\"value\":\"Upgrade\"},{\"slug\":\"kios\",\"depth\":2,\"value\":\"KiOS\"},{\"slug\":\"raspbian\",\"depth\":2,\"value\":\"Raspbian\"},{\"slug\":\"docker\",\"depth\":2,\"value\":\"Docker\"}]}},{\"key\":\"src/open-source/web.mdx\",\"value\":{\"name\":\"Web\",\"menu\":\"Open Source\",\"route\":\"/opensource/web\",\"id\":\"302e6588cf7f47fc4110356883b1761b\",\"filepath\":\"src/open-source/web.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/open-source/web.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-open-source-web\",\"headings\":[{\"slug\":\"web-interface\",\"depth\":1,\"value\":\"Web interface\"},{\"slug\":\"overview\",\"depth\":2,\"value\":\"Overview\"},{\"slug\":\"dashboard\",\"depth\":3,\"value\":\"Dashboard\"},{\"slug\":\"overview-1\",\"depth\":3,\"value\":\"Overview\"},{\"slug\":\"settings\",\"depth\":3,\"value\":\"Settings\"},{\"slug\":\"system\",\"depth\":3,\"value\":\"System\"},{\"slug\":\"project-structure\",\"depth\":2,\"value\":\"Project structure\"},{\"slug\":\"back-end\",\"depth\":3,\"value\":\"Back-end\"},{\"slug\":\"front-end\",\"depth\":3,\"value\":\"Front-end\"},{\"slug\":\"api\",\"depth\":2,\"value\":\"API\"},{\"slug\":\"authentication\",\"depth\":3,\"value\":\"Authentication\"},{\"slug\":\"endpoints\",\"depth\":3,\"value\":\"Endpoints\"},{\"slug\":\"version-1\",\"depth\":3,\"value\":\"Version 1\"}]}},{\"key\":\"src/storage/get-started.mdx\",\"value\":{\"name\":\"Get Started\",\"menu\":\"Storage\",\"route\":\"/storage/get-started\",\"id\":\"c7e5dcab89cbb47494e742eaa025320d\",\"filepath\":\"src/storage/get-started.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/get-started.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-get-started\",\"headings\":[{\"slug\":\"get-started\",\"depth\":1,\"value\":\"Get Started\"},{\"slug\":\"login-page\",\"depth\":2,\"value\":\"Login page\"},{\"slug\":\"license-key\",\"depth\":2,\"value\":\"License key\"},{\"slug\":\"providers\",\"depth\":2,\"value\":\"Providers\"},{\"slug\":\"queues\",\"depth\":2,\"value\":\"Queues\"},{\"slug\":\"accounts\",\"depth\":2,\"value\":\"Accounts\"},{\"slug\":\"media\",\"depth\":2,\"value\":\"Media\"},{\"slug\":\"cleanup\",\"depth\":2,\"value\":\"Cleanup\"}]}},{\"key\":\"src/storage/index.mdx\",\"value\":{\"name\":\"First things first\",\"menu\":\"Storage\",\"route\":\"/storage/introduction\",\"id\":\"80b5f208a419fd50090370744bb3b5c3\",\"filepath\":\"src/storage/index.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/index.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-index\",\"headings\":[{\"slug\":\"storage\",\"depth\":1,\"value\":\"Storage\"},{\"slug\":\"kerberos-cloud\",\"depth\":3,\"value\":\"Kerberos Cloud\"},{\"slug\":\"kerberos-storage\",\"depth\":3,\"value\":\"Kerberos Storage\"},{\"slug\":\"kerberos-cloud-1\",\"depth\":2,\"value\":\"Kerberos Cloud\"},{\"slug\":\"kerberos-storage-1\",\"depth\":2,\"value\":\"Kerberos Storage\"},{\"slug\":\"events\",\"depth\":3,\"value\":\"Events\"},{\"slug\":\"on-demand-upload\",\"depth\":3,\"value\":\"On-Demand upload\"},{\"slug\":\"open-api\",\"depth\":3,\"value\":\"Open API\"},{\"slug\":\"licensing\",\"depth\":2,\"value\":\"Licensing\"}]}},{\"key\":\"src/storage/installation-cloud.mdx\",\"value\":{\"name\":\"Installation - Cloud\",\"menu\":\"Storage\",\"route\":\"/storage/installation-cloud\",\"id\":\"a8b1ddb7fa9459e5d6a4c2ad40a62f97\",\"filepath\":\"src/storage/installation-cloud.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation-cloud.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-installation-cloud\",\"headings\":[{\"slug\":\"introduction\",\"depth\":1,\"value\":\"Introduction\"},{\"slug\":\"prerequisites\",\"depth\":1,\"value\":\"Prerequisites\"},{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"storage\",\"depth\":2,\"value\":\"Storage\"},{\"slug\":\"test-out-configuration\",\"depth\":2,\"value\":\"Test out configuration\"},{\"slug\":\"access-the-system\",\"depth\":2,\"value\":\"Access the system\"}]}},{\"key\":\"src/storage/installation-edge.mdx\",\"value\":{\"name\":\"Installation - Edge\",\"menu\":\"Storage\",\"route\":\"/storage/installation-edge\",\"id\":\"da0491f238b15af2e27a09197c22b441\",\"filepath\":\"src/storage/installation-edge.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation-edge.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-installation-edge\",\"headings\":[{\"slug\":\"introduction\",\"depth\":1,\"value\":\"Introduction\"},{\"slug\":\"prerequisites\",\"depth\":1,\"value\":\"Prerequisites\"},{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"storage\",\"depth\":2,\"value\":\"Storage\"},{\"slug\":\"test-out-configuration\",\"depth\":2,\"value\":\"Test out configuration\"},{\"slug\":\"access-the-system\",\"depth\":2,\"value\":\"Access the system\"}]}},{\"key\":\"src/storage/installation-providers.md\",\"value\":{\"name\":\"Installation - Providers\",\"menu\":\"Storage\",\"route\":\"/storage/installation-providers\",\"id\":\"e0dd9967ab8238dfa46bc498578b96ba\",\"filepath\":\"src/storage/installation-providers.md\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation-providers.md\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-installation-providers\",\"headings\":[{\"slug\":\"kerberos-storage---providers\",\"depth\":1,\"value\":\"Kerberos Storage - Providers\"},{\"slug\":\"prerequisites\",\"depth\":2,\"value\":\"Prerequisites\"},{\"slug\":\"installation-minio\",\"depth\":2,\"value\":\"Installation Minio\"}]}},{\"key\":\"src/storage/installation-recycle.md\",\"value\":{\"name\":\"Installation - Recycle\",\"menu\":\"Storage\",\"route\":\"/storage/installation-recycle\",\"id\":\"087374e387724dd770db64dc4a3af2bf\",\"filepath\":\"src/storage/installation-recycle.md\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation-recycle.md\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-installation-recycle\",\"headings\":[{\"slug\":\"kerberos-storage---recycle-mechanism\",\"depth\":1,\"value\":\"Kerberos Storage - Recycle Mechanism\"},{\"slug\":\"prerequisites\",\"depth\":2,\"value\":\"Prerequisites\"},{\"slug\":\"installation\",\"depth\":2,\"value\":\"Installation\"}]}},{\"key\":\"src/storage/installation.mdx\",\"value\":{\"name\":\"Installation\",\"menu\":\"Storage\",\"route\":\"/storage/installation\",\"id\":\"50b670115b9f8cdaaa778cfa0baa4d1b\",\"filepath\":\"src/storage/installation.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/installation.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-installation\",\"headings\":[{\"slug\":\"installation\",\"depth\":1,\"value\":\"Installation\"},{\"slug\":\"installation-on-a-kubernetes-service-provider\",\"depth\":2,\"value\":\"Installation on a Kubernetes Service Provider\"},{\"slug\":\"installation-in-private-cloud-or-baremetal\",\"depth\":2,\"value\":\"Installation in Private Cloud or Baremetal\"}]}},{\"key\":\"src/storage/license.mdx\",\"value\":{\"name\":\"License\",\"menu\":\"Storage\",\"route\":\"/storage/license\",\"id\":\"66157b559698ef176887277b64a78388\",\"filepath\":\"src/storage/license.mdx\",\"fullpath\":\"/Users/i353408/Vagrant/www/repos/documentation/src/storage/license.mdx\",\"link\":\"\",\"hidden\":false,\"slug\":\"src-storage-license\",\"headings\":[{\"slug\":\"license-server\",\"depth\":1,\"value\":\"License server\"},{\"slug\":\"eula\",\"depth\":1,\"value\":\"EULA\"}]}}],\"props\":[{\"key\":\"src/components/Link.jsx\",\"value\":[{\"description\":\"\",\"displayName\":\"Link\",\"methods\":[],\"actualName\":\"Link\"}]},{\"key\":\"src/gatsby-theme-docz/components/Header/index.js\",\"value\":[{\"description\":\"\",\"displayName\":\"Header\",\"methods\":[],\"actualName\":\"Header\"}]},{\"key\":\"src/gatsby-theme-docz/components/Logo/index.js\",\"value\":[{\"description\":\"\",\"displayName\":\"Logo\",\"methods\":[],\"actualName\":\"Logo\"}]}]}"}}} \ No newline at end of file diff --git a/public/images/factory/kerberos-enterprise-to-cloud.gif b/public/images/factory/kerberos-enterprise-to-cloud.gif new file mode 100644 index 0000000..d1d3441 Binary files /dev/null and b/public/images/factory/kerberos-enterprise-to-cloud.gif differ diff --git a/src/enterprise/get-started.mdx b/src/enterprise/get-started.mdx index b019314..9c37174 100644 --- a/src/enterprise/get-started.mdx +++ b/src/enterprise/get-started.mdx @@ -129,6 +129,16 @@ On the other hand it's an open platform, as it allows you build extensions and i To connect one or more Kerberos Enterprise agents to your Kerberos Storage instance, you should open the configuration option and navigate to the `cloud` tab. Once selected you need to fill-in the credentials from your Kerberos Storage account. +- Storage URI: this is the API endpoint of your Kerberos Storage instance. Typically this is in the following format: `http(s)://api.yourdomain.com/storage`. Where `api.yourdomain.com` should match your Kerberos Storage API endpoint. + +- Provider: the name of the provider, which you created on the Kerberos Storage providers page, to which you want to send your recordings to. + +- Directory: this is the subdirectory in which your files will be stored. At the time of writing this should also equal your Kerberos Cloud username, if you plan to upload to Kerberos Cloud. + +- Access Key: this should match the access key of one of your Kerberos Storage accounts. + +- Secret Access Key: this should match the secret access key of one of your Kerberos Storage accounts. + ![kerberos storage configuration](../../public/images/factory/kerberos-enterprise-storage-setup.gif) @@ -139,3 +149,16 @@ For the visualisation part Kerberos Cloud comes into the picture. Kerberos Cloud You have two choices when using Kerberos Cloud, either you send your recordings from your Kerberos Enterprise agents directly to Kerberos Cloud, or you send your recordings to Kerberos Storage, and connect Kerberos Storage to Kerberos Cloud. About the latter more is explained on the [Kerberos Storage page](/storage/get-started). Select the Kerberos Cloud option, and copy-paste the credentials from your Kerberos Cloud subscription. + +![kerberos storage configuration](../../public/images/factory/kerberos-enterprise-to-cloud.gif) + + +- Region: this is the region where your recordings will be stored. Only `eu-west-1` for now (will change, on the roadmap). + +- Bucket: the name of the Kerberos Cloud bucket. Only `kerberosaccept` for now (will change, on the roadmap). + +- Directory: this is your personal directory, and matches your Kerberos Cloud username. + +- Public Key: this should match the public key of your Kerberos Cloud subscription. + +- Secret Access Key: this should match the private key of your Kerberos Cloud subscription. diff --git a/src/enterprise/index.mdx b/src/enterprise/index.mdx index d0f9971..1186586 100644 --- a/src/enterprise/index.mdx +++ b/src/enterprise/index.mdx @@ -10,7 +10,18 @@ Over the years Kerberos evolved into a mature and stable solution. Lots of peopl solution has its limitations, especially if you aim to scale it. That being said, Kerberos Open Source is perfect when monitoring a limited set of surveillance cameras, but it doesn't scale well if you plan to monitor dozens or hundreds of surveillance cameras. Although Kerberos Open Source ships -as a docker image, it has no high availability or fail over functionality. Due to these reasons we have developed Kerberos Enterprise, which is suitable for scaling against your ever growing video surveillance landscape, and keeps them up and running in whatever situation. +as a Docker image, it has no high availability or fail over functionality. + +Independent from that we've seen many vendors developing their own custom VMS solutions, usually tightly coupled to there proprietary surveillance hardware, which are delivered to enterprise customers as closed software solutions with limited API's and/or messaging capabilities. + +Due to these reasons we have developed Kerberos Enterprise, Kerberos Storage and Kerberos Cloud, which is an open scalable solution stack, suitable for your ever growing video surveillance landscape, but having extensibility and integration built-in from the ground up. + +The major key differentiators compared to to other solutions are: + + - Scalability with Kubernetes, + - Open API's with well documented Swagger API's, + - Host anywhere, in the cloud or on premise, + - Integration and extension, allowing to build custom apps, ML services and more.
@@ -22,7 +33,7 @@ To provide our customer with the high availability and fail over requirements th ![architecture kubernetes](../../public/images/kerberos-agent-architecture-kubernetes.png) -Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Bare metal machines). +Kerberos Enterprise is installed inside a Kubernetes cluster. It will create pods/deployments for every surveillance camera you want to monitor. Kubernetes will scale and distrubute these pods across your nodes (VM's/Baremetal machines). Nodes inside your cluster can fail or crash, Kubernetes will make sure the Kerberos pods running on the failed nodes will be deployed to healthy node. This, to make sure the monitoring of your video surveillance cameras continues seamlessly. diff --git a/src/enterprise/installation-cloud.mdx b/src/enterprise/installation-cloud.mdx index dd3ee5d..da0e410 100644 --- a/src/enterprise/installation-cloud.mdx +++ b/src/enterprise/installation-cloud.mdx @@ -78,6 +78,14 @@ After installation you should have an IP attached to traefik service, look for i Go to your DNS provider and link the domain you've configured in the first step `traefik.domain.com` to the IP address of the `EXTERNAL-IP` attribute. When browsing to `traefik.domain.com`, you should see the traefik dashboard showing up. +## Ingress-Nginx (alternative for Traefik) + +If you don't like `Traefik` but you prefer `Ingress Nginx`, that works as well. + + helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx + helm repo update + helm install ingress-nginx ingress-nginx/ingress-nginx + ## MongoDB When using Kerberos Enterprise, it will generate configurations for every surveillance camera deployed. These configuration files are stored centrally in a MongoDB database. Therefore we use `helm `to install a MongoDB instance inside your cluster. @@ -98,7 +106,7 @@ The last step is to install the Kerberos Enterprise application. Kerberos Enterp The Factory is shipped as a web app (React) which provides you with a tool to update your deployments (agents) easily, monitor them, etc. The Factory is the central portal for managing Kerberos Enterprise inside your cluster. However at any point you can fine-tune or take-over using the `kubectl` command. -Before installing the Factory web app, open the `./enterprise/yaml/factory/deployment.yaml` configuration file. At the bottom file you will find two endpoints, similar to the traefik config file. Update the domain names to your own domain, and add these to your DNS server (pointing to the same IP as the traefik EXTERNAL-IP). +Before installing the Factory web app, open the `./enterprise/yaml/factory/deployment.yaml` configuration file. At the of the bottom file you will find two endpoints, similar to the Ingres file bewlwo. Update the hostnames to your own perferred domain, and add these to your DNS server or `/etc/hosts` file (pointing to the same IP as the Traefik/Ingress nginx EXTERNAL-IP). spec: rules: @@ -117,6 +125,16 @@ Before installing the Factory web app, open the `./enterprise/yaml/factory/deplo serviceName: factory servicePort: 8081 +If you are using Ingress Nginx, do not forgot to comment `Traefik` and uncomment `Ingress Nginx`. + + apiVersion: extensions/v1beta1 + kind: Ingress + metadata: + name: factory + annotations: + #kubernetes.io/ingress.class: traefik + kubernetes.io/ingress.class: nginx + Modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance. - name: MONGODB_USERNAME diff --git a/src/enterprise/installation-edge.mdx b/src/enterprise/installation-edge.mdx index c68450f..b206c82 100644 --- a/src/enterprise/installation-edge.mdx +++ b/src/enterprise/installation-edge.mdx @@ -178,10 +178,10 @@ After modified properly you can go ahead with creating the PV. kubectl create -f ./enterprise/yaml/mongodb/volume.yaml -Have a look into the `yaml/mongodb/values.yaml` file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of mongodb. If using Helm version 2, write `--name mongodb`. +Have a look into the `./enterprise/yaml/mongodb/values.yaml` file, you will find plenty of configurations for your MongoDB instance. You will also find the attribute where you can change the root password of MongoDB. helm repo add bitnami https://charts.bitnami.com/bitnami - helm install mongodb bitnami/mongodb --values ./yaml/mongodb/values-edge.yaml + helm install mongodb bitnami/mongodb --values ./enterprise/yaml/mongodb/values-edge.yaml Once installed succesfully the MongoDB instance, we should copy the password of the MongoDB instance. Once revealed copy the password, as we will need in the next steps. diff --git a/src/storage/get-started.mdx b/src/storage/get-started.mdx index d8b285a..145f8bc 100644 --- a/src/storage/get-started.mdx +++ b/src/storage/get-started.mdx @@ -6,7 +6,7 @@ route: /storage/get-started # Get Started -Once you've installed Kerberos Storage, you will have the Storage web application. This web application allows you to administrate Kerberos Storage. You can add storage providers, queues, accounts, and more. +Once you've installed Kerberos Storage, you will have the Kerberos Storage web app running. This web app allows you to administrate Kerberos Storage. You can add storage providers, queues, accounts, and more. ## Login page diff --git a/src/storage/index.mdx b/src/storage/index.mdx index 8eab5ea..261e2e7 100644 --- a/src/storage/index.mdx +++ b/src/storage/index.mdx @@ -8,12 +8,19 @@ route: /storage/introduction Kerberos Open Source and Kerberos Enterprise both store recordings on the local disk. To centralise your data at a single place, additional solutions are available. -1. One or more Kerberos Enterprise agents, can store their data directly on [Kerberos Cloud](/cloud). -2. You have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage provider you want. This could be a storage provider in the cloud such as AWS S3, GCP storage or Azure Blob store. Next to that Kerberos Storage can also be installed on premise (at the edge), and use storage providers such as Minio. +### Kerberos Cloud + +One or more Kerberos Enterprise agents, can store their data directly on [Kerberos Cloud](/cloud), and benefit from the visualisation layer Kerberos Cloud offers. When doing this your recordings will be uploaded inside the Kerberos datacenter (which is a black box for you). + +### Kerberos Storage + +In addition to that you have the option to Bring Your Own Storage (BYOS), using Kerberos Storage. Kerberos Storage allows you to configure the storage providers you want, and allows you to connect to [Kerberos Cloud](/cloud) in parrallel. These storage provider could live in the cloud such as AWS S3, GCP storage and Azure Blob store, or can be located on premise - at the edge - such as Minio. + +Despite the flexible storage capabilities, Kerberos Storage is also an open platform, which can be used to build extensions (mobile apps, web apps, machine learning services, etc) and integrations. It allows you to leverage a scalable and stable system as a strong backbone for your video analytics solutions, machine learning algorithms, and more. ## Kerberos Cloud -Within Kerberos Open Source an Kerberos Enterprise you can choose to send your local recordings to our cloud environment. This means that your data will be hosted and processed (metadata, machine learning) in a Kerberos Cloud datacenter. For more information about how Kerberos Cloud works [can be found here](/cloud). +Within Kerberos Open Source an Kerberos Enterprise you can upload your recordings to our [Kerberos Cloud](/cloud) environment. This means that your data will be hosted and processed (metadata) in our Kerberos datacenter. For more information about how Kerberos Cloud works [can be found here](/cloud). ![cloud](../../public/images/kerberos-architecture.png) @@ -26,11 +33,11 @@ If you are using Kerberos Enterprise you have the possibility to bring your own - [Amazon Web Services S3](https://aws.amazon.com/s3/) - [Minio](https://min.io/) -Having installed Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud. +When installing Kerberos Storage in the cloud, following architecture can apply. Having your Kerberos Enterprise agents running at the edge, but uploading to Kerberos Storage in the cloud. ![architecture kubernetes](../../public/images/kerberos-storage-architecture-kubernetes-cloud.png) -On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing, Computer Vision or Machine Learning, at the edge. +On the other hand you could also have Kerberos Storage running at the edge, next to your Kubernetes Enterprise agents. This could be useful if you want to do processing or video analytics suchs as computer bision or machine learning at the edge. ![architecture kubernetes](../../public/images/kerberos-storage-architecture-kubernetes-edge.png) diff --git a/src/storage/installation-cloud.mdx b/src/storage/installation-cloud.mdx index d7fc0b1..d644a60 100644 --- a/src/storage/installation-cloud.mdx +++ b/src/storage/installation-cloud.mdx @@ -57,6 +57,17 @@ Before installing Kerberos Storage, open the `./storage/yaml/deployment.yaml` co serviceName: kerberos-storage servicePort: 8081 +If you are using Ingress Nginx, do not forgot to comment `Traefik` and uncomment `Ingress Nginx`. Also note the extra argument `proxy-body-size`, this is required for not reaching the default 1MB body size limit. If you do not enable this, you might experience `413` errors in your Kerberos Enterprise agents. + + apiVersion: extensions/v1beta1 + kind: Ingress + metadata: + name: kerberos-storage + annotations: + #kubernetes.io/ingress.class: traefik + kubernetes.io/ingress.class: nginx + nginx.ingress.kubernetes.io/proxy-body-size: 200m + Next to that modify the MongoDB credentials, and make sure they match the credentials of your MongoDB instance. - name: MONGODB_USERNAME